From AniDB
Revision as of 05:27, 1 July 2012 by Shitenshi (talk | contribs) (Updated version accordingly to the updated dl link.)
Jump to navigation Jump to search

Welcome to the remarkably sparse avdump2 wiki page, lovingly hand created over many minutes + some more.

We gleefully embrace build 5290, yet another public release of avd2. It represents a complete rewrite of the original avd1 code, runs against a new build of MediaInfoLibrary, contains a number of custom solutions for a number of formats, represents a significant investment of time and energy by Arokh, and is just generally nifty.

This release contains a minor collection of fixes from previous releases, and, barring discovery of world-ending bugs in the interim, will be the first version to be formally announced on the web site proper. As before, there is no need to reprocess existing files with this build, but do keep an eye out for misbehaviour.

What is it

Avdump2 is a video/audio codec identification utility - identifies which video codec and audio compression method is used on video files. Furthermore it hashes the file with a set of common hashalgorithms and calculates the used bit rates, the length, identifies the number of used audio channels and more.
It, like its predecessor, is mainly based on mediainfo, but significantly enhanced and changed to fit AniDB's needs by Arokh.

Supported formats

Most major file formats are supported to some degree. While hashes are created for all file types, stream details remain shakey for others (notably 'swf'). Because of that for some filetypes (underlined) only the hashes get auto-creqed.

  • Video files: asf/wmv, avi, flv, m2ts, mk3d, mkv, mov, mp4, mpg/mpeg, ogm, ogv, qt, rm/rmvb, swf, ts, webm
  • Subtitle files: ass, idx, js, lrc, mks, pjs, rt, smi, srt, ssa, sub, sup, tmp, tts, txt, xss
  • Audio files: aac, ac3, dts, dtshd, flac, m4a, mka, mp3, ogg, ra, thd, wav, wma
  • Archive files: 7z, ace, rar, zip
  • Linker files: mkv, smil


DOWNLOAD(RAR) (Build 5290) MD5 = 48c2489dd78272819c547e5cb94f71c7


Avdump2 is a simple command line client:

AVDump2CL.exe [--<Arg> -<OneLetterArg> ...] <media file/folder> [<media file/folder> ...]

While pre 4991 build arguments can still be used, it is recommended to use the new format shown below. The easiest way to convert them to the new format is to run the program with the old args which then displays a notice and the corresponding args in the new format.


