Avdump2: Difference between revisions

Jump to navigation Jump to search
3,653 bytes added ,  30 September 2019
no edit summary
No edit summary
(38 intermediate revisions by 8 users not shown)
Line 1: Line 1:
{{TOCright}}
{{eyecatch|Important|Avdump2 fully replaces [[Avdump]], which is now deprecated and should not be used.}}
{{eyecatch|Important|[[Avdump_GUI|Avdump GUI]] is a GUI version of Avdump2, for command line skeptics.}}
Welcome to the remarkably sparse avdump2 wiki page, lovingly hand created over many minutes + some more.
Welcome to the remarkably sparse avdump2 wiki page, lovingly hand created over many minutes + some more.


We gleefully embrace build 6248, 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.
We gleefully embrace build 7100, yet another public release of avd2. It runs against a new build of MediaInfoLibrary (18.12), 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.


There is no need to reprocess existing files with this build, but do keep an eye out for misbehaviour.
There is no general need to reprocess existing files with this build, but we don't mind if you do it anyway!


==What is it==
==What is it==
Line 19: Line 22:


===Download===
===Download===
 
  [http://static.anidb.net/client/avdump2/avdump2_7100.zip DOWNLOAD(ZIP)] (Build 7100) MD5 = a1539a6139315a3c0f24113bb2d2853b
  [http://static.anidb.net/client/avdump2/avdump2_6248.rar DOWNLOAD(RAR)] (Build 6248) MD5 = 4017b2835055d1c54abc12ae72703389


===Usage===
===Usage===
Line 37: Line 39:
! style="border: 1px solid #aaaaaa; background: #f2f2f2;" | Example
! style="border: 1px solid #aaaaaa; background: #f2f2f2;" | 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
|'''Auth'''=<username>:<udp_api_key>||Auto-Creqing||Sends file xml metadata dumps to the server for 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||
|'''Host'''=<hostname>:<port>||Auto-Creqing||Hostname of AniDB UDP API server||--Host=api.anidb.info:9002||
Line 79: Line 81:
|'''BSize'''=<KB_per_block>:<number_of_blocks>||Control||Buffer size for hashing.||||--BSize=512:16
|'''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=*
|'''Ext'''=<comma separated list>||Control||Comma separated extension list. Prepend with "-" to exclude. ||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
|'''Mon'''=<seconds>||Control||Monitor sleep duration in seconds.||--Mon=60||--Mon=120
Line 135: Line 137:
#Right-click the shortcut, add options to the ''Shortcut - Target'' line.
#Right-click the shortcut, add options to the ''Shortcut - Target'' line.
#:Example, normal usage: <tt>"C:\Program Files\AVDump2\AVDump2CL.exe" -p</tt>
#:Example, normal usage: <tt>"C:\Program Files\AVDump2\AVDump2CL.exe" -p</tt>
#:Example, auto-creq usage: <tt>"C:\Program Files\AVDump2\AVDump2CL.exe" --Auth:''myName'':''udp_api_key''</tt>
#:Example, auto-creq usage: <tt>"C:\Program Files\AVDump2\AVDump2CL.exe" --Auth=''myName'':''udp_api_key''</tt>
#::You can also set other options from the list above if you wish to do so.
#::You can also set other options from the list above if you wish to do so.
#::A commandline option to export ED2K links to a file is by adding <tt>--Exp=''C:\Path\ed2k.txt''</tt>, etc.
#::A commandline option to export ED2K links to a file is by adding <tt>--Exp=''C:\Path\ed2k.txt''</tt>, etc.
Line 157: Line 159:
#Create a MS-DOS batch file with the 2 lines below, and save it as ''filename.bat''.
#Create a MS-DOS batch file with the 2 lines below, and save it as ''filename.bat''.
#<tt>@ECHO OFF</tt>
#<tt>@ECHO OFF</tt>
#<tt>C:\Program Files\AVDump\AVDump2CL.exe %1 --Exp:''C:\Path\ed2k.txt'' --Auth:''myName'':''udp_api_key''</tt>
#<tt>C:\Program Files\AVDump\AVDump2CL.exe %* --Exp=''C:\Path\ed2k.txt'' --Auth=''myName'':''udp_api_key''</tt>
#Drag and drop any media-file onto the shortcut.
#Drag and drop any media-file onto the shortcut.


{{eyecatch|Note|'''The ''udp_api_key'' is not your user password!!! see [[Avdump#Auto-creqing|Auto-creqing]] .}}
{{eyecatch|Note|'''The ''udp_api_key'' is not your user password!!! see [[Avdump#Auto-creqing|Auto-creqing]] .}}
==Auto-creqing==
[[Image:Autocreq.gif|thumb|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.
* 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.
* 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.
* The creqs generated will report the user who sent the data first (for a specific file) as the creqer.
* It is possible to run more than one instance of Avdump2 at once, up to a maximum of ten. At the moment, ''only 10 sessions per ip are allowed by the server'', meaning the eleventh instance will terminate the first.
* 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 ([http://anidb.net/perl-bin/animedb.pl?show=avmf&do=xml&avid=76226 example]).
* The provided data is considered "incoherent". (Indicates a bug in Avdump.)
* The dump was marked unfit for file verification by an AniDB Moderator.
==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.


==Changes From Avdump Classic==
==Changes From Avdump Classic==
Line 198: Line 228:
  </FileExceptions>
  </FileExceptions>


===Avdump2 on Linux===
==Known issues==
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.
* 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
 
==Changelog==
<div style="height: 280px; overflow: auto; padding: 3px; border:1px solid #AAAAAA; font-size: small">
'''1.0.7100.0 : 2019.04.07'''
* Don't stop execution on big endian systems
* Warn when --ACreqErr is set but not --Auth
* Don't report DisplayBuffer, LC_ALL, ThreadCreation failed and console resize  exceptions
* Removed annoying error message when --Auth is not enabled
* Fixed MIL Versionstring
* MIL Chapter workaround
 
'''1.0.7080.0 : 2019.01.08'''
* Removed thrownOn Attribute from Exception reports
* Write ACreqErrors to Console
* Filter Exceptions which should be reported
* Donelog search is now case insensitive
* Fix for Matroskafiles when the tracks sections is at the end of the file
* Jaco Subtitle detection is now less trigger happy
 
'''1.0.7070.0 : 2019.01.02'''
* MIL Updated to Version 18.12
* Removed Client side MIL hash check
* Skip logging/acreqing for files with errors (except for matroska files with header data)
* EBML Parser (Matroska) crash fixed
* Matroska Container Parser Update
* Matroska Chapter Parsing
* Matroska Parser Crash fixed (Missing Track and other corner cases)
* Matroska: extra_size node added (Track overhead)
* 3d flag
* Added Mono Runtime Version to exception metadata
* Display "Hashing failed" instead of nothing if hashing fails for whatever reason
* Accept /? as parameter (same as --help)
* Included MAC MIL library for mostly untested mac support
* Added Dumpable extensions: trp
* Switch --Version also prints MIL Version
* Constrained TTH hash Thread to 4 instead of available corecount
* MIL Info shuffling for consistency
* Wait longer for MIL to return before hard crashing
* Fixed -m Crash
* MP4 Lag fixed / MIL Chapters bug workaround
* Switch --NoMediaInfoProvider (switch is ignored when acreqing)
* Don't eat cmd cursor on soft crash
* Log acreq failure when preconditions aren't met
* Added CodecFeatures node
* Various fileextension provider fixes
 
 
'''0.1.6714.0 : 2014.04.24'''
* Check for invalid usernames (to skip check prepend @)
* Less forgiving against corrupted files (i.e. older version may have creqed the files and this one doesn't)
* Ogg/Ogm fix for corrupted files
* Fixed matroska parser corner-case bug for large files


'''0.1.6647.0 : 2013.03.29'''
* Another attempt to fix OOM issues
* Now any byte array used to read files is reused (=> reduces mem usage jumpiness)
* Fixed non default blocksize/blockcount crashes
* Fixed stackoverflow crashes on some old mono versions (TraceSource)
* Added --Version argument (Prints the AVDump2 version)
* Fixed some spelling errors
* Added resynching for Matroska files (=> less exceptions for corrupted files)


==Auto-creqing==
'''0.1.6525.0 : 2012.11.??'''
[[Image:Autocreq.gif|thumb|Simple diagram of the way auto-creqing with Avdump2 works]]
* Reuse datablocks in an attempt to fix OOM issues on 32 bit linux (=> also more stable mem usage on all platforms)
* Changed Naming: Password to API Key to avoid confusion (Ommina)


Avdump2 is the AniDB [[auto-creqing]] system. Some more or less important notes:
'''0.1.6489.0 : 2012.10.??'''
* 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.
* Accept extensionless files when --Ext=* is used
* 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.
* Added disabled client exception
* 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.
* Fixed NullExcpetion bug (Invalid program hashes)
* 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?===
'''0.1.6452.0 : 2012.09.??+x+y+z'''
* The file in AniDB is registered with wrong size and/or ED2K hash.
* Added notice when the test acreq had an invalid format
* 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?===
'''0.1.6435.0 : 2012.09.??+x+y'''
Even if the file is dumped it doesn't mean it will get auto-creqed (and verified). Here are the reasons:
* Removed "log" extension from acreqable extensions
* The file is corrupt/invalid ([http://anidb.net/perl-bin/animedb.pl?show=avmf&do=xml&avid=76226 example]).
* Added Framework Node in error reports
* The provided data is considered "incoherent". (Indicates a bug in Avdump.)
* Added MIL filesize sanity check
* The dump was marked unfit for file verification by an AniDB Moderator.


'''0.1.6361.0 : 2012.09.??+x'''
* Changed BlockConsumer error message to state more clearly if the ACReq was sent or not
* UTF8 for Error messages


==Known issues==
'''0.1.6359.0 : 2012.09.??'''
* In some cases MediaInfoLib (MIL) used by Avdump2 might report an audio stream to have 0 or 3 channels.
* Moved to git repository
* Anamorphic .asf/.wmv and .mpg/.mpeg files might not get detected correctly and will report the PAR instead of the DAR.
* Changes lost in the ether
* Some corrupted mkv files may throw a (Thread Aborted) exception, this will be fixed once the updated version of the mkv parser is introduced
* [6248] Avdump2 may freeze if autocreqs are enabled and there are no creqs to send


==Changelog==
<div style="height: 280px; overflow: auto; padding: 3px; border:1px solid #AAAAAA; font-size: small">
'''0.1.6248.0 : 2012.08.28'''
'''0.1.6248.0 : 2012.08.28'''
* Shiny icon for the executable
* Shiny icon for the executable
Line 250: Line 335:
** Fixes errors which can happen when a binary file is parsed
** Fixes errors which can happen when a binary file is parsed


* Directory: Added workaround for "too long" filepaths
* <strike>Directory: Added workaround for "too long" filepaths</strike> <br/> FileAdding: On error, display the path of the causing file/directory


* MatroskaParser:
* MatroskaParser:

Navigation menu

MediaWiki spam blocked by CleanTalk.
MediaWiki spam blocked by CleanTalk.