Switch Type Description Default Example
Auth=<username>:<udp_api_key> Auto-Creqing Enable automatic creqing. You should always use this option when dumping anime files! Also enables error reporting. --Auth=tard:monkey
Host=<hostname>:<port> Auto-Creqing Hostname of AniDB UDP API server --Host=api.anidb.info:9002
LPort=<port> Auto-Creqing Local UDP port used for autocreqing. Only needed when behind "strict" firewalls. --LPort=12345
TOut=<timeoutInSeconds>:<numOfRetries> Auto-Creqing Timeout for sending dumps --TOut=10:3 --TOut=25:6
ACErr=<file path/name> Logging Write file paths of failed dumps to file. --ACErr=acerr.txt
CRCErr=<file path/name> Logging Checks if filename contains calculated crc --CRCErr=crcerr.txt
ExtDiff=<file path/name> Logging Write mismatched extensions and file paths to file. --ExtDiff=extdiff.txt
FixExt=<file path/name> Logging Changes the fileextension to the dectected extension and logs the action. --FixExt=fixext.txt
Done=<file path/name> Logging Skip paths present in log and append paths to newly processed files. --Done=done.txt
HLog=<file path/name> Logging Export hashes to file. --HLog="$CRC$ $ED2K$":hlog.txt
Log=<file path/name> Logging Write output to file. --Log=log.txt
M Output MediaInfo dump -M
m Output MediaInfo XML dump -m
t Output Simple text format -t
C Output XML creq format -C
c Output AVD2 creq dump -c
h Output Hash Dump -h
BSize=<KB_per_block>:<number_of_blocks> Control Buffer size for hashing. --BSize=512:16
Ext=<comma separated list> Control Comma separated extension list. Process all supported extensions --Ext=avi,mkv or --Ext=-zip,-sub or --Ext=*
Mon=<seconds> Control Monitor sleep duration in seconds. --Mon=60 --Mon=120
NoErr Control Disable error reporting. You should not disable this as it helps finding and fixing bugs. --NoErr
R Control Do not recurse into subfolders. -R
p Control Pause when done (hold cmd window). -p
P Control Pause after each file. -P
r Control Random file order. -r
q Control Suppress progress (silent). -q
B Control Test pure hashingspeed without io limitations -B
U Control Use UTF8 as console output stream -U
0 Hashing For CRC (because the CRC of a 0 byte file is 00000000). -0
1 Hashing For SHA1 (because of the 1). -1
2 Hashing For ED2K (because of the 2). -2
3 Hashing For Tiger (because a tiger in the house minimizes the Three Great Risks -- thieves, fire, and evil spirits). -3
4 Hashing For MD4 (because of the 4). -4
5 Hashing For MD5 (because of the 5). -5
6 Hashing For TTH ... because that's what's left :p -6
a Hashing All (available) hash algorithms. -a
Exp=<file path/name> AniDB Export ed2k-links to the specified file. Very useful when mass adding files. --Exp=ed2k.txt
PrintEd2kLink AniDB --PrintEd2kLink
PrintAniDBLink AniDB --PrintAniDBLink
OpenAniDBLink AniDB --OpenAniDBLink

Changes From Avdump Classic

  • AVD2 now runs on the managed .net platform. This will not affect most, as .net comes pre-installed with current versions of windows. XP or older may have to install the platform manually. While it has been tested on mono, such testing has not been exhaustive. We would be very interested in hearing how it behaves in such an environment.
  • While most command line parameters remain the same, there are some exceptions.
    • The "-o" parameter is no longer available in avd2.
    • The "-n" parameter is no longer available in avd2.
    • The meaning of the numeric parameters has changed.
  • In the event of an internal error, AVD2 will submit an error report back to AniDB. The error report contains no user-details (see sample), but is attached to the user name supplied with the -ac parameter. While error reports are only submitted if -ac is specified, they can be disabled by the addition of the -noerr parameter. That said, for the purposes of initial testing, we respectfully request that error reports not be disabled, so bugs can be found and fixed.

Sample Exception Report

  <OS>Microsoft Windows NT 6.1.7601 Service Pack 1</OS>
 <AVDump2CL.Exceptions.AVD2Exception thrownOn="20110303">
 <Message>Error in DisplayBuffer</Message>
   Non-negative number required.
   Parameter name: totalWidth
    at System.String.PadHelper(Int32 totalWidth, Char paddingChar, Boolean isRightPadded)
   <Frame>at l.a(f A_0, Progress A_1)</Frame>
   <Frame>at l.a(f A_0, Dictionary`2& A_1)</Frame>

Avdump2 on Linux

Thanks to Mono, Avdump2 runs natively on Linux as well. However, as most development effort goes into the Windows version and due to the heterogenity of Linux distributions, running Avdump2 on Linux isn’t as straightforward as running it on Windows. All Linux-related usage notes can be found on the Avdump2 on Linux page.


Simple diagram of the way auto-creqing with Avdump2 works

Avdump2 is the AniDB auto-creqing system. Some more or less important notes:

  • To be able to use this feature you’ll need an AniDB account and you have to define the UDP API Key in your profile. All data sent to the server will be logged with IP and uid.
  • It is possible to run more than one instance of Avdump2 at once, but not more than ten will work OK. At the moment only 10 sessions per ip are allowed by the server, meaning the eleventh instance will terminate the first.
  • There is no direct connection between data sent to AniDB and creqs generated. The data received will just be stored for later processing. There is no way to check the current status for a dump. Usually, it should take at least 24 hours from the moment you dump a file till the data actually changes. If any irregularities occur, or when there is too much data pending, it will take more time.
  • The creqs generated will report the user who sent the data first (for a specific file) as the creqer.
  • You may dump files currently not in the database. The data is still stored and will be used later if/after the file has been registered.
  • Files creqed by the new system will be locked, meaning some fields will not be possible to change. Notify a moderator if you are sure that some of the data locked for a specific file is wrong.

Why didn't this file get dumped?

  • The file in AniDB is registered with wrong size and/or ED2K hash.
  • The package never reached the server.
  • The decryption or decompression failed at server side (rare).
  • The dump is not valid XML (rare).

Why isn't this file verified?

Even if the file is dumped it doesn't mean it will get auto-creqed (and verified). Here are the reasons:

  • The file is corrupt/invalid (example).
  • The provided data is considered "incoherent". (Indicates a bug in Avdump.)
  • The dump was marked unfit for file verification by an AniDB Moderator.

Known issues

  • In some cases MediaInfoLib (MIL) used by Avdump2 might report an audio stream to have 0 or 3 channels.
  • Anamorphic .asf/.wmv and .mpg/.mpeg files might not get detected correctly and will report the PAR instead of the DAR.
  • Some corrupted mkv files may throw a (Thread Aborted) exception, this will be fixed once the updated version of the mkv parser is introduced


0.1.5290.0 : 2012.05.12

  • Fixed FileExtensionParser (hopefully)
  • TXT Report should be fixed now
  • Fixed ACReq Send Thread crash
  • AVD2 no longer pauses when not on Windows
  • Fixed AVD2 not working when not started from same folder as the executable
  • Added switch --UseCWD
  • Other changes I haven't remembered yet

0.1.5028.0 : 2011.09.11

  • Fixed shift of hashvalues (_Display_ only)
  • Fixed --Ext with "to remove" extensions
  • Fixed --Mon/--TOut to actually work
  • Fixed some bug in the old CLI converter
  • <no ponies>

0.1.5000.0 : 2011.09.11

  • all previous builds aside of 4991 have been disabled
  • <more ponies>

0.1.4964.0 : 2011.09.05

  • all previous builds have been disabled
  • Sending ACReqs asynchronous
  • <insert ponies riding down the rainbow and other stuff that has happened>

0.1.4334.0 : 2011.06.15

  • all previous builds have been disabled
  • should work under linux via mono now too

0.1.4260.0 : 2011.05.25

  • all previous builds have been disabled
  • fix for rare case where all xml submitted would contain an incorrect hash

0.1.4213.0 : 2011.05.14

  • all previous builds have been disabled
  • addition of support and detection of new video file type: .mk3d
  • addition of support and detection of new audio file type: .dtshd, .thd
  • addition of support and detection of new subtitle file type: .pjs, .rt, .tmp, .tts, .xss, new type of .sub files
  • addition of support and detection of new linker file type: .smil
  • addition of support and detection of .zip files starting with magic bytes "PK00PK"

0.1.3958.0 : 2011.03.15 - no need to redump everything

  • fixed the bug that caused avdump2 not to retry sending a dump when facing a timeout
  • video-only mp4 files got wrongly detected as m4v
  • automatic detection of 32/64bit and use of the correct mediainfolib
  • test if mediainfolib is accessible
  • check of mediainfolib version to prevent the usage of untested versions
  • updated to mediainfolib 0.7.42
  • added -crcerr parameter to log files where the calculated crc is not found in the filename
  • added -x parameter to create a "parameterless avdump1"-like output
  • new switch -H to test pure hashing speed
  • removed Tiger and MD4 checksums from dumps sent to the AniDB server

0.1.3084.0 : 2011.03.12

  • initial release