https://wiki.anidb.net/wiki/api.php?action=feedcontributions&user=YukinoAi&feedformat=atomAniDB - User contributions [en]2024-03-28T15:55:39ZUser contributionsMediaWiki 1.40.0https://wiki.anidb.net/index.php?title=Tutorial:How_to_Add_Files_for_Dummies!/The_Prolix_Addendum&diff=22951Tutorial:How to Add Files for Dummies!/The Prolix Addendum2017-09-04T11:14:35Z<p>YukinoAi: fixed links</p>
<hr />
<div>[//anidb.net Anime DataBase (AniDB)] is a website that provides information about Anime.<br />
<br />
It keeps track of [//anidb.net/perl-bin/animedb.pl?show=anime&aid=109 show information] and fansub releases for them. It has some [//anidb.net/perl-bin/animedb.pl?show=forum social aspects] as well. [[AniDB:About|More info]]. Databases are only useful if they are updated frequently, so this tutorial is about keeping fansub releases on AniDB up to date.<br />
<br />
{{eyecatch|Note|This guide has a lot of theory to help explain how to interface with AniDB. For a more concise guide, please consider: [[Tutorial:How to Add Files for Dummies!]]}}<br />
<br />
==Introduction==<br />
<br />
AniDB needs to know 3 things to create a full entry for a release:<br />
<br />
# Which group (or user) released the file.<br />
# The unique hash of the file and file name.<br />
# The file metadata (resolution, audio tracks, subtitles, etc).<br />
<br />
The [[Avdump2]] utility can be used to automatically update AniDB file entries and will be used later.<br />
<br />
* The release group should be associated with each file when creating an entry for it. <br />
** Non-offical, or files that are not distributed, should not be added. <br />
** Release group examples: Horrible Subs, Kametsu, and Doki.<br />
* Before creating an entry for a file, the unique ed2k hash must first be calculated because the ed2k hash will be used in identifying the file.<br />
* The ed2k hash for the unique identifier can be generated by using [[Avdump2]], or any other program that can generate ed2k hashes.<br />
* The file's metadata should be updated using the Avdump2 tool.<br />
<br />
And so, it is convenient to use the Avdump2 tool to both generate the unique identifier and also update file metadata.<br />
<br />
'''Additional Resources:'''<br /><br />
[[Main_Page|wiki/Main_Page]]<br /><br />
[[Auto-creqing|wiki/Auto-creqing]]<br /><br />
[[Avdump2|wiki/Avdump2]]<br />
<br />
== Prerequisites ==<br />
<br />
# Obtain a file to add to AniDB.<br />
## The group name is usually present in the file name or description.<br />
# [//anidb.net/perl-bin/animedb.pl?show=signup Create an AniDB account].<br />
# [//anidb.net/perl-bin/animedb.pl?show=login Login] and verify that account.<br />
<br />
== Creating an API Key ==<br />
<br />
===Theory===<br />
<br />
At some point, meta-information for files should be submited using Avdump2. That meta-information is initially associated with the user account that made the submission. While users normally enter usernames/passwords for authentication, Avdump2 needs a unique string of characters to update meta-data. In this context, the string of characters that authenticates a user utilizing Avdump2 is known as an <code>API Key</code> or a <code>UDP API Key.</code><br />
<br />
UDP API keys can be specified in the user profile section on AniDB.net.<br />
<br />
===Procedure===<br />
<br />
[//anidb.net/perl-bin/animedb.pl?show=login Log in to AniDB]<br /><br />
On the left navigation pane, at the bottom is a section labeled <code>Account</code>. Click on <code>Settings</code>.<br />
<br />
[[File:anidb_account_settings_highlight.guide.png|i.imgur.com/fEqwtnZ.png]]<br />
<br />
Under profile, in the main navigation window, there are tabs. Click on the one that says <code>Account</code> (highlighted for emphasis). <br />
<br />
[[File:anidb_accountSettings_AccountTab_highlight.guide.png|i.imgur.com/maGR6jL.png]]<br />
<br />
There should be a section called <code>UDP API Key</code> with two fields, one with a label and another empty one.<br />
<br />
[[File:anidb_account_udpApiKey_empty.guide.png|i.imgur.com/j9B4eSr.png]]<br />
<br />
Any alphanumeric (a-z, A-Z, 0-9) character sequence no longer than 32 characters will work for the API key. For the purposes of this tutorial GRC's [//www.grc.com/passwords.htm Perfect Passwords] will be used.<br />
<br />
Open a new tab in the web browser and go to GRC's [//www.grc.com/passwords.htm Perfect Passwords] page.<br />
<br />
In the last box of characters labeled <code>a-z, A-Z, 0-9</code>, highlight 20-30 characters as shown below.<br />
<br />
[[File:grc_pp_20charas_highlight.guide.png|border|i.imgur.com/Z3D68ca.png|]]<br />
<br />
Then copy the selected characters to the clipboard.<br />
<br />
* Right-Click - Copy<br />
* <code>Ctrl + c</code><br />
<br />
[[File:grc_pp_20characters_copy.guide.png|border|i.imgur.com/3qlV9iu.png]]<br />
<br />
Change tabs back to AniDB's page.<br />
<br />
In the empty field under the <code>UDP API Key</code>, right-click and select <code>Paste</code>. Alternatively: <code>Ctrl + v</code>.<br /><br />
[[File:anidb_account_udpAPIKey_paste.guide.png|i.imgur.com/3V61Mo2.png]]<br />
<br />
[[File:anidb_account_udpAPIKey_inserted.guide.png|i.imgur.com/q5yZPHa.png]]<br />
<br />
Click on the <code>Apply</code> button at the bottom. It should be right above <code>Back</code>.<br /><br />
[[File:anidb_account_udpAPIKey_apply.guide.png|i.imgur.com/6761Qg3.png]]<br /><br />
The <code>UDP API Key</code> field should turn into asterisks (*) to show that it has saved it properly.<br /><br />
[[File:anidb_account_udpAPIKey_asterisks.guide.png|i.imgur.com/l9OzPgu.png]]<br /><br />
The API key should also be saved for use with Avdump2 later on, so lets save it to notepad.<br />
<br />
<code>Windows key</code> or Click on the start menu and type in <code>notepad</code>.<br />
<br />
[[File:windowskey_notepad.guide.png|i.imgur.com/SVi1A65.png|]]<br />
<br />
[[File:notepad_apiKey_paste.guide.png|i.imgur.com/juAtU1M.png]]<br />
<br />
Save the file as something descriptive or as <code>anidb_apiKey.txt</code> in your user profile folder (<code>C:\Users\User</code>) or desktop (<code>C:\Users\User\Desktop</code>).<br />
<br />
* <code>File</code> - <code>Save As...</code><br />
* <code>Ctrl + s</code><br />
<br />
Changes to the API key are updated immediately server-side but old entries are cached for an unspecified amount of time, usually less than 30 minutes. Attempting to use the new key before the old key has been removed from the cache will produce this error in the <code>Avdump2cl.exe</code>:<br />
<br />
[[File:Avdump2cl_apiKey_timeout.guide.png|i.imgur.com/SAZIZt8.png]]<br />
<br />
The Avdump2 GUI will simply not respond when authentication fails. More on this later.<br />
<br />
== Dealing With Groups ==<br />
<br />
===Theory===<br />
Every file entry should be associated with a release group. The group name or tag is usually in the file name, usually in brackets <code>[ ]</code>. It is important to identify the release group and to verify the group already exists in AniDB.<br />
<br />
Examples:<br />
<br />
{| class="wikitable"<br />
!width="15%"| Filename<br />
!width="5%"| Group Name or [Tag]<br />
|-<br />
| [Yuki] Log Horizon - 01 (BD 1080p HEVC Dual-Audio AAC) [2D099D6D].mkv<br />
| Yuki<br />
|-<br />
| Log Horizon - 01 (1080p) BD x265 10-bit (DualAudio) AC3 AAC [KoTuWa].mkv<br />
| KoTuWa<br />
|-<br />
| [ReinForce] Log Horizon - 01 (BDRip 1920x1080 x264 FLAC).mkv<br />
| ReinForce<br />
|-<br />
| [JacobSwaggedUp] Log Horizon - 01 (BD 1280x720).mp4<br />
| JacobSwaggedUp<br />
|-<br />
| Log.Horizon.S01E01.720p-Hi10p.BluRay.AAC2.0-CTR.[B73B6592].mkv<br />
| CTR<br />
|-<br />
| {AnimeServ.NET} Log Horizon 01 (Blu-ray)(1920x1080 x264 AAC).mp4<br />
| AnimeServ.Net<br />
|-<br />
| [RHxUHA-WING]Log_Horizon_S1[01][BIG5][720P].mp4<br />
| RHxUHA-WING<br />
|-<br />
| [BDMV][150724] Log Horizon - Vol.1<br />
| n/a<br />
|-<br />
| (Shin-Raw) Log Horizon 01 720p (HEVC-HEAAC) [7F99A1E7].mp4<br />
| Shin-Raw<br />
|}<br />
<br />
For Anime, most groups put their names in brackets <code>[ ]</code> but not always. Group names like DVDISO, RawDVD, BDMV, Anime BD, RAW, R2RAW are keywords that indicate a group is not associated with the upload, usually for uploading unmodified content.<br />
<br />
When there is a <code>-</code> or <code>&amp;</code> in the group name, that sometimes means it is a joint release between 2 or more groups. Joint releases are also known as &quot;virtual&quot; releases in AniDB terminology.<br />
<br />
In an example above, RHxUHA-WING may be a single group's name or it may be 2 different groups, RHxUHA and WING. Read the description in the download page to find out or search AniDB.<br />
<br />
Verify the group exists by searching for it on AniDB.<br />
<br />
===Procedure===<br />
<br />
Open [//anidb.net Anime DataBase (AniDB)].<br />
<br />
At the top right next to <code>Search</code> change the search type from <code>all</code> to <code>group</code>.<br />
<br />
[[File:anidb_search_group1.guide.png|i.imgur.com/4U31JYW.png]]<br />
<br />
Enter the group name found in the filename and click on <code>Search</code>. In the example below, <code>Doki</code> is used as an example of a group (highlighted for emphasis).<br />
<br />
[[File:anidb_search_group2.guide.png|i.imgur.com/XIR5058.png]]<br />
<br />
Click on the group name in the <code>Name</code> column. In the below example it would be <code>Doki Fansubs</code>.<br />
<br />
[[File:anidb_search_group3.guide.png|700px|i.imgur.com/aJudr9s.png]]<br />
<br />
Only if the group does not exist, [//anidb.net/perl-bin/animedb.pl?show=addgroup create it]. Before actually adding a group, read [[Content:Groups|this]] and [[Which_raw_groups_to_credit|this]].<br />
<br />
For the purposes of this tutorial, it will be assumed the group name already exists.<br />
<br />
== On Using Avdump2 ==<br />
<br />
===Theory===<br />
<br />
* A file entry in AniDB has 2 main components, the entry itself and the associated metadata.<br />
* AniDB stores metadata information for files that are not yet in the database. This means it is possible to add a file entry and then add the metadata, or alternatively, add the metadata to AniDB and create the file entry later.<br />
* The metadata and the file entry are normally linked using a unique identifier created from the [[Ed2k-hash]] and the filesize.<br />
<br />
Thus, to create a file entry in AniDB, the ed2k hash must be known and the group name should be known.<br />
<br />
The main purpose of the [[Avdump2]] utility, and its [[Avdump_GUI|GUI wrapper]], is to automate updating AniDB file entries. It does 3 things:<br />
<br />
# Hash files to identify them (ed2k).<br />
# Extract Audio/Video/Subtitle and other media information.<br />
# Send that information to the server.<br />
<br />
Together, the hash information and the media information are called a &quot;dump,&quot; short for metadata dump or file dump.<br />
<br />
This tutorial will cover creating files associated with a release on AniDB using their ed2k identifier also submitting dumps.<br />
<br />
===Installation===<br />
<br />
:{{Missing}}<br />
<br />
[[Avdump_GUI|Download the portable GUI version]], [//static.anidb.net/client/avdump-gui-2.3.2-portable.7z direct], (it has both the CLI and GUI) and [//www.7-zip.org/download.html extract it] to <code>C:\Users\User\Downloads</code>. See this random [http://www.gofree.com/Tutorials/ExtractingZipFiles.php 7-Zip Tutorial]. Alternative [//static.anidb.net/client/avdump-gui.msi MSI installer].<br />
<br />
For the purposes of this tutorial, it will be assumed the CLI tool is at:<br /><br />
<code>C:\Users\User\Downloads\avdump-gui-2.3.2-portable\appdata\avdump-gui-2.3.2.win32\Avdump2CL.exe</code><br /><br />
And the GUI tool is available at:<br /><br />
<code>C:\Users\User\Downloads\avdump-gui-2.3.2-portable\Avdump2gui.exe</code><br />
<br />
* <code>Avdump2CL.exe</code> is a non-interactive program with a command line interface (CLI).<br />
** It can export ed2k links that can be used to create file entries on AniDB using the <code>--ExportEd2kLinks</code> flag (short form: <code>--Exp</code>).<br />
** it can also submit metadata dumps for processing. This is done using the <code>--Authentication</code> flag (short form: <code>--Auth</code>) with a Username/UDP API key pair.<br />
* <code>Avdump2gui.exe</code> is a graphical user interface (GUI) wrapper around the CLI with a subset of the CLI's functionality.<br />
* <code>Avdump2gui.exe</code> must be used with an API key at all times.<br />
<br />
To calculate and export the identifier information, including the ed2k hash, use either the Avdump2 CLI or GUI.<br />
<br />
=== Avdump2 CLI ===<br />
<br />
==== Command Prompt Introduction ====<br />
<br />
[[Avdump2|wiki/Avdump2]]<br />
<br />
Start a command prompt:<br />
<br />
* <code>Windows + r</code> - Type <code>cmd.exe</code> and press <code>Enter</code>.<br />
* Or<br />
* <code>Windows key</code> - Type <code>cmd.exe</code> and press <code>Enter</code>.<br />
<br />
[[File:windowskey_cmd.guide.png|i.imgur.com/zV1Hyk3.png]]<br />
<br />
[[File:cmd_empty.guide.png|i.imgur.com/A3nbNdc.png]]<br />
<br />
Let's change the current path to <code>C:\Users\User\Downloads\avdump-gui-2.3.2-portable\appdata\avdump-gui-2.3.2.win32</code> using <code>cd</code> or <code>pushd</code>.<br />
<br />
<code>pushd C:\Users\User\Downloads\avdump-gui-2.3.2-portable\appdata\avdump-gui-2.3.2.win32</code><br />
<br />
Or:<br />
<br />
Open an explorer window to: <code>C:\Users\User\Downloads\avdump-gui-2.3.2-portable\appdata\avdump-gui-2.3.2.win32</code> and drag and drop the folder icon on the top left of the address bar to the command prompt window.<br />
<br />
[[File:cmd_drag_folder.guide.png|i.imgur.com/lZGLh8B.png]]<br />
<br />
This will populate the command prompt window with the path to the folder automatically, as shown below. This technique can also be used for individual files.<br />
<br />
[[File:cmd_drag_folder2.guide.png|i.imgur.com/iAZgyIy.png]]<br />
<br />
With the command prompt window selected, press the <code>Home</code> key or hold the <code>Left Arrow</code> on the keyboard to change the cursor to the position furthest to the left.<br />
<br />
[[File:cmd_drag_folder3.guide.png|i.imgur.com/S91EYIk.png]]<br />
<br />
Enter <code>cd</code> and a single space.<br />
<br />
[[File:cmd_drag_folder4.guide.png|i.imgur.com/5rF1tmX.png]]<br />
<br />
Press <code>Enter</code>.<br />
<br />
[[File:cmd_drag_folder5.guide.png|i.imgur.com/OsNtdKK.png]]<br />
<br />
The <code>cd</code> stands for <code>current directory</code> and using it has changed the current directory of the command prompt window to the extracted path of <code>Avdump2CL.exe</code>.<br />
<br />
It is possible to verify <code>Avdump2CL.exe</code> is in the current directory by listing the directory contents or checking to see if the file itself is present. List the direct contents using <code>dir</code>, or, for Linux, <code>ls</code>.<br />
<br />
[[File:cmd_drag_folder6.guide.png|i.imgur.com/uLa3xKM.png]]<br />
<br />
Or check for the executable directly by typing the first few characters <code>av</code> and using <code>Tab</code> to cycle through the available options.<br />
<br />
[[File:Avdump2cl_help.guide.png|i.imgur.com/jUOqCpk.png]]<br />
<br />
Running <code>Avdump2CL.exe</code> without any options will list many available options.<br />
<br />
Running <code>Avdump2CL.exe --help</code> will list all of the available options.<br />
<br />
[[File:Avdump2cl_help2.guide.png|i.imgur.com/fAgurLa.png]]<br />
<br />
====Generating ed2k Links Using Avdump2 CLI====<br />
<br />
The syntax of <code>Avdump2CL.exe</code> is:<br />
<br />
<code>Avdump2CL.exe [--options] [file/folder] [file/folder]</code><br />
<br />
This means that <code>Avdump2CL.exe</code> takes some options and also one or more file or folder paths. The options will specify the type of processing and what file or folder to process.<br />
<br />
For the purproses of this tutorial, there is a file named:<br /><br />
<code>[Yuki] Log Horizon - 01 (BD 720p HEVC Dual-Audio AAC) [F8708ABE].mkv</code><br /><br />
And this file has been placed in:<br /><br />
<code>C:\Users\User\Downloads\Log Horizon</code><br />
<br />
To check what happens when a file or folder is specified but with no processing options, enter `Avdump2cl.exe', and then a space and then drag a file to the command prompt window.<br />
<br />
[[File:Avdump2cl_dragTest1.guide.png|i.imgur.com/5vhdUg4.png]]<br />
<br />
The file name with the full path will be automatically populated in the command prompt window.<br />
<br />
[[File:Avdump2cl_dragTest2.guide.png|i.imgur.com/NiAdL0h.png]]<br />
<br />
Press <code>Enter</code>.<br />
<br />
[[File:Avdump2cl_dragTest3.guide.png|i.imgur.com/8ShIUUC.png]]<br />
<br />
So Avdump2cl.exe complains that no processing options has been specified, so there is nothing to do. So let's give it something to do.<br />
<br />
We are trying to use this program to extract ed2k hash information to create a new release on AniDB. That is done using the <code>--ExportEd2kLinks</code> option, or <code>--Exp</code> for short.<br />
<br />
The syntax is: <code>Avdump2cl.exe --Exp=[ed2kFileName] [file/folder]</code><br />
<br />
When running the actual command, the <code>file/folder</code> section should be substituted for the actual file or folder name as in the previous command. <code>ed2kFileName</code> should be substituted for a text file name, like <code>ed2k.txt</code>. An example of these substitutions is shown below.<br />
<br />
Let's run the command and see what happens.<br />
<br />
* [[File:Avdump2cl_exportTest1.guide.png|i.imgur.com/Ln9BUxg.png]]<br />
<br/><br/><br />
* [[File:Avdump2cl_exportTest2.png|i.imgur.com/PbQTZIE.png]]<br />
<br />
<code>Avdump2cl.exe</code> seems to have processed the file and created a text file called <code>ed2k.txt</code> in its current directory. The file contains one line of contents:<br />
<br/><br/><br />
<code>ed2k://|file|[Yuki] Log Horizon - 01 (BD 720p HEVC Dual-Audio AAC) [F8708ABE].mkv|484345397|C33743B735BF1B282B185E1B2E611270|/</code><br />
<br/><br/><br />
This is what the ed2k links used by AniDB look like. After the protocol specifier (<code>ed2k://</code>), is the <code>file</code> keyword, the filename, the file size, and then finally the ed2k hash.<br />
<br />
The file size <code>484345397</code> is in raw bytes. <code>484345397</code> divided by <code>1024</code> is <code>472,993.55</code> which is the size shown in explorer:<br />
<br />
[[File:Avdump2cl_exportTest3.guide.png|i.imgur.com/2iSZvNI.png]]<br />
<br />
<code>C33743B735BF1B282B185E1B2E611270</code> happens to be the ed2k hash of this specific file. Every file will have a different ed2k hash.<br />
<br />
Let's inform AniDB that this file exists using the ed2k link.<br />
<br />
====Adding File Entries to AniDB====<br />
<br />
[[Mass_add:Files|wiki/Mass_add:Files]]<br />
<br />
Open a web browser and login to [//anidb.net anidb.net] .<br />
<br />
Go to the entry of the Anime in AniDB you want to add a release for. This can be done by using the search feature.<br />
<br />
At the top right, enter the name of the Anime. For the purposes of this tutorial the series name is <code>Log Horizon</code>. Change the content type to <code>anime</code> and then click on <code>Search</code>.<br />
<br />
[[File:anidb_addFile1.guide.png|i.imgur.com/Wk4zyUT.png]]<br />
<br />
Log Horizon has multiple seasons, so each of them are displayed. Click on the correct season.<br />
<br />
[[File:anidb_addFile2.guide.png|i.imgur.com/uoH02cr.png]]<br />
<br />
Scroll down to the <code>Group Status</code> section. Click on the <code>+ Add New Release</code> button.<br />
<br />
[[File:anidb_addFile3.guide.png|i.imgur.com/KWs7Dmp.png]]<br />
<br />
This should bring up the mass add files page.<br />
<br />
[[File:anidb_AddFile4.guide.png|i.imgur.com/V9JfUW3.png]]<br />
<br />
Set the group, source, release date, quality, track, and language options.<br />
<br />
[[How_to_get_started_with_creqing|wiki/How_to_get_started_with_creqing]]<br />
<br />
Let's start with the group. Enter the group name and click on <code>Search</code>.<br />
<br />
[[File:anidb_AddFile5.guide.png|i.imgur.com/9lnDewj.png]]<br />
<br />
The group name should change and have a drop down menu. Be sure to select the correct group name, identified above in Part B. For the purposes of this tutorial, the correct group name is <code>Yuki Subs [YukinoAi]</code>.<br />
<br />
[[File:anidb_AddFile6.guide.png|i.imgur.com/d5pk8fe.png]]<br />
<br />
Change the template from manual to the most appropriate setting. <code>[Yuki] Log Horizon - 01 (BD 720p HEVC Dual-Audio AAC) [F8708ABE].mkv</code> is labeled as Dual-Audio so the <code>dual</code> template should be used. For most fansub releases with only a single japanese audio track and subtitles, the <code>fansub</code> template should be used instead.<br />
<br />
[[File:anidb_AddFile7.guide.png|i.imgur.com/1iOomzC.png]]<br />
<br />
Select source and quality of the file:<br />
<br />
{| class="wikitable"<br />
! Source<br />
! Quality<br />
|-<br />
| DVD/BD<br />
| very high<br />
|-<br />
| DTV<br />
| high<br />
|-<br />
| VHS<br />
| low<br />
|}<br />
<br />
If you happen to know any more information about the file, like if the CRC32 of the file matches the official source, enter it. When in doubt, leave that field unmodified. Audio and subtitle track information can usually be left alone alone because that information will be updated later when the meta-data dump uploaded to AniDB becomes associated with the file entry.<br />
<br />
At the very bottom, paste the ed2k link from and click on <code>Next</code>.<br />
<br />
[[File:anidb_AddFile8.png|i.imgur.com/kSgxaZ9.png]]<br />
<br />
Make sure the episode number is correct. If you happen to know the date the file was first distributed, enter it in <code>dd.mm.yyyy</code> format. When the information looks correct, click on <code>Add Files</code>.<br />
<br />
[[File:anidb_AddFile9.guide.png|i.imgur.com/WPtxkqC.png]]<br />
<br />
Success!<br />
<br />
[[File:anidb_AddFile10.guide.png|i.imgur.com/MCEXDgz.png]]<br />
<br />
To verify the stub-entry exists, go back to the Anime page. In the <code>Group Status</code> Section, click on the expand button for the group.<br />
<br />
[[File:anidb_AddFile11.guide.png|i.imgur.com/TPvgDzm.png]]<br />
<br />
This will populate the <code>Episodes</code> section with file entries for that group. In the image below, episode 1 of Log Horizon has 2 file entries for the selected group. The top entry has already had the meta-information filled in by Avdump2. The bottom entry is the stub that was just created.<br />
<br />
[[File:anidb_AddFile12.guide.png|i.imgur.com/Wf8zsGx.png]]<br />
<br />
* Notice that the audio track, resolution and subtitle information was filled in by Avdump2 automatically for the top file where as this information is not yet correct for the bottom file.<br />
* Under the <code>Hash</code> column, there is an icon <code>AU</code> overlayed and a checkmark. This means a the file was verified by Avdump2.<br />
* The bottom file has <code>CRC</code> overlayed with a checkmark. That means the entry has been marked to indicate that the CRC for the file, matches the official one provided by the release group.<br />
* So the top file has not been marked as having a verified CRC and the bottom one has not had its metadata updated by Avdump2. Let's fix the metadata.<br />
<br />
Back in command prompt world...<br />
<br />
====Adding Dumps Using Avdump2 CLI====<br />
<br />
So, the idea is to use <code>Avdump2cl.exe</code> to send a metadata dump to the server. This can be done using the <code>--Authentication</code> flag, or <code>--Auth</code> for short. The auth flag instructs <code>Avdump2cl.exe</code> to attempt to authenticate with AniDB servers. If authentication fails, <code>Avdump2cl.exe</code> will print an error message and stop. If successful, <code>Avdump2cl.exe</code> will process the file and attempt to send the dump to AniDB servers.<br />
<br />
Note: Please note that all data sent to the server will be logged using IP and user id. If you would like to check what data will be submitted to the server after authentication, run the following command:<br /><br />
<code>Avdump2cl.exe -ca [file/folder]</code><br />
<br />
The auth flag has the following syntax:<br />
<br />
<code>Avdump2cl.exe --Auth=[username]:[api_key] [file/folder]</code><br />
<br />
<code>username</code> in the above command should be subtituted with your AniDB username. The <code>api_key</code> is the character string that was specified in the AniDB profile in Part A. Notice the colon <code>:</code> in between the <code>username</code> and <code>api_key</code>. If following this tutorial, it should be available at <code>C:\Users\User\anidb_apiKey.txt</code> or <code>C:\Users\User\Desktop\anidb_apiKey.txt</code>. Copy it and right-click paste it into the command prompt:<br />
<br />
[[File:Avdump2cl_auth1.guide.png|i.imgur.com/GfGPGUW.png]]<br />
<br />
[[File:Avdump2cl_auth2.guide.png|i.imgur.com/KSSvMjP.png]]<br />
<br />
Enter a space and then drag and drop the file to add to AniDB into the command prompt window as before:<br />
<br />
[[File:Avdump2cl_auth3.guide.png|i.imgur.com/LYSmR8t.png]]<br />
<br />
The command below should be sufficent to submit the meta-data.<br />
<br />
[[File:Avdump2cl_auth4.guide.png|i.imgur.com/c0qq0hp.png]]<br />
<br />
Press <code>Enter</code>. If it works, the following should appear after processing completes:<br />
<br />
[[File:Avdump2cl_submitVerify.guide.png|i.imgur.com/LIGgXjf.png]]<br />
<br />
The line that says:<br /><br />
<code>ACReq( Done: 0 Todo: 1 Failed: 0 Pending: 0 )</code><br /><br />
Means that processing has finished and <code>Avdump2cl.exe</code> will attempt to upload the dump.<br />
<br />
The line that says:<br /><br />
<code>ACReq( Done: 1 Todo: 0 Failed: 0 Pending: 0)</code><br /><br />
Means the server has accepted the data from <code>Avdump2cl.exe</code> and will store it for later processing. '''Success!'''<br />
<br />
If you get an error like the following:<br /><br />
[[File:Avdump2cl_authFail1.guide.png|i.imgur.com/QAqGtbt.png]]<br />
<br />
* Double check the API key is correct.<br />
* The API key being used should be exactly the same one that was entered in the user profile page.<br />
* UDP API keys should also be alphanumeric and no longer than 32-characters. Keys longer than 32 characters may get trunkated to 32.<br />
* Since UDP API keys are cached, changing API keys will take some time to clear, usually less than 30 minutes. Attempting to authenticate before that will result in the above error, even if using the correct key and syntax. So wait 30 minutes and try again basically.<br />
<br />
If you get an error like the following:<br />
<br />
[[File:Avdump2cl_authFail2.guide.png|i.imgur.com/oN118Ln.png]]<br />
<br />
* Notice the error is from <code>ACReq.Authentication</code>. This indicates something to do with authentication caused the error.<br />
* In the above command, that is due to a syntax error in the <code>--Auth</code> switch. The correct syntax is <code>--Auth=username:api_key</code> but in the above command the <code>username</code> is missing.<br />
* Press the up arrow key to bring up the previous command in the command prompt window. Then fix the syntax and run the command again. It should then work.<br />
<br />
Assuming dump submission succeeds, the AniDB page for the file will likely show the following:<br />
<br />
[[File:anidb_AddFile12.guide.png|i.imgur.com/Wf8zsGx.png]]<br />
<br />
In other words, while the correct meta-data has been submitted as part of a dump to AniDB, the information for that file has not changed.<br />
<br />
'''This is normal.''' There is a delay for certain submissions to AniDB. The next section contains more information about how change requests work but for now just know there is a delay and the information will be automatically updated later.<br />
<br />
For the file above, this is what the information looked like less than 24-hours later:<br />
<br />
[[File:Avdump2cl_submitVerifyComplete.guide.png|i.imgur.com/nwrSeBV.png]]<br />
<br />
==== Automating Avdump2 CLI ====<br />
<br />
So far, we have added a single file entry and submitted the associated dump for processing. However, Log Horizon S1 has more than 1 episode. Updating each episode this way, by running <code>Avdump2cl.exe</code> twice, once to create the ed2k link and a second time to submit the dump data, would take an excessively long time. <code>Avdump2cl</code> supports combing different flags together into one command:<br />
<br />
<code>Avdump2cl.exe --Auth=[username]:[api_key] --Exp=[filename] [file/folder]</code><br />
<br />
If the above command syntax is used on a file, <code>Avdump2cl.exe</code> will authenticate with AniDB servers, then if successful, will process the file, submitting the meta-data to AniDB and then export the ed2k link to a file. This means we can run half the number of commands and still get the output needed to update AniDB!<br />
<br />
There is another thing to notice about that syntax. At the end, it says file/folder meaning that <code>Avdump2cl.exe</code> also supports specifying a folder instead of individual files. If a folder is specified, like say: <code>C:\Users\User\Downloads\Log Horizon</code> then <code>Avdump2cl.exe</code> will process every file inside of that folder, generating ed2k links for each file.<br />
<br />
With the above information, the actual command to run would be:<br /><br />
<code>Avdump2cl.exe --Auth=YukinoAi:uFEV55lknCwglqdRp1jte36NQ --Exp=Avdump2cl-ed2k-Links.txt &quot;C:\Users\User\Downloads\Log Horizon&quot;</code><br />
<br />
Notice that <code>C:\Users\User\Downloads\Log Horizon</code> needs quotation marks <code>&quot; &quot;</code> surrounding it because <code>Log Horizon</code> has a space. As long as there are no spaces, quotation marks do not have to be used. Without quotation marks, <code>Avdump2cl.exe</code> will treat and process all of the files in <code>C:\Users\User\Downloads\Log</code> and also all of the files inside the <code>Horizon</code> folder. Since neither of these folders exist, the commad will fail:<br />
<br />
[[File:Avdump2cl_syntaxFail1.guide.png|i.imgur.com/7wV8R5O.png]]<br />
<br />
If using the drag and drop technique instead of copy-paste, quotation marks will automatically be added as appropriate.<br />
<br />
So, running the above command with proper quotation marks will work. The ed2k links generated in the text file can be added to AniDB using the Mass Add page as shown above. However, having to worry about syntax is cumbersome, as is starting a command prompt. Is there not a better way?<br />
<br />
An alternative approach is to create a shell script that will invoke <code>Avdump2cl.exe</code> with the correct syntax automatically. If anything bad happens, like authentication or syntax errors, it will be easy to solve because the correct syntax can just be copied from the text file back to a normal command prompt.<br />
<br />
Open notepad and copy-paste the following cryptic text into a file called <code>AniDBUpdate.bat</code>.<br />
<br />
<pre><br />
@echo off<br />
set username=putUsernameHere<br />
set api_key=putApiKeyHere<br />
set pathToAVDump2CL=C:\Users\User\Downloads\avdump-gui-2.3.2-portable\appdata\avdump-gui-2.3.2.win32<br />
<br />
set mode=auth<br />
::mode can be either exp or auth<br />
<br />
if /i &quot;%~1&quot; equ &quot;&quot; (goto usage)<br />
if /i &quot;%~1&quot; equ &quot;?&quot; (goto usage)<br />
if /i &quot;%~1&quot; equ &quot;/?&quot; (goto usage)<br />
if not exist &quot;%~1&quot; (echo.<br />
echo &quot;%~1&quot; does not exist<br />
goto usage)<br />
<br />
if not exist &quot;%pathToAVDump2CL%\Avdump2cl.exe&quot; (echo.<br />
echo &quot;%pathToAVDump2CL%\Avdump2cl.exe&quot; does not exist<br />
goto usage)<br />
if /i &quot;%username%&quot; equ &quot;putUsernameHere&quot; goto usage<br />
if /i &quot;%api_key%&quot; equ &quot;putApiKeyHere&quot; goto usage<br />
<br />
if /i &quot;%mode%&quot; equ &quot;exp&quot; &quot;%pathToAVDump2CL%\Avdump2cl.exe&quot; --Exp=&quot;%~dp1\ed2k-%~n1.%random%.txt&quot; &quot;%~1&quot; &quot;%~2&quot; &quot;%~3&quot; &quot;%~4&quot; &quot;%~5&quot; &quot;%~6&quot; &quot;%~7&quot; &quot;%~8&quot; &quot;%~9&quot;<br />
::if /i &quot;%mode%&quot; equ &quot;exp&quot; &quot;%pathToAVDump2CL%\Avdump2cl.exe&quot; --Exp=&quot;%userprofile%\Desktop\ed2k-Link-%~n1.%random%.txt&quot; &quot;%~1&quot; &quot;%~2&quot; &quot;%~3&quot; &quot;%~4&quot; &quot;%~5&quot; &quot;%~6&quot; &quot;%~7&quot; &quot;%~8&quot; &quot;%~9&quot;<br />
if /i &quot;%mode%&quot; equ &quot;auth&quot; &quot;%pathToAVDump2CL%\Avdump2cl.exe&quot; --Auth=&quot;%username%:%api_key%&quot; --Exp=&quot;%~dp1\ed2k-%~n1.%random%.txt&quot; &quot;%~1&quot; &quot;%~2&quot; &quot;%~3&quot; &quot;%~4&quot; &quot;%~5&quot; &quot;%~6&quot; &quot;%~7&quot; &quot;%~8&quot; &quot;%~9&quot;<br />
::if /i &quot;%mode%&quot; equ &quot;auth&quot; &quot;%pathToAVDump2CL%\Avdump2cl.exe&quot; --Auth=&quot;%username%:%api_key%&quot; --Exp=&quot;%userprofile%\Desktop\ed2k-Link-%~n1.%random%.txt&quot; &quot;%~1&quot; &quot;%~2&quot; &quot;%~3&quot; &quot;%~4&quot; &quot;%~5&quot; &quot;%~6&quot; &quot;%~7&quot; &quot;%~8&quot; &quot;%~9&quot;<br />
<br />
goto end<br />
:usage<br />
echo.<br />
echo OMG^! Hi^!^!^! Usage Help:<br />
echo.<br />
echo %~nx0 can be used to automate usage of Avdump2cl.exe<br />
echo Please update &quot;username&quot; and &quot;api_key&quot; before using %~nx0.<br />
echo. <br />
echo CLI Usage: <br />
echo %~nx0 &quot;C:\Users\User\Downloads\Log Horizon&quot;<br />
echo %~nx0 &quot;C:\Users\User\Downloads\Log Horizon\episode01.mkv&quot;<br />
echo.<br />
echo Drag and drop also works.<br />
echo.<br />
echo For &quot;right-click Send to&quot; functionality, copy a shortcut to:<br />
echo &quot;%appdata%\..\roaming\Microsoft\Windows\SendTo&quot;<br />
echo.<br />
pause<br />
<br />
:end<br />
<br />
<br />
</pre><br />
[[File:AniDBUpdate_1.guide.png|i.imgur.com/3glAjpw.png]]<br />
<br />
The three highlighted items need to be changed before using the script. Update the username and API key appropriately. Make sure there are no trailing whitespaces in either the username or api_key. &quot;Name&quot; will work but &quot;Name &quot; will not. Example:<br />
<br />
[[File:AniDBUpdate_2.guide.png|i.imgur.com/OhfWiuG.png]]<br />
<br />
For the pathToAvdump2 entry, the path should not include a trailing <code>\</code>.<br />
<br />
Example:<br />
<br />
* <code>C:\avdump-gui-2.3.2-portable</code> will work.<br />
* <code>C:\avdump-gui-2.3.2-portable\</code> will not work.<br />
<br />
After entering the username and the UDP API key, here are 3 ways to run the above text file:<br />
<br />
1) Hardest: Command prompt method: Navigate to the correct directory and type <code>AniDBUpdate.bat</code>.<br />
<br />
[[File:AniDBUpdate_cmd.guide.png|i.imgur.com/3N0Sg5f.png]]<br />
<br />
2) Drag and drop method: Drag and drop a file or folder onto the batch file.<br />
<br />
[[File:AniDBUpdate_drag1.guide.png|i.imgur.com/eLFgKWf.png]]<br />
<br /><br />
[[File:AniDBUpdate_drag2.guide.png|i.imgur.com/sxIleWJ.png]]<br />
<br />
3) Easiest: Send-to method: Use the right-click <code>Send to</code> context menu.<br />
<br />
[[File:AniDBUpdate_sendToExample.guide.png|i.imgur.com/kuUEJsh.png]]<br />
<br />
For the send-to method to work, the file, or a shortcut to it, must be placed at:<br /><br />
<code>C:\Users\Username\AppData\Roaming\Microsoft\Windows\SendTo</code><br /><br />
To open this folder automatically, paste the following into an explorer address bar or <code>Windows key + r</code><br /><br />
<code>&quot;%appdata%\..\roaming\Microsoft\Windows\SendTo&quot;</code><br />
<br />
# <code>Ctrl + c</code> to copy: <code>&quot;%appdata%\..\roaming\Microsoft\Windows\SendTo&quot;</code><br />
# <code>Windows key + r</code><br />
# <code>Ctrl + v</code> to Paste the above contents<br />
## [[File:AniDBUpdate_sendTo1.guide.png|i.imgur.com/Dw7Ckdc.png]]<br />
# Press <code>Enter</code><br />
# Right-Click - create a new shortcut<br />
## [[File:AniDBUpdate_sendTo2.guide.png|i.imgur.com/VsyL3TV.png]]<br />
# Move the shortcut from where it was created to <code>\SentTo</code>.<br />
## [[File:AniDBUpdate_sendTo3.guide.png|i.imgur.com/iUQCorO.png]]<br />
# Rename the shortcut appropriately.<br />
<br />
With the command prompt and send-to methods:<br />
<br />
* Up to 9 discrete files and folders may be selected<br />
* When sending a folder, all files within that folder and all subfolders will be processed.<br />
<br />
===Avdump2 GUI===<br />
<br />
Avdump2gui.exe is the graphical user interface (GUI) wrapper for <code>Avdump2cl.exe</code> and supports a subset of the features:<br />
<br />
Avdump2 GUI Limitations. The GUI:<br />
<br />
* always requires authenticating.<br />
* will not generate links without specifying a valid username and valid API key pair, every time.<br />
** Note: This information is forcibly saved across instances.<br />
* must be deliberately started every time to be used.<br />
* will not issue an error message when authentication fails and simply not respond.<br />
** If the GUI does not respond, it is advisable to test for authentication errors using <code>Avdump2CL.exe</code>.<br />
* requires updating prior to usage.<br />
<br />
With these limitations in mind. Launch Avdump2gui to have it update automatically.<br />
<br />
# Specify the username and api-key.<br />
# Use the <code>Files</code> and <code>Folder</code> buttons too add files to process.<br />
## [[File:Avdump2gui_1.guide.png|i.imgur.com/3ypUEcP.png]]<br />
# When complete, click start to see what happens.<br />
## If/When nothing happens check for authentication errors using <code>Avdump2CL.exe</code> using the instructions provided above.<br />
# If it works, nothing will happen for a while, and then eventually ed2k links will appear in the ed2k export window. The dump data should have been submitted to AniDB in the background, although there is no way to check.<br />
## [[File:Avdump2gui_2.guide.png|i.imgur.com/r52bp7D.png]]<br />
<br />
The ed2k links in the export window can now be submitted to AniDB. Detailed instructions for this are provided above.<br />
<br />
== Understanding AniDB Change Requests (creqs) ==<br />
<br />
:{{Missing}}<br />
<br />
AniDB is a user-driven database. A normal way to contribute is to issue change requests (creqs for short), which means that a moderator has to approve suggested changes before they are published. Request links can usually be found on every page that has editable content for logged in users.<br />
<br />
* Except for obvious changes, always describe the reason for changes in the request and/or the source of the information.<br />
* Be prepared to follow up the requests made. Creqs will be denied if there is no response to moderator questions.<br />
<br />
More info:<br /><br />
[[How_to_update_or_correct_existing_entries|wiki/How_to_update_or_correct_existing_entries]]<br/><br />
[[How_to_get_started_with_creqing|wiki/How_to_get_started_with_creqing]]<br />
<br />
Avdump2, used above, is AniDB's mechanism to submit automatic change requests (acreqs or auto-creq). These automatic change requests do not always require moderator approval because the information (file-metadata) has been verified programmatically. For auto-creqing:<br />
<br />
* All data sent to the server will be logged with IP and user id.<br />
* There is no direct connection between data sent to AniDB and creqs generated. The data dumps will just be stored for later processing into creqs.<br />
* There is no way to check the current status for a dump.<br />
* Avdump2cl.exe will display a count of the files that have been submitted to the server as output as <code>ACReq ( Done: # [...]</code>, but that is all.<br />
* Usually, it should take at least 24 hours from the moment a file metadata dump has been submited untill the file data actually changes. If any irregularities occur, or when there is too much data pending, it will take more time. The system auto-creqs to add missing tracks within 72 hours.<br />
* It is possible to dump files currently not in the database. The data is still stored and will be used later if/after the file has been registered.<br />
<br />
In other words, when Avdump2 submits meta-data dumps to AniDB, the data itself may get processed into a change request. But first, in order to automatically apply the dumped metadata information to a file, that file must be registered first. The process of submitting ed2k links is that registration process. The metadata dumps themselves also contain the ed2k hash information that serves as the basis to link it to registered files.<br />
<br />
To learn more about creqs please check out:<br />
<br />
"Adding Data" subsection on [[Main_Page|wiki/Main_Page]]<br />
<br />
For further help with a problem or just for chatting visit IRC:<br />
<br />
Wiki page for IRC: [[IRC:anidb|wiki/IRC:anidb]]<br /><br />
Channel Address: irc://irc.synirc.net/anidb</div>YukinoAihttps://wiki.anidb.net/index.php?title=File:AniDBUpdate_sendToExample.guide.png&diff=22950File:AniDBUpdate sendToExample.guide.png2017-09-04T09:54:05Z<p>YukinoAi: </p>
<hr />
<div></div>YukinoAihttps://wiki.anidb.net/index.php?title=File:AniDBUpdate_sendTo1.guide.png&diff=22949File:AniDBUpdate sendTo1.guide.png2017-09-04T09:46:06Z<p>YukinoAi: YukinoAi uploaded a new version of File:AniDBUpdate sendTo1.guide.png</p>
<hr />
<div></div>YukinoAihttps://wiki.anidb.net/index.php?title=File:AniDBUpdate_sendTo1.guide.png&diff=22948File:AniDBUpdate sendTo1.guide.png2017-09-04T09:40:33Z<p>YukinoAi: YukinoAi uploaded a new version of File:AniDBUpdate sendTo1.guide.png</p>
<hr />
<div></div>YukinoAihttps://wiki.anidb.net/index.php?title=Tutorial:How_to_Add_Files_for_Dummies!&diff=22933Tutorial:How to Add Files for Dummies!2017-08-16T09:25:10Z<p>YukinoAi: Added small link at the bottom to alternative guide.</p>
<hr />
<div>{{TOCright}}<br />
AniDB is file based. Because of this, all group release statuses in AniDB are calculated from the added files! Keep that in mind.<br />
{{eyecatch|Note|If anything is unclear or you need more guidance, speak to us on IRC at #anidb@irc.synirc.net for help. Plese be patient, as people in the channel can be AFK.}}<br />
{{eyecatch|Note|Do '''NOT''' add files that '''only''' you have: self-(re)encoded or corrupted files should not be added.}}<br />
<br />
===Step 1===<br />
* Verify that the group you want to add a release for has already been added (see [[Content:Groups|Groups]]).<br />
* If not, add the group details before continuing.<br />
<br />
===Step 2===<br />
''To add files to AniDB you need the [[Ed2k-hash|ed2k links]] of the files. There are multiple ways to generate these. One of the simplest, which also provides AniDB with a lot of metadata (hashes, length, bitrate, codec info etc.), is [[Avdump2]].''<br />
* Get [http://static.anidb.net/client/avdump-gui.msi Avdump GUI]. More help/info on Avdump GUI can be found [[Avdump_GUI|here on the Avdump GUI page]].<br />
* Install it.<br />
* Start it (click the avdump2 icon on your desktop).<br />
* Set your AniDB username and UDP API key.<br />
{{eyecatch|Note|To use [[Avdump2]], you need to create an UDP API Key (choose anything you'd like) in your {{ProfileLink}}, under Profile -> Account -> UDP API Key.}}<br />
* Select what you want to scan from the main menu: files or folders.<br />
* Click Start.<br />
<br />
===Step 3===<br />
{{eyecatch|Note|When registering the new file information (audio tracks, subtitles) it's better to set just the minimum. The avdump2 data will automatically add the extra streams, and fix their tags for language, type, codec (provided that they were correctly set by the encoder). You can always fix this information after the metadata has been processed.}}<br />
* Go to the entry of the [[Content:Anime|Anime]] in AniDB you want to add a release for.<br />
* Scroll down to the groups block on the page and click the '''[[Mass add:Files|add new release]]''' button.<br />
* Copy the '''ed2k://''' links from the ed2k-export window and paste those lines into the big text area on the [[Mass add:Files|add new release]] page.<br />
* Set the group, source, release date, quality, track, and language options. There are some default templates to help you along.<br />
* Click ''Next''.<br />
* Set the episodes the files belong to. AniDB tries to get the episode relations from the file names, but this is not guaranteed to work correctly in every case.<br />
* Release dates should be entered for files when it is known. The release date would be the date of the '''FIRST''' instance of the file appearing on the internet (ie do not use a re-release date).<br />
<br />
===Step 4===<br />
====Animegroup Release Note Comments====<br />
[[File:Animegroup_releasenotes1.PNG|200px|thumb|text-bottom|right|Step 1: click on the Animegroup comment edit button to edit the release notes.]]<br />
[[File:Animegroup_releasenotes2.PNG|200px|thumb|text-bottom|right|Step 2: enter the release notes in the "Note" field. Provide a link to the source of the information in the "Comment for Mod" field.]]<br />
{{eyecatch|Note|If there are any uncertainties, such as examples not covered below, please consult [http://anidb.net/up560966 CDB-Man] for clarification.}}<br />
The Animegroup release note comments are used to provide information on a group's particular release of a given anime. The most common information here would be credit/attribution for original sources, such as if the subtitles are from another group's work, or if a specific group's raws were used.<br />
<br />
====How to Add Animegroup Release Note Comments====<br />
The animegroup release note comments can be edited directly from the anime page.<br />
<br />
Step 1: click on the Animegroup comment edit button on the right hand side of the anime page to edit the release notes. (see screenshot 1)<br><br />
Step 2: enter the release notes in the "Note" field. Provide a link to the source of the information in the "Comment for Mod" field. A valid source could include a link to a fansub blog, a torrent description, etc. Provide an explanation to the mod if the note note is not self explanatory. (see screenshot 2)<br />
<br />
Please see [[Groupentries:Status#Animegroup_Release_Note_Comments|our release note comments main page]] for standardized formatting of release notes.<br />
<br />
===Step 5 (optional)===<br />
In case a file spans multiple episodes you should add the file to the first episode it spans completely. Afterwards you will have to do one more thing:<br />
* Go to the entry of the file where you can see all the file-related details like bitrate, codec etc.<br />
* At the bottom of that page you will find a link called '''add new episode relation'''.<br />
* Choose the other episode this file belongs to and hit add.<br />
Repeat this process for any additional episodes the file spans.<br />
<br />
<span style="font-size:60%">For a more lengthy guide: [[Tutorial:How to Add Files for Dummies!/The Prolix Addendum|The Prolix Addendum]].</span></div>YukinoAihttps://wiki.anidb.net/index.php?title=Tutorial:How_to_Add_Files_for_Dummies!/The_Prolix_Addendum&diff=22932Tutorial:How to Add Files for Dummies!/The Prolix Addendum2017-08-16T09:12:35Z<p>YukinoAi: Created page with "[//anidb.net Anime DataBase (AniDB)] is a website that provides information about Anime. It keeps track of [//anidb.net/perl-bin/animedb.pl?show=anime&aid=109 show informatio..."</p>
<hr />
<div>[//anidb.net Anime DataBase (AniDB)] is a website that provides information about Anime.<br />
<br />
It keeps track of [//anidb.net/perl-bin/animedb.pl?show=anime&aid=109 show information] and fansub releases for them. It has some [//anidb.net/perl-bin/animedb.pl?show=forum social aspects] as well. [[AniDB:About|More info]]. Databases are only useful if they are updated frequently, so this tutorial is about keeping fansub releases on AniDB up to date.<br />
<br />
{{eyecatch|Note|This guide has a lot of theory to help explain how to interface with AniDB. For a more concise guide, please consider: [[Tutorial:How to Add Files for Dummies!]]}}<br />
<br />
==Introduction==<br />
<br />
AniDB needs to know 3 things to create a full entry for a release:<br />
<br />
# Which group (or user) released the file.<br />
# The unique hash of the file and file name.<br />
# The file metadata (resolution, audio tracks, subtitles, etc).<br />
<br />
The [[Avdump2]] utility can be used to automatically update AniDB file entries and will be used later.<br />
<br />
* The release group should be associated with each file when creating an entry for it. <br />
** Non-offical, or files that are not distributed, should not be added. <br />
** Release group examples: Horrible Subs, Kametsu, and Doki.<br />
* Before creating an entry for a file, the unique ed2k hash must first be calculated because the ed2k hash will be used in identifying the file.<br />
* The ed2k hash for the unique identifier can be generated by using [[Avdump2]], or any other program that can generate ed2k hashes.<br />
* The file's metadata should be updated using the Avdump2 tool.<br />
<br />
And so, it is convenient to use the Avdump2 tool to both generate the unique identifier and also update file metadata.<br />
<br />
'''Additional Resources:'''<br /><br />
[[Main_Page|wiki/Main_Page]]<br /><br />
[[Auto-creqing|wiki/Auto-creqing]]<br /><br />
[[Avdump2|wiki/Avdump2]]<br />
<br />
== Prerequisites ==<br />
<br />
# Obtain a file to add to AniDB.<br />
## The group name is usually present in the file name or description.<br />
# [//anidb.net/perl-bin/animedb.pl?show=signup Create an AniDB account].<br />
# [//anidb.net/perl-bin/animedb.pl?show=login Login] and verify that account.<br />
<br />
== Creating an API Key ==<br />
<br />
===Theory===<br />
<br />
At some point, meta-information for files should be submited using Avdump2. That meta-information is initially associated with the user account that made the submission. While users normally enter usernames/passwords for authentication, Avdump2 needs a unique string of characters to update meta-data. In this context, the string of characters that authenticates a user utilizing Avdump2 is known as an <code>API Key</code> or a <code>UDP API Key.</code><br />
<br />
UDP API keys can be specified in the user profile section on AniDB.net.<br />
<br />
===Procedure===<br />
<br />
[//anidb.net/perl-bin/animedb.pl?show=login Log in to AniDB]<br /><br />
On the left navigation pane, at the bottom is a section labeled <code>Account</code>. Click on <code>Settings</code>.<br />
<br />
[[File:anidb_account_settings_highlight.guide.png|i.imgur.com/fEqwtnZ.png]]<br />
<br />
Under profile, in the main navigation window, there are tabs. Click on the one that says <code>Account</code> (highlighted for emphasis). <br />
<br />
[[File:anidb_accountSettings_AccountTab_highlight.guide.png|i.imgur.com/maGR6jL.png]]<br />
<br />
There should be a section called <code>UDP API Key</code> with two fields, one with a label and another empty one.<br />
<br />
[[File:anidb_account_udpApiKey_empty.guide.png|i.imgur.com/j9B4eSr.png]]<br />
<br />
Any alphanumeric (a-z, A-Z, 0-9) character sequence no longer than 32 characters will work for the API key. For the purposes of this tutorial GRC's [//www.grc.com/passwords.htm Perfect Passwords] will be used.<br />
<br />
Open a new tab in the web browser and go to GRC's [//www.grc.com/passwords.htm Perfect Passwords] page.<br />
<br />
In the last box of characters labeled <code>a-z, A-Z, 0-9</code>, highlight 20-30 characters as shown below.<br />
<br />
[[File:grc_pp_20charas_highlight.guide.png|border|i.imgur.com/Z3D68ca.guide.png|]]<br />
<br />
Then copy the selected characters to the clipboard.<br />
<br />
* Right-Click - Copy<br />
* <code>Ctrl + c</code><br />
<br />
[[File:grc_pp_20characters_copy.guide.png|border|i.imgur.com/3qlV9iu.guide.png]]<br />
<br />
Change tabs back to AniDB's page.<br />
<br />
In the empty field under the <code>UDP API Key</code>, right-click and select <code>Paste</code>. Alternatively: <code>Ctrl + v</code>.<br /><br />
[[File:anidb_account_udpAPIKey_paste.guide.png|i.imgur.com/3V61Mo2.guide.png]]<br />
<br />
[[File:anidb_account_udpAPIKey_inserted.guide.png|i.imgur.com/q5yZPHa.guide.png]]<br />
<br />
Click on the <code>Apply</code> button at the bottom. It should be right above <code>Back</code>.<br /><br />
[[File:anidb_account_udpAPIKey_apply.guide.png|i.imgur.com/6761Qg3.guide.png]]<br /><br />
The <code>UDP API Key</code> field should turn into asterisks (*) to show that it has saved it properly.<br /><br />
[[File:anidb_account_udpAPIKey_asterisks.guide.png|i.imgur.com/l9OzPgu.guide.png]]<br /><br />
The API key should also be saved for use with Avdump2 later on, so lets save it to notepad.<br />
<br />
<code>Windows key</code> or Click on the start menu and type in <code>notepad</code>.<br />
<br />
[[File:windowskey_notepad.guide.png|i.imgur.com/SVi1A65.guide.png|]]<br />
<br />
[[File:notepad_apiKey_paste.guide.png|i.imgur.com/juAtU1M.guide.png]]<br />
<br />
Save the file as something descriptive or as <code>anidb_apiKey.txt</code> in your user profile folder (<code>C:\Users\User</code>) or desktop (<code>C:\Users\User\Desktop</code>).<br />
<br />
* <code>File</code> - <code>Save As...</code><br />
* <code>Ctrl + s</code><br />
<br />
Changes to the API key are updated immediately server-side but old entries are cached for an unspecified amount of time, usually less than 30 minutes. Attempting to use the new key before the old key has been removed from the cache will produce this error in the <code>Avdump2cl.exe</code>:<br />
<br />
[[File:Avdump2cl_apiKey_timeout.guide.png|i.imgur.com/SAZIZt8.guide.png]]<br />
<br />
The Avdump2 GUI will simply not respond when authentication fails. More on this later.<br />
<br />
== Dealing With Groups ==<br />
<br />
===Theory===<br />
Every file entry should be associated with a release group. The group name or tag is usually in the file name, usually in brackets <code>[ ]</code>. It is important to identify the release group and to verify the group already exists in AniDB.<br />
<br />
Examples:<br />
<br />
{| class="wikitable"<br />
!width="15%"| Filename<br />
!width="5%"| Group Name or [Tag]<br />
|-<br />
| [Yuki] Log Horizon - 01 (BD 1080p HEVC Dual-Audio AAC) [2D099D6D].mkv<br />
| Yuki<br />
|-<br />
| Log Horizon - 01 (1080p) BD x265 10-bit (DualAudio) AC3 AAC [KoTuWa].mkv<br />
| KoTuWa<br />
|-<br />
| [ReinForce] Log Horizon - 01 (BDRip 1920x1080 x264 FLAC).mkv<br />
| ReinForce<br />
|-<br />
| [JacobSwaggedUp] Log Horizon - 01 (BD 1280x720).mp4<br />
| JacobSwaggedUp<br />
|-<br />
| Log.Horizon.S01E01.720p-Hi10p.BluRay.AAC2.0-CTR.[B73B6592].mkv<br />
| CTR<br />
|-<br />
| {AnimeServ.NET} Log Horizon 01 (Blu-ray)(1920x1080 x264 AAC).mp4<br />
| AnimeServ.Net<br />
|-<br />
| [RHxUHA-WING]Log_Horizon_S1[01][BIG5][720P].mp4<br />
| RHxUHA-WING<br />
|-<br />
| [BDMV][150724] Log Horizon - Vol.1<br />
| n/a<br />
|-<br />
| (Shin-Raw) Log Horizon 01 720p (HEVC-HEAAC) [7F99A1E7].mp4<br />
| Shin-Raw<br />
|}<br />
<br />
For Anime, most groups put their names in brackets <code>[ ]</code> but not always. Group names like DVDISO, RawDVD, BDMV, Anime BD, RAW, R2RAW are keywords that indicate a group is not associated with the upload, usually for uploading unmodified content.<br />
<br />
When there is a <code>-</code> or <code>&amp;</code> in the group name, that sometimes means it is a joint release between 2 or more groups. Joint releases are also known as &quot;virtual&quot; releases in AniDB terminology.<br />
<br />
In an example above, RHxUHA-WING may be a single group's name or it may be 2 different groups, RHxUHA and WING. Read the description in the download page to find out or search AniDB.<br />
<br />
Verify the group exists by searching for it on AniDB.<br />
<br />
===Procedure===<br />
<br />
Open [//anidb.net Anime DataBase (AniDB)].<br />
<br />
At the top right next to <code>Search</code> change the search type from <code>all</code> to <code>group</code>.<br />
<br />
[[File:anidb_search_group1.guide.png|i.imgur.com/4U31JYW.guide.png]]<br />
<br />
Enter the group name found in the filename and click on <code>Search</code>. In the example below, <code>Doki</code> is used as an example of a group (highlighted for emphasis).<br />
<br />
[[File:anidb_search_group2.guide.png|i.imgur.com/XIR5058.png]]<br />
<br />
Click on the group name in the <code>Name</code> column. In the below example it would be <code>Doki Fansubs</code>.<br />
<br />
[[File:anidb_search_group3.guide.png|700px|i.imgur.com/aJudr9s.png]]<br />
<br />
Only if the group does not exist, [//anidb.net/perl-bin/animedb.pl?show=addgroup create it]. Before actually adding a group, read [[Content:Groups|this]] and [[Which_raw_groups_to_credit|this]].<br />
<br />
For the purposes of this tutorial, it will be assumed the group name already exists.<br />
<br />
== On Using Avdump2 ==<br />
<br />
===Theory===<br />
<br />
* A file entry in AniDB has 2 main components, the entry itself and the associated metadata.<br />
* AniDB stores metadata information for files that are not yet in the database. This means it is possible to add a file entry and then add the metadata, or alternatively, add the metadata to AniDB and create the file entry later.<br />
* The metadata and the file entry are normally linked using a unique identifier created from the [[Ed2k-hash]] and the filesize.<br />
<br />
Thus, to create a file entry in AniDB, the ed2k hash must be known and the group name should be known.<br />
<br />
The main purpose of the [[Avdump2]] utility, and its [[Avdump_GUI|GUI wrapper]], is to automate updating AniDB file entries. It does 3 things:<br />
<br />
# Hash files to identify them (ed2k).<br />
# Extract Audio/Video/Subtitle and other media information.<br />
# Send that information to the server.<br />
<br />
Together, the hash information and the media information are called a &quot;dump,&quot; short for metadata dump or file dump.<br />
<br />
This tutorial will cover creating files associated with a release on AniDB using their ed2k identifier also submitting dumps.<br />
<br />
===Installation===<br />
<br />
:{{Missing}}<br />
<br />
[[Avdump_GUI|Download the portable GUI version]], [//static.anidb.net/client/avdump-gui-2.3.2-portable.7z direct], (it has both the CLI and GUI) and [//www.7-zip.org/download.html extract it] to <code>C:\Users\User\Downloads</code>. See this random [http://www.gofree.com/Tutorials/ExtractingZipFiles.php 7-Zip Tutorial]. Alternative [//static.anidb.net/client/avdump-gui.msi MSI installer].<br />
<br />
For the purposes of this tutorial, it will be assumed the CLI tool is at:<br /><br />
<code>C:\Users\User\Downloads\avdump-gui-2.3.2-portable\appdata\avdump-gui-2.3.2.win32\Avdump2CL.exe</code><br /><br />
And the GUI tool is available at:<br /><br />
<code>C:\Users\User\Downloads\avdump-gui-2.3.2-portable\Avdump2gui.exe</code><br />
<br />
* <code>Avdump2CL.exe</code> is a non-interactive program with a command line interface (CLI).<br />
** It can export ed2k links that can be used to create file entries on AniDB using the <code>--ExportEd2kLinks</code> flag (short form: <code>--Exp</code>).<br />
** it can also submit metadata dumps for processing. This is done using the <code>--Authentication</code> flag (short form: <code>--Auth</code>) with a Username/UDP API key pair.<br />
* <code>Avdump2gui.exe</code> is a graphical user interface (GUI) wrapper around the CLI with a subset of the CLI's functionality.<br />
* <code>Avdump2gui.exe</code> must be used with an API key at all times.<br />
<br />
To calculate and export the identifier information, including the ed2k hash, use either the Avdump2 CLI or GUI.<br />
<br />
=== Avdump2 CLI ===<br />
<br />
==== Command Prompt Introduction ====<br />
<br />
[[Avdump2|wiki/Avdump2]]<br />
<br />
Start a command prompt:<br />
<br />
* <code>Windows + r</code> - Type <code>cmd.exe</code> and press <code>Enter</code>.<br />
* Or<br />
* <code>Windows key</code> - Type <code>cmd.exe</code> and press <code>Enter</code>.<br />
<br />
[[File:windowskey_cmd.guide.png|i.imgur.com/zV1Hyk3.guide.png]]<br />
<br />
[[File:cmd_empty.guide.png|i.imgur.com/A3nbNdc.guide.png]]<br />
<br />
Let's change the current path to <code>C:\Users\User\Downloads\avdump-gui-2.3.2-portable\appdata\avdump-gui-2.3.2.win32</code> using <code>cd</code> or <code>pushd</code>.<br />
<br />
<code>pushd C:\Users\User\Downloads\avdump-gui-2.3.2-portable\appdata\avdump-gui-2.3.2.win32</code><br />
<br />
Or:<br />
<br />
Open an explorer window to: <code>C:\Users\User\Downloads\avdump-gui-2.3.2-portable\appdata\avdump-gui-2.3.2.win32</code> and drag and drop the folder icon on the top left of the address bar to the command prompt window.<br />
<br />
[[File:cmd_drag_folder.guide.png|i.imgur.com/lZGLh8B.guide.png]]<br />
<br />
This will populate the command prompt window with the path to the folder automatically, as shown below. This technique can also be used for individual files.<br />
<br />
[[File:cmd_drag_folder2.guide.png|i.imgur.com/iAZgyIy.guide.png]]<br />
<br />
With the command prompt window selected, press the <code>Home</code> key or hold the <code>Left Arrow</code> on the keyboard to change the cursor to the position furthest to the left.<br />
<br />
[[File:cmd_drag_folder3.guide.png|i.imgur.com/S91EYIk.guide.png]]<br />
<br />
Enter <code>cd</code> and a single space.<br />
<br />
[[File:cmd_drag_folder4.guide.png|i.imgur.com/5rF1tmX.guide.png]]<br />
<br />
Press <code>Enter</code>.<br />
<br />
[[File:cmd_drag_folder5.guide.png|i.imgur.com/OsNtdKK.guide.png]]<br />
<br />
The <code>cd</code> stands for <code>current directory</code> and using it has changed the current directory of the command prompt window to the extracted path of <code>Avdump2CL.exe</code>.<br />
<br />
It is possible to verify <code>Avdump2CL.exe</code> is in the current directory by listing the directory contents or checking to see if the file itself is present. List the direct contents using <code>dir</code>, or, for Linux, <code>ls</code>.<br />
<br />
[[File:cmd_drag_folder6.guide.png|i.imgur.com/uLa3xKM.guide.png]]<br />
<br />
Or check for the executable directly by typing the first few characters <code>av</code> and using <code>Tab</code> to cycle through the available options.<br />
<br />
[[File:Avdump2cl_help.guide.png|i.imgur.com/jUOqCpk.guide.png]]<br />
<br />
Running <code>Avdump2CL.exe</code> without any options will list many available options.<br />
<br />
Running <code>Avdump2CL.exe --help</code> will list all of the available options.<br />
<br />
[[File:Avdump2cl_help2.guide.png|i.imgur.com/fAgurLa.guide.png]]<br />
<br />
====Generating ed2k Links Using Avdump2 CLI====<br />
<br />
The syntax of <code>Avdump2CL.exe</code> is:<br />
<br />
<code>Avdump2CL.exe [--options] [file/folder] [file/folder]</code><br />
<br />
This means that <code>Avdump2CL.exe</code> takes some options and also one or more file or folder paths. The options will specify the type of processing and what file or folder to process.<br />
<br />
For the purproses of this tutorial, there is a file named:<br /><br />
<code>[Yuki] Log Horizon - 01 (BD 720p HEVC Dual-Audio AAC) [F8708ABE].mkv</code><br /><br />
And this file has been placed in:<br /><br />
<code>C:\Users\User\Downloads\Log Horizon</code><br />
<br />
To check what happens when a file or folder is specified but with no processing options, enter `Avdump2cl.exe', and then a space and then drag a file to the command prompt window.<br />
<br />
[[File:Avdump2cl_dragTest1.guide.png|i.imgur.com/5vhdUg4.guide.png]]<br />
<br />
The file name with the full path will be automatically populated in the command prompt window.<br />
<br />
[[File:Avdump2cl_dragTest2.guide.png|i.imgur.com/NiAdL0h.png]]<br />
<br />
Press <code>Enter</code>.<br />
<br />
[[File:Avdump2cl_dragTest3.guide.png|i.imgur.com/8ShIUUC.png]]<br />
<br />
So Avdump2cl.exe complains that no processing options has been specified, so there is nothing to do. So let's give it something to do.<br />
<br />
We are trying to use this program to extract ed2k hash information to create a new release on AniDB. That is done using the <code>--ExportEd2kLinks</code> option, or <code>--Exp</code> for short.<br />
<br />
The syntax is: <code>Avdump2cl.exe --Exp=[ed2kFileName] [file/folder]</code><br />
<br />
When running the actual command, the <code>file/folder</code> section should be substituted for the actual file or folder name as in the previous command. <code>ed2kFileName</code> should be substituted for a text file name, like <code>ed2k.txt</code>. An example of these substitutions is shown below.<br />
<br />
Let's run the command and see what happens.<br />
<br />
* [[File:Avdump2cl_exportTest1.guide.png|i.imgur.com/Ln9BUxg.png]]<br />
<br/><br/><br />
* [[File:Avdump2cl_exportTest2.png|i.imgur.com/PbQTZIE.png]]<br />
<br />
<code>Avdump2cl.exe</code> seems to have processed the file and created a text file called <code>ed2k.txt</code> in its current directory. The file contains one line of contents:<br />
<br/><br/><br />
<code>ed2k://|file|[Yuki] Log Horizon - 01 (BD 720p HEVC Dual-Audio AAC) [F8708ABE].mkv|484345397|C33743B735BF1B282B185E1B2E611270|/</code><br />
<br/><br/><br />
This is what the ed2k links used by AniDB look like. After the protocol specifier (<code>ed2k://</code>), is the <code>file</code> keyword, the filename, the file size, and then finally the ed2k hash.<br />
<br />
The file size <code>484345397</code> is in raw bytes. <code>484345397</code> divided by <code>1024</code> is <code>472,993.55</code> which is the size shown in explorer:<br />
<br />
[[File:Avdump2cl_exportTest3.guide.png|i.imgur.com/2iSZvNI.png]]<br />
<br />
<code>C33743B735BF1B282B185E1B2E611270</code> happens to be the ed2k hash of this specific file. Every file will have a different ed2k hash.<br />
<br />
Let's inform AniDB that this file exists using the ed2k link.<br />
<br />
====Adding File Entries to AniDB====<br />
<br />
[[Mass_add:Files|wiki/Mass_add:Files]]<br />
<br />
Open a web browser and login to [//anidb.net anidb.net] .<br />
<br />
Go to the entry of the Anime in AniDB you want to add a release for. This can be done by using the search feature.<br />
<br />
At the top right, enter the name of the Anime. For the purposes of this tutorial the series name is <code>Log Horizon</code>. Change the content type to <code>anime</code> and then click on <code>Search</code>.<br />
<br />
[[File:anidb_addFile1.guide.png|i.imgur.com/Wk4zyUT.png]]<br />
<br />
Log Horizon has multiple seasons, so each of them are displayed. Click on the correct season.<br />
<br />
[[File:anidb_addFile2.guide.png|i.imgur.com/uoH02cr.png]]<br />
<br />
Scroll down to the <code>Group Status</code> section. Click on the <code>+ Add New Release</code> button.<br />
<br />
[[File:anidb_addFile3.guide.png|i.imgur.com/KWs7Dmp.png]]<br />
<br />
This should bring up the mass add files page.<br />
<br />
[[File:anidb_AddFile4.guide.png|i.imgur.com/V9JfUW3.png]]<br />
<br />
Set the group, source, release date, quality, track, and language options.<br />
<br />
[[How_to_get_started_with_creqing|wiki/How_to_get_started_with_creqing]]<br />
<br />
Let's start with the group. Enter the group name and click on <code>Search</code>.<br />
<br />
[[File:anidb_AddFile5.guide.png|i.imgur.com/9lnDewj.png]]<br />
<br />
The group name should change and have a drop down menu. Be sure to select the correct group name, identified above in Part B. For the purposes of this tutorial, the correct group name is <code>Yuki Subs [YukinoAi]</code>.<br />
<br />
[[File:anidb_AddFile6.guide.png|i.imgur.com/d5pk8fe.png]]<br />
<br />
Change the template from manual to the most appropriate setting. <code>[Yuki] Log Horizon - 01 (BD 720p HEVC Dual-Audio AAC) [F8708ABE].mkv</code> is labeled as Dual-Audio so the <code>dual</code> template should be used. For most fansub releases with only a single japanese audio track and subtitles, the <code>fansub</code> template should be used instead.<br />
<br />
[[File:anidb_AddFile7.guide.png|i.imgur.com/1iOomzC.png]]<br />
<br />
Select source and quality of the file:<br />
<br />
{| class="wikitable"<br />
! Source<br />
! Quality<br />
|-<br />
| DVD/BD<br />
| very high<br />
|-<br />
| DTV<br />
| high<br />
|-<br />
| VHS<br />
| low<br />
|}<br />
<br />
If you happen to know any more information about the file, like if the CRC32 of the file matches the official source, enter it. When in doubt, leave that field unmodified. Audio and subtitle track information can usually be left alone alone because that information will be updated later when the meta-data dump uploaded to AniDB becomes associated with the file entry.<br />
<br />
At the very bottom, paste the ed2k link from and click on <code>Next</code>.<br />
<br />
[[File:anidb_AddFile8.png|i.imgur.com/kSgxaZ9.guide.png]]<br />
<br />
Make sure the episode number is correct. If you happen to know the date the file was first distributed, enter it in <code>dd.mm.yyyy</code> format. When the information looks correct, click on <code>Add Files</code>.<br />
<br />
[[File:anidb_AddFile9.guide.png|i.imgur.com/WPtxkqC.guide.png]]<br />
<br />
Success!<br />
<br />
[[File:anidb_AddFile10.guide.png|i.imgur.com/MCEXDgz.guide.png]]<br />
<br />
To verify the stub-entry exists, go back to the Anime page. In the <code>Group Status</code> Section, click on the expand button for the group.<br />
<br />
[[File:anidb_AddFile11.guide.png|i.imgur.com/TPvgDzm.guide.png]]<br />
<br />
This will populate the <code>Episodes</code> section with file entries for that group. In the image below, episode 1 of Log Horizon has 2 file entries for the selected group. The top entry has already had the meta-information filled in by Avdump2. The bottom entry is the stub that was just created.<br />
<br />
[[File:anidb_AddFile12.guide.png|i.imgur.com/Wf8zsGx.guide.png]]<br />
<br />
* Notice that the audio track, resolution and subtitle information was filled in by Avdump2 automatically for the top file where as this information is not yet correct for the bottom file.<br />
* Under the <code>Hash</code> column, there is an icon <code>AU</code> overlayed and a checkmark. This means a the file was verified by Avdump2.<br />
* The bottom file has <code>CRC</code> overlayed with a checkmark. That means the entry has been marked to indicate that the CRC for the file, matches the official one provided by the release group.<br />
* So the top file has not been marked as having a verified CRC and the bottom one has not had its metadata updated by Avdump2. Let's fix the metadata.<br />
<br />
Back in command prompt world...<br />
<br />
====Adding Dumps Using Avdump2 CLI====<br />
<br />
So, the idea is to use <code>Avdump2cl.exe</code> to send a metadata dump to the server. This can be done using the <code>--Authentication</code> flag, or <code>--Auth</code> for short. The auth flag instructs <code>Avdump2cl.exe</code> to attempt to authenticate with AniDB servers. If authentication fails, <code>Avdump2cl.exe</code> will print an error message and stop. If successful, <code>Avdump2cl.exe</code> will process the file and attempt to send the dump to AniDB servers.<br />
<br />
Note: Please note that all data sent to the server will be logged using IP and user id. If you would like to check what data will be submitted to the server after authentication, run the following command:<br /><br />
<code>Avdump2cl.exe -ca [file/folder]</code><br />
<br />
The auth flag has the following syntax:<br />
<br />
<code>Avdump2cl.exe --Auth:[username]:[api_key] [file/folder]</code><br />
<br />
<code>username</code> in the above command should be subtituted with your AniDB username. The <code>api_key</code> is the character string that was specified in the AniDB profile in Part A. Notice the colon <code>:</code> in between the <code>username</code> and <code>api_key</code>. If following this tutorial, it should be available at <code>C:\Users\User\anidb_apiKey.txt</code> or <code>C:\Users\User\Desktop\anidb_apiKey.txt</code>. Copy it and right-click paste it into the command prompt:<br />
<br />
[[File:Avdump2cl_auth1.guide.png|i.imgur.com/GfGPGUW.guide.png]]<br />
<br />
[[File:Avdump2cl_auth2.guide.png|i.imgur.com/KSSvMjP.guide.png]]<br />
<br />
Enter a space and then drag and drop the file to add to AniDB into the command prompt window as before:<br />
<br />
[[File:Avdump2cl_auth3.guide.png|i.imgur.com/LYSmR8t.guide.png]]<br />
<br />
The command below should be sufficent to submit the meta-data.<br />
<br />
[[File:Avdump2cl_auth4.guide.png|i.imgur.com/c0qq0hp.guide.png]]<br />
<br />
Press <code>Enter</code>. If it works, the following should appear after processing completes:<br />
<br />
[[File:Avdump2cl_submitVerify.guide.png|i.imgur.com/LIGgXjf.guide.png]]<br />
<br />
The line that says:<br /><br />
<code>ACReq( Done: 0 Todo: 1 Failed: 0 Pending: 0 )</code><br /><br />
Means that processing has finished and <code>Avdump2cl.exe</code> will attempt to upload the dump.<br />
<br />
The line that says:<br /><br />
<code>ACReq( Done: 1 Todo: 0 Failed: 0 Pending: 0)</code><br /><br />
Means the server has accepted the data from <code>Avdump2cl.exe</code> and will store it for later processing. '''Success!'''<br />
<br />
If you get an error like the following:<br /><br />
[[File:Avdump2cl_authFail1.guide.png|i.imgur.com/QAqGtbt.guide.png]]<br />
<br />
* Double check the API key is correct.<br />
* The API key being used should be exactly the same one that was entered in the user profile page.<br />
* UDP API keys should also be alphanumeric and no longer than 32-characters. Keys longer than 32 characters may get trunkated to 32.<br />
* Since UDP API keys are cached, changing API keys will take some time to clear, usually less than 30 minutes. Attempting to authenticate before that will result in the above error, even if using the correct key and syntax. So wait 30 minutes and try again basically.<br />
<br />
If you get an error like the following:<br />
<br />
[[File:Avdump2cl_authFail2.guide.png|i.imgur.com/oN118Ln.guide.png]]<br />
<br />
* Notice the error is from <code>ACReq.Authentication</code>. This indicates something to do with authentication caused the error.<br />
* In the above command, that is due to a syntax error in the <code>--Auth</code> switch. The correct syntax is <code>--Auth=username:api_key</code> but in the above command the <code>username</code> is missing.<br />
* Press the up arrow key to bring up the previous command in the command prompt window. Then fix the syntax and run the command again. It should then work.<br />
<br />
Assuming dump submission succeeds, the AniDB page for the file will likely show the following:<br />
<br />
[[File:anidb_AddFile12.guide.png|i.imgur.com/Wf8zsGx.guide.png]]<br />
<br />
In other words, while the correct meta-data has been submitted as part of a dump to AniDB, the information for that file has not changed.<br />
<br />
'''This is normal.''' There is a delay for certain submissions to AniDB. The next section contains more information about how change requests work but for now just know there is a delay and the information will be automatically updated later.<br />
<br />
For the file above, this is what the information looked like less than 24-hours later:<br />
<br />
[File:Avdump2cl_submitVerifyComplete.guide.png|i.imgur.com/nwrSeBV.guide.png]<br />
<br />
==== Automating Avdump2 CLI ====<br />
<br />
So far, we have added a single file entry and submitted the associated dump for processing. However, Log Horizon S1 has more than 1 episode. Updating each episode this way, by running <code>Avdump2cl.exe</code> twice, once to create the ed2k link and a second time to submit the dump data, would take an excessively long time. <code>Avdump2cl</code> supports combing different flags together into one command:<br />
<br />
<code>Avdump2cl.exe --Auth=[username]:[api_key] --Exp=[filename] [file/folder]</code><br />
<br />
If the above command syntax is used on a file, <code>Avdump2cl.exe</code> will authenticate with AniDB servers, then if successful, will process the file, submitting the meta-data to AniDB and then export the ed2k link to a file. This means we can run half the number of commands and still get the output needed to update AniDB!<br />
<br />
There is another thing to notice about that syntax. At the end, it says file/folder meaning that <code>Avdump2cl.exe</code> also supports specifying a folder instead of individual files. If a folder is specified, like say: <code>C:\Users\User\Downloads\Log Horizon</code> then <code>Avdump2cl.exe</code> will process every file inside of that folder, generating ed2k links for each file.<br />
<br />
With the above information, the actual command to run would be:<br /><br />
<code>Avdump2cl.exe --Auth=YukinoAi:uFEV55lknCwglqdRp1jte36NQ --Exp=Avdump2cl-ed2k-Links.txt &quot;C:\Users\User\Downloads\Log Horizon&quot;</code><br />
<br />
Notice that <code>C:\Users\User\Downloads\Log Horizon</code> needs quotation marks <code>&quot; &quot;</code> surrounding it because <code>Log Horizon</code> has a space. As long as there are no spaces, quotation marks do not have to be used. Without quotation marks, <code>Avdump2cl.exe</code> will treat and process all of the files in <code>C:\Users\User\Downloads\Log</code> and also all of the files inside the <code>Horizon</code> folder. Since neither of these folders exist, the commad will fail:<br />
<br />
[[File:Avdump2cl_syntaxFail1.guide.png|i.imgur.com/7wV8R5O.guide.png]]<br />
<br />
If using the drag and drop technique instead of copy-paste, quotation marks will automatically be added as appropriate.<br />
<br />
So, running the above command with proper quotation marks will work. The ed2k links generated in the text file can be added to AniDB using the Mass Add page as shown above. However, having to worry about syntax is cumbersome, as is starting a command prompt. Is there not a better way?<br />
<br />
An alternative approach is to create a shell script that will invoke <code>Avdump2cl.exe</code> with the correct syntax automatically. If anything bad happens, like authentication or syntax errors, it will be easy to solve because the correct syntax can just be copied from the text file back to a normal command prompt.<br />
<br />
Open notepad and copy-paste the following cryptic text into a file called <code>AniDBUpdate.bat</code> or just download it [here].<br />
<br />
<pre><br />
@echo off<br />
set username=putUsernameHere<br />
set api_key=putApiKeyHere<br />
set pathToAvdump2=C:\Users\User\Downloads\avdump-gui-2.3.2-portable\appdata\avdump-gui-2.3.2.win32<br />
<br />
set mode=auth<br />
::mode can be either exp or auth<br />
<br />
if /i &quot;%~1&quot; equ &quot;&quot; (goto usage)<br />
if /i &quot;%~1&quot; equ &quot;?&quot; (goto usage)<br />
if /i &quot;%~1&quot; equ &quot;/?&quot; (goto usage)<br />
if not exist &quot;%~1&quot; (echo.<br />
echo &quot;%~1&quot; does not exist<br />
goto usage)<br />
<br />
if not exist &quot;%pathToAvdump2%\Avdump2cl.exe&quot; (echo.<br />
echo &quot;%pathToAvdump2%\Avdump2cl.exe&quot; does not exist<br />
goto usage)<br />
if /i &quot;%username%&quot; equ &quot;putUsernameHere&quot; goto usage<br />
if /i &quot;%api_key%&quot; equ &quot;putApiKeyHere&quot; goto usage<br />
<br />
if /i &quot;%mode%&quot; equ &quot;exp&quot; &quot;%pathToAvdump2%\Avdump2cl.exe&quot; --Exp=&quot;%~dp1\ed2k-%~n1.%random%.txt&quot; &quot;%~1&quot; &quot;%~2&quot; &quot;%~3&quot; &quot;%~4&quot; &quot;%~5&quot; &quot;%~6&quot; &quot;%~7&quot; &quot;%~8&quot; &quot;%~9&quot;<br />
::if /i &quot;%mode%&quot; equ &quot;exp&quot; &quot;%pathToAvdump2%\Avdump2cl.exe&quot; --Exp=&quot;%userprofile%\Desktop\ed2k-Link-%~n1.%random%.txt&quot; &quot;%~1&quot; &quot;%~2&quot; &quot;%~3&quot; &quot;%~4&quot; &quot;%~5&quot; &quot;%~6&quot; &quot;%~7&quot; &quot;%~8&quot; &quot;%~9&quot;<br />
if /i &quot;%mode%&quot; equ &quot;auth&quot; &quot;%pathToAvdump2%\Avdump2cl.exe&quot; --Auth=&quot;%username%:%api_key%&quot; --Exp=&quot;%~dp1\ed2k-%~n1.%random%.txt&quot; &quot;%~1&quot; &quot;%~2&quot; &quot;%~3&quot; &quot;%~4&quot; &quot;%~5&quot; &quot;%~6&quot; &quot;%~7&quot; &quot;%~8&quot; &quot;%~9&quot;<br />
::if /i &quot;%mode%&quot; equ &quot;auth&quot; &quot;%pathToAvdump2%\Avdump2cl.exe&quot; --Auth=&quot;%username%:%api_key%&quot; --Exp=&quot;%userprofile%\Desktop\ed2k-Link-%~n1.%random%.txt&quot; &quot;%~1&quot; &quot;%~2&quot; &quot;%~3&quot; &quot;%~4&quot; &quot;%~5&quot; &quot;%~6&quot; &quot;%~7&quot; &quot;%~8&quot; &quot;%~9&quot;<br />
<br />
goto end<br />
:usage<br />
echo.<br />
echo OMG^! Hi^!^!^! Usage Help:<br />
echo.<br />
echo %~nx0 can be used to automate usage of Avdump2cl.exe<br />
echo Please update &quot;username&quot; and &quot;api_key&quot; before using %~nx0.<br />
echo. <br />
echo CLI Usage: <br />
echo %~nx0 &quot;C:\Users\User\Downloads\Log Horizon&quot;<br />
echo %~nx0 &quot;C:\Users\User\Downloads\Log Horizon\episode01.mkv&quot;<br />
echo.<br />
echo Drag and drop also works.<br />
echo.<br />
echo For &quot;right-click Send to&quot; functionality, copy a shortcut to:<br />
echo &quot;%appdata%\..\roaming\Microsoft\Windows\SendTo&quot;<br />
echo.<br />
pause<br />
<br />
:end<br />
<br />
</pre><br />
[[File:AniDBUpdate_1.guide.png|i.imgur.com/3glAjpw.guide.png]]<br />
<br />
The three highlighted items need to be changed before using the script. Update the username and API key appropriately. Make sure there are no trailing whitespaces in either the username or api_key. &quot;Name&quot; will work but &quot;Name &quot; will not. Example:<br />
<br />
[[File:AniDBUpdate_2.guide.png|i.imgur.com/OhfWiuG.guide.png]]<br />
<br />
For the pathToAvdump2 entry, the path should not include a trailing <code>\</code>.<br />
<br />
Example:<br />
<br />
* <code>C:\avdump-gui-2.3.2-portable</code> will work.<br />
* <code>C:\avdump-gui-2.3.2-portable\</code> will not work.<br />
<br />
After entering the username and the UDP API key, here are 3 ways to run the above text file:<br />
<br />
1) Hardest: Command prompt method: Navigate to the correct directory and type <code>AniDBUpdate.bat</code>.<br />
<br />
[[File:AniDBUpdate_cmd.guide.png|i.imgur.com/3N0Sg5f.guide.png]]<br />
<br />
2) Drag and drop method: Drag and drop a file or folder onto the batch file.<br />
<br />
[[File:AniDBUpdate_drag1.guide.png|i.imgur.com/eLFgKWf.guide.png]]<br />
<br /><br />
[[File:AniDBUpdate_drag2.guide.png|i.imgur.com/sxIleWJ.guide.png]]<br />
<br />
3) Easiest: Send-to method: Use the right-click <code>Send to</code> context menu.<br />
<br />
[[File:AniDBUpdate_drag1.guide.png|i.imgur.com/kuUEJsh.guide.png]]<br />
<br />
For the send-to method to work, the file, or a shortcut to it, must be placed at:<br /><br />
<code>C:\Users\Username\AppData\Roaming\Microsoft\Windows\SendTo</code><br /><br />
To open this folder automatically, paste the following into an explorer address bar or <code>Windows key + r</code><br /><br />
<code>&quot;%appdata%\..\roaming\Microsoft\Windows\SendTo&quot;</code><br />
<br />
# <code>Ctrl + c</code> to copy: <code>&quot;%appdata%\..\roaming\Microsoft\Windows\SendTo&quot;</code><br />
# <code>Windows key + r</code><br />
# <code>Ctrl + v</code> to Paste the above contents<br />
## [[File:AniDBUpdate_sendTo1.guide.png|i.imgur.com/Dw7Ckdc.guide.png]]<br />
# Press <code>Enter</code><br />
# Right-Click - create a new shortcut<br />
## [[File:AniDBUpdate_sendTo2.guide.png|i.imgur.com/VsyL3TV.guide.png]]<br />
# Move the shortcut from where it was created to <code>\SentTo</code>.<br />
## [[File:AniDBUpdate_sendTo3.guide.png|i.imgur.com/iUQCorO.guide.png]]<br />
# Rename the shortcut appropriately.<br />
<br />
With the command prompt and send-to methods:<br />
<br />
* Up to 9 discrete files and folders may be selected<br />
* When sending a folder, all files within that folder and all subfolders will be processed.<br />
<br />
===Avdump2 GUI===<br />
<br />
Avdump2gui.exe is the graphical user interface (GUI) wrapper for <code>Avdump2cl.exe</code> and supports a subset of the features:<br />
<br />
Avdump2 GUI Limitations. The GUI:<br />
<br />
* always requires authenticating.<br />
* will not generate links without specifying a valid username and valid API key pair, every time.<br />
** Note: This information is forcibly saved across instances.<br />
* must be deliberately started every time to be used.<br />
* will not issue an error message when authentication fails and simply not respond.<br />
** If the GUI does not respond, it is advisable to test for authentication errors using <code>Avdump2CL.exe</code>.<br />
* requires updating prior to usage.<br />
<br />
With these limitations in mind. Launch Avdump2gui to have it update automatically.<br />
<br />
# Specify the username and api-key.<br />
# Use the <code>Files</code> and <code>Folder</code> buttons too add files to process.<br />
## [[File:Avdump2gui_1.guide.png|i.imgur.com/3ypUEcP.guide.png]]<br />
# When complete, click start to see what happens.<br />
## If/When nothing happens check for authentication errors using <code>Avdump2CL.exe</code> using the instructions provided above.<br />
# If it works, nothing will happen for a while, and then eventually ed2k links will appear in the ed2k export window. The dump data should have been submitted to AniDB in the background, although there is no way to check.<br />
## [[File:Avdump2gui_2.guide.png|i.imgur.com/r52bp7D.guide.png]]<br />
<br />
The ed2k links in the export window can now be submitted to AniDB. Detailed instructions for this are provided above.<br />
<br />
== Understanding AniDB Change Requests (creqs) ==<br />
<br />
:{{Missing}}<br />
<br />
AniDB is a user-driven database. A normal way to contribute is to issue change requests (creqs for short), which means that a moderator has to approve suggested changes before they are published. Request links can usually be found on every page that has editable content for logged in users.<br />
<br />
* Except for obvious changes, always describe the reason for changes in the request and/or the source of the information.<br />
* Be prepared to follow up the requests made. Creqs will be denied if there is no response to moderator questions.<br />
<br />
More info:<br /><br />
[[How_to_update_or_correct_existing_entries|wiki/How_to_update_or_correct_existing_entries]]<br/><br />
[[How_to_get_started_with_creqing|wiki/How_to_get_started_with_creqing]]<br />
<br />
Avdump2, used above, is AniDB's mechanism to submit automatic change requests (acreqs or auto-creq). These automatic change requests do not always require moderator approval because the information (file-metadata) has been verified programmatically. For auto-creqing:<br />
<br />
* All data sent to the server will be logged with IP and user id.<br />
* There is no direct connection between data sent to AniDB and creqs generated. The data dumps will just be stored for later processing into creqs.<br />
* There is no way to check the current status for a dump.<br />
* Avdump2cl.exe will display a count of the files that have been submitted to the server as output as <code>ACReq ( Done: # [...]</code>, but that is all.<br />
* Usually, it should take at least 24 hours from the moment a file metadata dump has been submited untill the file data actually changes. If any irregularities occur, or when there is too much data pending, it will take more time. The system auto-creqs to add missing tracks within 72 hours.<br />
* It is possible to dump files currently not in the database. The data is still stored and will be used later if/after the file has been registered.<br />
<br />
In other words, when Avdump2 submits meta-data dumps to AniDB, the data itself may get processed into a change request. But first, in order to automatically apply the dumped metadata information to a file, that file must be registered first. The process of submitting ed2k links is that registration process. The metadata dumps themselves also contain the ed2k hash information that serves as the basis to link it to registered files.<br />
<br />
To learn more about creqs please check out:<br />
<br />
"Adding Data" subsection on [[Main_Page|wiki/Main_Page]]<br />
<br />
For further help with a problem or just for chatting visit IRC:<br />
<br />
Wiki page for IRC: [[IRC:anidb|wiki/IRC:anidb]]<br /><br />
Channel Address: irc://irc.synirc.net/anidb</div>YukinoAihttps://wiki.anidb.net/index.php?title=User:YukinoAi&diff=22931User:YukinoAi2017-08-16T04:59:23Z<p>YukinoAi: </p>
<hr />
<div>OMG! Hi!!!<br />
<br/><br/><br />
Markdown converter -Has both CLI and web interface: https://pandoc.org and https://pandoc.org/getting-started.html<br />
<br/><br/><br />
Formatting Reference:<br/><br />
https://www.mediawiki.org/wiki/Help:Starting_a_new_page<br/><br />
https://www.mediawiki.org/wiki/Help:Formatting<br/><br />
https://www.mediawiki.org/wiki/Help:Lists<br/><br />
https://www.mediawiki.org/wiki/Help:Links<br/><br />
https://meta.wikimedia.org/wiki/Help:Piped_link<br/><br />
https://www.mediawiki.org/wiki/Help:Images<br/><br />
https://www.mediawiki.org/wiki/Manual:$wgAllowExternalImages (so external images are not allowed basically)<br/><br />
https://www.mediawiki.org/wiki/Manual:Linked_images<br/><br />
https://www.mediawiki.org/wiki/Help:Tables<br/><br />
<br/><br />
Scratchpads:<br />
<br/><br />
[[User:YukinoAi/Tutorial_Scratchpad]]</div>YukinoAihttps://wiki.anidb.net/index.php?title=User:YukinoAi&diff=22930User:YukinoAi2017-08-16T04:58:35Z<p>YukinoAi: </p>
<hr />
<div>OMG! Hi!!!<br />
<br />
Markdown converter -Has both CLI and web interface: https://pandoc.org and https://pandoc.org/getting-started.html<br />
<br />
Formatting Reference:<br />
https://www.mediawiki.org/wiki/Help:Starting_a_new_page<br />
https://www.mediawiki.org/wiki/Help:Formatting<br />
https://www.mediawiki.org/wiki/Help:Lists<br />
https://www.mediawiki.org/wiki/Help:Links<br />
https://meta.wikimedia.org/wiki/Help:Piped_link<br />
https://www.mediawiki.org/wiki/Help:Images<br />
https://www.mediawiki.org/wiki/Manual:$wgAllowExternalImages (so external images are not allowed basically)<br />
https://www.mediawiki.org/wiki/Manual:Linked_images<br />
https://www.mediawiki.org/wiki/Help:Tables<br />
<br />
<br />
Scratchpads:<br />
<br />
[[User:YukinoAi/Tutorial_Scratchpad]]</div>YukinoAihttps://wiki.anidb.net/index.php?title=User:YukinoAi/Tutorial_Scratchpad&diff=22929User:YukinoAi/Tutorial Scratchpad2017-08-16T04:50:36Z<p>YukinoAi: fixed most formatting stuffs</p>
<hr />
<div>[//anidb.net Anime DataBase (AniDB)] is a website that provides information about Anime.<br />
<br />
It keeps track of [//anidb.net/perl-bin/animedb.pl?show=anime&aid=109 show information] and fansub releases for them. It has some [//anidb.net/perl-bin/animedb.pl?show=forum social aspects] as well. [[AniDB:About|More info]]. Databases are only useful if they are updated frequently, so this tutorial is about keeping fansub releases on AniDB up to date.<br />
<br />
{{eyecatch|Note|This guide has a lot of theory to help explain how to interface with AniDB. For a more concise guide, please consider: [[Tutorial:How to Add Files for Dummies!]]}}<br />
<br />
==Introduction==<br />
<br />
AniDB needs to know 3 things to create a full entry for a release:<br />
<br />
# Which group (or user) released the file.<br />
# The unique hash of the file and file name.<br />
# The file metadata (resolution, audio tracks, subtitles, etc).<br />
<br />
The [[Avdump2]] utility can be used to automatically update AniDB file entries and will be used later.<br />
<br />
* The release group should be associated with each file when creating an entry for it. <br />
** Non-offical, or files that are not distributed, should not be added. <br />
** Release group examples: Horrible Subs, Kametsu, and Doki.<br />
* Before creating an entry for a file, the unique ed2k hash must first be calculated because the ed2k hash will be used in identifying the file.<br />
* The ed2k hash for the unique identifier can be generated by using [[Avdump2]], or any other program that can generate ed2k hashes.<br />
* The file's metadata should be updated using the Avdump2 tool.<br />
<br />
And so, it is convenient to use the Avdump2 tool to both generate the unique identifier and also update file metadata.<br />
<br />
'''Additional Resources:'''<br /><br />
[[Main_Page|wiki/Main_Page]]<br /><br />
[[Auto-creqing|wiki/Auto-creqing]]<br /><br />
[[Avdump2|wiki/Avdump2]]<br />
<br />
== Prerequisites ==<br />
<br />
# Obtain a file to add to AniDB.<br />
## The group name is usually present in the file name or description.<br />
# [//anidb.net/perl-bin/animedb.pl?show=signup Create an AniDB account].<br />
# [//anidb.net/perl-bin/animedb.pl?show=login Login] and verify that account.<br />
<br />
== Creating an API Key ==<br />
<br />
===Theory===<br />
<br />
At some point, meta-information for files should be submited using Avdump2. That meta-information is initially associated with the user account that made the submission. While users normally enter usernames/passwords for authentication, Avdump2 needs a unique string of characters to update meta-data. In this context, the string of characters that authenticates a user utilizing Avdump2 is known as an <code>API Key</code> or a <code>UDP API Key.</code><br />
<br />
UDP API keys can be specified in the user profile section on AniDB.net.<br />
<br />
===Procedure===<br />
<br />
[//anidb.net/perl-bin/animedb.pl?show=login Log in to AniDB]<br /><br />
On the left navigation pane, at the bottom is a section labeled <code>Account</code>. Click on <code>Settings</code>.<br />
<br />
[[File:anidb_account_settings_highlight.guide.png|i.imgur.com/fEqwtnZ.png]]<br />
<br />
Under profile, in the main navigation window, there are tabs. Click on the one that says <code>Account</code> (highlighted for emphasis). <br />
<br />
[[File:anidb_accountSettings_AccountTab_highlight.guide.png|i.imgur.com/maGR6jL.png]]<br />
<br />
There should be a section called <code>UDP API Key</code> with two fields, one with a label and another empty one.<br />
<br />
[[File:anidb_account_udpApiKey_empty.guide.png|i.imgur.com/j9B4eSr.png]]<br />
<br />
Any alphanumeric (a-z, A-Z, 0-9) character sequence no longer than 32 characters will work for the API key. For the purposes of this tutorial GRC's [//www.grc.com/passwords.htm Perfect Passwords] will be used.<br />
<br />
Open a new tab in the web browser and go to GRC's [//www.grc.com/passwords.htm Perfect Passwords] page.<br />
<br />
In the last box of characters labeled <code>a-z, A-Z, 0-9</code>, highlight 20-30 characters as shown below.<br />
<br />
[[File:grc_pp_20charas_highlight.guide.png|border|i.imgur.com/Z3D68ca.guide.png|]]<br />
<br />
Then copy the selected characters to the clipboard.<br />
<br />
* Right-Click - Copy<br />
* <code>Ctrl + c</code><br />
<br />
[[File:grc_pp_20characters_copy.guide.png|border|i.imgur.com/3qlV9iu.guide.png]]<br />
<br />
Change tabs back to AniDB's page.<br />
<br />
In the empty field under the <code>UDP API Key</code>, right-click and select <code>Paste</code>. Alternatively: <code>Ctrl + v</code>.<br /><br />
[[File:anidb_account_udpAPIKey_paste.guide.png|i.imgur.com/3V61Mo2.guide.png]]<br />
<br />
[[File:anidb_account_udpAPIKey_inserted.guide.png|i.imgur.com/q5yZPHa.guide.png]]<br />
<br />
Click on the <code>Apply</code> button at the bottom. It should be right above <code>Back</code>.<br /><br />
[[File:anidb_account_udpAPIKey_apply.guide.png|i.imgur.com/6761Qg3.guide.png]]<br /><br />
The <code>UDP API Key</code> field should turn into asterisks (*) to show that it has saved it properly.<br /><br />
[[File:anidb_account_udpAPIKey_asterisks.guide.png|i.imgur.com/l9OzPgu.guide.png]]<br /><br />
The API key should also be saved for use with Avdump2 later on, so lets save it to notepad.<br />
<br />
<code>Windows key</code> or Click on the start menu and type in <code>notepad</code>.<br />
<br />
[[File:windowskey_notepad.guide.png|i.imgur.com/SVi1A65.guide.png|]]<br />
<br />
[[File:notepad_apiKey_paste.guide.png|i.imgur.com/juAtU1M.guide.png]]<br />
<br />
Save the file as something descriptive or as <code>anidb_apiKey.txt</code> in your user profile folder (<code>C:\Users\User</code>) or desktop (<code>C:\Users\User\Desktop</code>).<br />
<br />
* <code>File</code> - <code>Save As...</code><br />
* <code>Ctrl + s</code><br />
<br />
Changes to the API key are updated immediately server-side but old entries are cached for an unspecified amount of time, usually less than 30 minutes. Attempting to use the new key before the old key has been removed from the cache will produce this error in the <code>Avdump2cl.exe</code>:<br />
<br />
[[File:Avdump2cl_apiKey_timeout.guide.png|i.imgur.com/SAZIZt8.guide.png]]<br />
<br />
The Avdump2 GUI will simply not respond when authentication fails. More on this later.<br />
<br />
== Dealing With Groups ==<br />
<br />
===Theory===<br />
Every file entry should be associated with a release group. The group name or tag is usually in the file name, usually in brackets <code>[ ]</code>. It is important to identify the release group and to verify the group already exists in AniDB.<br />
<br />
Examples:<br />
<br />
{| class="wikitable"<br />
!width="15%"| Filename<br />
!width="5%"| Group Name or [Tag]<br />
|-<br />
| [Yuki] Log Horizon - 01 (BD 1080p HEVC Dual-Audio AAC) [2D099D6D].mkv<br />
| Yuki<br />
|-<br />
| Log Horizon - 01 (1080p) BD x265 10-bit (DualAudio) AC3 AAC [KoTuWa].mkv<br />
| KoTuWa<br />
|-<br />
| [ReinForce] Log Horizon - 01 (BDRip 1920x1080 x264 FLAC).mkv<br />
| ReinForce<br />
|-<br />
| [JacobSwaggedUp] Log Horizon - 01 (BD 1280x720).mp4<br />
| JacobSwaggedUp<br />
|-<br />
| Log.Horizon.S01E01.720p-Hi10p.BluRay.AAC2.0-CTR.[B73B6592].mkv<br />
| CTR<br />
|-<br />
| {AnimeServ.NET} Log Horizon 01 (Blu-ray)(1920x1080 x264 AAC).mp4<br />
| AnimeServ.Net<br />
|-<br />
| [RHxUHA-WING]Log_Horizon_S1[01][BIG5][720P].mp4<br />
| RHxUHA-WING<br />
|-<br />
| [BDMV][150724] Log Horizon - Vol.1<br />
| n/a<br />
|-<br />
| (Shin-Raw) Log Horizon 01 720p (HEVC-HEAAC) [7F99A1E7].mp4<br />
| Shin-Raw<br />
|}<br />
<br />
For Anime, most groups put their names in brackets <code>[ ]</code> but not always. Group names like DVDISO, RawDVD, BDMV, Anime BD, RAW, R2RAW are keywords that indicate a group is not associated with the upload, usually for uploading unmodified content.<br />
<br />
When there is a <code>-</code> or <code>&amp;</code> in the group name, that sometimes means it is a joint release between 2 or more groups. Joint releases are also known as &quot;virtual&quot; releases in AniDB terminology.<br />
<br />
In an example above, RHxUHA-WING may be a single group's name or it may be 2 different groups, RHxUHA and WING. Read the description in the download page to find out or search AniDB.<br />
<br />
Verify the group exists by searching for it on AniDB.<br />
<br />
===Procedure===<br />
<br />
Open [//anidb.net Anime DataBase (AniDB)].<br />
<br />
At the top right next to <code>Search</code> change the search type from <code>all</code> to <code>group</code>.<br />
<br />
[[File:anidb_search_group1.guide.png|i.imgur.com/4U31JYW.guide.png]]<br />
<br />
Enter the group name found in the filename and click on <code>Search</code>. In the example below, <code>Doki</code> is used as an example of a group (highlighted for emphasis).<br />
<br />
[[File:anidb_search_group2.guide.png|i.imgur.com/XIR5058.png]]<br />
<br />
Click on the group name in the <code>Name</code> column. In the below example it would be <code>Doki Fansubs</code>.<br />
<br />
[[File:anidb_search_group3.guide.png|700px|i.imgur.com/aJudr9s.png]]<br />
<br />
Only if the group does not exist, [//anidb.net/perl-bin/animedb.pl?show=addgroup create it]. Before actually adding a group, read [[Content:Groups|this]] and [[Which_raw_groups_to_credit|this]].<br />
<br />
For the purposes of this tutorial, it will be assumed the group name already exists.<br />
<br />
== On Using Avdump2 ==<br />
<br />
===Theory===<br />
<br />
* A file entry in AniDB has 2 main components, the entry itself and the associated metadata.<br />
* AniDB stores metadata information for files that are not yet in the database. This means it is possible to add a file entry and then add the metadata, or alternatively, add the metadata to AniDB and create the file entry later.<br />
* The metadata and the file entry are normally linked using a unique identifier created from the [[Ed2k-hash]] and the filesize.<br />
<br />
Thus, to create a file entry in AniDB, the ed2k hash must be known and the group name should be known.<br />
<br />
The main purpose of the [[Avdump2]] utility, and its [[Avdump_GUI|GUI wrapper]], is to automate updating AniDB file entries. It does 3 things:<br />
<br />
# Hash files to identify them (ed2k).<br />
# Extract Audio/Video/Subtitle and other media information.<br />
# Send that information to the server.<br />
<br />
Together, the hash information and the media information are called a &quot;dump,&quot; short for metadata dump or file dump.<br />
<br />
This tutorial will cover creating files associated with a release on AniDB using their ed2k identifier also submitting dumps.<br />
<br />
===Installation===<br />
<br />
:{{Missing}}<br />
<br />
[[Avdump_GUI|Download the portable GUI version]], [//static.anidb.net/client/avdump-gui-2.3.2-portable.7z direct], (it has both the CLI and GUI) and [//www.7-zip.org/download.html extract it] to <code>C:\Users\User\Downloads</code>. See this random [http://www.gofree.com/Tutorials/ExtractingZipFiles.php 7-Zip Tutorial]. Alternative [//static.anidb.net/client/avdump-gui.msi MSI installer].<br />
<br />
For the purposes of this tutorial, it will be assumed the CLI tool is at:<br /><br />
<code>C:\Users\User\Downloads\avdump-gui-2.3.2-portable\appdata\avdump-gui-2.3.2.win32\Avdump2CL.exe</code><br /><br />
And the GUI tool is available at:<br /><br />
<code>C:\Users\User\Downloads\avdump-gui-2.3.2-portable\Avdump2gui.exe</code><br />
<br />
* <code>Avdump2CL.exe</code> is a non-interactive program with a command line interface (CLI).<br />
** It can export ed2k links that can be used to create file entries on AniDB using the <code>--ExportEd2kLinks</code> flag (short form: <code>--Exp</code>).<br />
** it can also submit metadata dumps for processing. This is done using the <code>--Authentication</code> flag (short form: <code>--Auth</code>) with a Username/UDP API key pair.<br />
* <code>Avdump2gui.exe</code> is a graphical user interface (GUI) wrapper around the CLI with a subset of the CLI's functionality.<br />
* <code>Avdump2gui.exe</code> must be used with an API key at all times.<br />
<br />
To calculate and export the identifier information, including the ed2k hash, use either the Avdump2 CLI or GUI.<br />
<br />
=== Avdump2 CLI ===<br />
<br />
==== Command Prompt Introduction ====<br />
<br />
[[Avdump2|wiki/Avdump2]]<br />
<br />
Start a command prompt:<br />
<br />
* <code>Windows + r</code> - Type <code>cmd.exe</code> and press <code>Enter</code>.<br />
* Or<br />
* <code>Windows key</code> - Type <code>cmd.exe</code> and press <code>Enter</code>.<br />
<br />
[[File:windowskey_cmd.guide.png|i.imgur.com/zV1Hyk3.guide.png]]<br />
<br />
[[File:cmd_empty.guide.png|i.imgur.com/A3nbNdc.guide.png]]<br />
<br />
Let's change the current path to <code>C:\Users\User\Downloads\avdump-gui-2.3.2-portable\appdata\avdump-gui-2.3.2.win32</code> using <code>cd</code> or <code>pushd</code>.<br />
<br />
<code>pushd C:\Users\User\Downloads\avdump-gui-2.3.2-portable\appdata\avdump-gui-2.3.2.win32</code><br />
<br />
Or:<br />
<br />
Open an explorer window to: <code>C:\Users\User\Downloads\avdump-gui-2.3.2-portable\appdata\avdump-gui-2.3.2.win32</code> and drag and drop the folder icon on the top left of the address bar to the command prompt window.<br />
<br />
[[File:cmd_drag_folder.guide.png|i.imgur.com/lZGLh8B.guide.png]]<br />
<br />
This will populate the command prompt window with the path to the folder automatically, as shown below. This technique can also be used for individual files.<br />
<br />
[[File:cmd_drag_folder2.guide.png|i.imgur.com/iAZgyIy.guide.png]]<br />
<br />
With the command prompt window selected, press the <code>Home</code> key or hold the <code>Left Arrow</code> on the keyboard to change the cursor to the position furthest to the left.<br />
<br />
[[File:cmd_drag_folder3.guide.png|i.imgur.com/S91EYIk.guide.png]]<br />
<br />
Enter <code>cd</code> and a single space.<br />
<br />
[[File:cmd_drag_folder4.guide.png|i.imgur.com/5rF1tmX.guide.png]]<br />
<br />
Press <code>Enter</code>.<br />
<br />
[[File:cmd_drag_folder5.guide.png|i.imgur.com/OsNtdKK.guide.png]]<br />
<br />
The <code>cd</code> stands for <code>current directory</code> and using it has changed the current directory of the command prompt window to the extracted path of <code>Avdump2CL.exe</code>.<br />
<br />
It is possible to verify <code>Avdump2CL.exe</code> is in the current directory by listing the directory contents or checking to see if the file itself is present. List the direct contents using <code>dir</code>, or, for Linux, <code>ls</code>.<br />
<br />
[[File:cmd_drag_folder6.guide.png|i.imgur.com/uLa3xKM.guide.png]]<br />
<br />
Or check for the executable directly by typing the first few characters <code>av</code> and using <code>Tab</code> to cycle through the available options.<br />
<br />
[[File:Avdump2cl_help.guide.png|i.imgur.com/jUOqCpk.guide.png]]<br />
<br />
Running <code>Avdump2CL.exe</code> without any options will list many available options.<br />
<br />
Running <code>Avdump2CL.exe --help</code> will list all of the available options.<br />
<br />
[[File:Avdump2cl_help2.guide.png|i.imgur.com/fAgurLa.guide.png]]<br />
<br />
====Generating ed2k Links Using Avdump2 CLI====<br />
<br />
The syntax of <code>Avdump2CL.exe</code> is:<br />
<br />
<code>Avdump2CL.exe [--options] [file/folder] [file/folder]</code><br />
<br />
This means that <code>Avdump2CL.exe</code> takes some options and also one or more file or folder paths. The options will specify the type of processing and what file or folder to process.<br />
<br />
For the purproses of this tutorial, there is a file named:<br /><br />
<code>[Yuki] Log Horizon - 01 (BD 720p HEVC Dual-Audio AAC) [F8708ABE].mkv</code><br /><br />
And this file has been placed in:<br /><br />
<code>C:\Users\User\Downloads\Log Horizon</code><br />
<br />
To check what happens when a file or folder is specified but with no processing options, enter `Avdump2cl.exe', and then a space and then drag a file to the command prompt window.<br />
<br />
[[File:Avdump2cl_dragTest1.guide.png|i.imgur.com/5vhdUg4.guide.png]]<br />
<br />
The file name with the full path will be automatically populated in the command prompt window.<br />
<br />
[[File:Avdump2cl_dragTest2.guide.png|i.imgur.com/NiAdL0h.png]]<br />
<br />
Press <code>Enter</code>.<br />
<br />
[[File:Avdump2cl_dragTest3.guide.png|i.imgur.com/8ShIUUC.png]]<br />
<br />
So Avdump2cl.exe complains that no processing options has been specified, so there is nothing to do. So let's give it something to do.<br />
<br />
We are trying to use this program to extract ed2k hash information to create a new release on AniDB. That is done using the <code>--ExportEd2kLinks</code> option, or <code>--Exp</code> for short.<br />
<br />
The syntax is: <code>Avdump2cl.exe --Exp=[ed2kFileName] [file/folder]</code><br />
<br />
When running the actual command, the <code>file/folder</code> section should be substituted for the actual file or folder name as in the previous command. <code>ed2kFileName</code> should be substituted for a text file name, like <code>ed2k.txt</code>. An example of these substitutions is shown below.<br />
<br />
Let's run the command and see what happens.<br />
<br />
* [[File:Avdump2cl_exportTest1.guide.png|i.imgur.com/Ln9BUxg.png]]<br />
<br/><br/><br />
* [[File:Avdump2cl_exportTest2.png|i.imgur.com/PbQTZIE.png]]<br />
<br />
<code>Avdump2cl.exe</code> seems to have processed the file and created a text file called <code>ed2k.txt</code> in its current directory. The file contains one line of contents:<br />
<br/><br/><br />
<code>ed2k://|file|[Yuki] Log Horizon - 01 (BD 720p HEVC Dual-Audio AAC) [F8708ABE].mkv|484345397|C33743B735BF1B282B185E1B2E611270|/</code><br />
<br/><br/><br />
This is what the ed2k links used by AniDB look like. After the protocol specifier (<code>ed2k://</code>), is the <code>file</code> keyword, the filename, the file size, and then finally the ed2k hash.<br />
<br />
The file size <code>484345397</code> is in raw bytes. <code>484345397</code> divided by <code>1024</code> is <code>472,993.55</code> which is the size shown in explorer:<br />
<br />
[[File:Avdump2cl_exportTest3.guide.png|i.imgur.com/2iSZvNI.png]]<br />
<br />
<code>C33743B735BF1B282B185E1B2E611270</code> happens to be the ed2k hash of this specific file. Every file will have a different ed2k hash.<br />
<br />
Let's inform AniDB that this file exists using the ed2k link.<br />
<br />
====Adding File Entries to AniDB====<br />
<br />
[[Mass_add:Files|wiki/Mass_add:Files]]<br />
<br />
Open a web browser and login to [//anidb.net anidb.net] .<br />
<br />
Go to the entry of the Anime in AniDB you want to add a release for. This can be done by using the search feature.<br />
<br />
At the top right, enter the name of the Anime. For the purposes of this tutorial the series name is <code>Log Horizon</code>. Change the content type to <code>anime</code> and then click on <code>Search</code>.<br />
<br />
[[File:anidb_addFile1.guide.png|i.imgur.com/Wk4zyUT.png]]<br />
<br />
Log Horizon has multiple seasons, so each of them are displayed. Click on the correct season.<br />
<br />
[[File:anidb_addFile2.guide.png|i.imgur.com/uoH02cr.png]]<br />
<br />
Scroll down to the <code>Group Status</code> section. Click on the <code>+ Add New Release</code> button.<br />
<br />
[[File:anidb_addFile3.guide.png|i.imgur.com/KWs7Dmp.png]]<br />
<br />
This should bring up the mass add files page.<br />
<br />
[[File:anidb_AddFile4.guide.png|i.imgur.com/V9JfUW3.png]]<br />
<br />
Set the group, source, release date, quality, track, and language options.<br />
<br />
[[How_to_get_started_with_creqing|wiki/How_to_get_started_with_creqing]]<br />
<br />
Let's start with the group. Enter the group name and click on <code>Search</code>.<br />
<br />
[[File:anidb_AddFile5.guide.png|i.imgur.com/9lnDewj.png]]<br />
<br />
The group name should change and have a drop down menu. Be sure to select the correct group name, identified above in Part B. For the purposes of this tutorial, the correct group name is <code>Yuki Subs [YukinoAi]</code>.<br />
<br />
[[File:anidb_AddFile6.guide.png|i.imgur.com/d5pk8fe.png]]<br />
<br />
Change the template from manual to the most appropriate setting. <code>[Yuki] Log Horizon - 01 (BD 720p HEVC Dual-Audio AAC) [F8708ABE].mkv</code> is labeled as Dual-Audio so the <code>dual</code> template should be used. For most fansub releases with only a single japanese audio track and subtitles, the <code>fansub</code> template should be used instead.<br />
<br />
[[File:anidb_AddFile7.guide.png|i.imgur.com/1iOomzC.png]]<br />
<br />
Select source and quality of the file:<br />
<br />
{| class="wikitable"<br />
! Source<br />
! Quality<br />
|-<br />
| DVD/BD<br />
| very high<br />
|-<br />
| DTV<br />
| high<br />
|-<br />
| VHS<br />
| low<br />
|}<br />
<br />
If you happen to know any more information about the file, like if the CRC32 of the file matches the official source, enter it. When in doubt, leave that field unmodified. Audio and subtitle track information can usually be left alone alone because that information will be updated later when the meta-data dump uploaded to AniDB becomes associated with the file entry.<br />
<br />
At the very bottom, paste the ed2k link from and click on <code>Next</code>.<br />
<br />
[[File:anidb_AddFile8.png|i.imgur.com/kSgxaZ9.guide.png]]<br />
<br />
Make sure the episode number is correct. If you happen to know the date the file was first distributed, enter it in <code>dd.mm.yyyy</code> format. When the information looks correct, click on <code>Add Files</code>.<br />
<br />
[[File:anidb_AddFile9.guide.png|i.imgur.com/WPtxkqC.guide.png]]<br />
<br />
Success!<br />
<br />
[[File:anidb_AddFile10.guide.png|i.imgur.com/MCEXDgz.guide.png]]<br />
<br />
To verify the stub-entry exists, go back to the Anime page. In the <code>Group Status</code> Section, click on the expand button for the group.<br />
<br />
[[File:anidb_AddFile11.guide.png|i.imgur.com/TPvgDzm.guide.png]]<br />
<br />
This will populate the <code>Episodes</code> section with file entries for that group. In the image below, episode 1 of Log Horizon has 2 file entries for the selected group. The top entry has already had the meta-information filled in by Avdump2. The bottom entry is the stub that was just created.<br />
<br />
[[File:anidb_AddFile12.guide.png|i.imgur.com/Wf8zsGx.guide.png]]<br />
<br />
* Notice that the audio track, resolution and subtitle information was filled in by Avdump2 automatically for the top file where as this information is not yet correct for the bottom file.<br />
* Under the <code>Hash</code> column, there is an icon <code>AU</code> overlayed and a checkmark. This means a the file was verified by Avdump2.<br />
* The bottom file has <code>CRC</code> overlayed with a checkmark. That means the entry has been marked to indicate that the CRC for the file, matches the official one provided by the release group.<br />
* So the top file has not been marked as having a verified CRC and the bottom one has not had its metadata updated by Avdump2. Let's fix the metadata.<br />
<br />
Back in command prompt world...<br />
<br />
====Adding Dumps Using Avdump2 CLI====<br />
<br />
So, the idea is to use <code>Avdump2cl.exe</code> to send a metadata dump to the server. This can be done using the <code>--Authentication</code> flag, or <code>--Auth</code> for short. The auth flag instructs <code>Avdump2cl.exe</code> to attempt to authenticate with AniDB servers. If authentication fails, <code>Avdump2cl.exe</code> will print an error message and stop. If successful, <code>Avdump2cl.exe</code> will process the file and attempt to send the dump to AniDB servers.<br />
<br />
Note: Please note that all data sent to the server will be logged using IP and user id. If you would like to check what data will be submitted to the server after authentication, run the following command:<br /><br />
<code>Avdump2cl.exe -ca [file/folder]</code><br />
<br />
The auth flag has the following syntax:<br />
<br />
<code>Avdump2cl.exe --Auth:[username]:[api_key] [file/folder]</code><br />
<br />
<code>username</code> in the above command should be subtituted with your AniDB username. The <code>api_key</code> is the character string that was specified in the AniDB profile in Part A. Notice the colon <code>:</code> in between the <code>username</code> and <code>api_key</code>. If following this tutorial, it should be available at <code>C:\Users\User\anidb_apiKey.txt</code> or <code>C:\Users\User\Desktop\anidb_apiKey.txt</code>. Copy it and right-click paste it into the command prompt:<br />
<br />
[[File:Avdump2cl_auth1.guide.png|i.imgur.com/GfGPGUW.guide.png]]<br />
<br />
[[File:Avdump2cl_auth2.guide.png|i.imgur.com/KSSvMjP.guide.png]]<br />
<br />
Enter a space and then drag and drop the file to add to AniDB into the command prompt window as before:<br />
<br />
[[File:Avdump2cl_auth3.guide.png|i.imgur.com/LYSmR8t.guide.png]]<br />
<br />
The command below should be sufficent to submit the meta-data.<br />
<br />
[[File:Avdump2cl_auth4.guide.png|i.imgur.com/c0qq0hp.guide.png]]<br />
<br />
Press <code>Enter</code>. If it works, the following should appear after processing completes:<br />
<br />
[[File:Avdump2cl_submitVerify.guide.png|i.imgur.com/LIGgXjf.guide.png]]<br />
<br />
The line that says:<br /><br />
<code>ACReq( Done: 0 Todo: 1 Failed: 0 Pending: 0 )</code><br /><br />
Means that processing has finished and <code>Avdump2cl.exe</code> will attempt to upload the dump.<br />
<br />
The line that says:<br /><br />
<code>ACReq( Done: 1 Todo: 0 Failed: 0 Pending: 0)</code><br /><br />
Means the server has accepted the data from <code>Avdump2cl.exe</code> and will store it for later processing. '''Success!'''<br />
<br />
If you get an error like the following:<br /><br />
[[File:Avdump2cl_authFail1.guide.png|i.imgur.com/QAqGtbt.guide.png]]<br />
<br />
* Double check the API key is correct.<br />
* The API key being used should be exactly the same one that was entered in the user profile page.<br />
* UDP API keys should also be alphanumeric and no longer than 32-characters. Keys longer than 32 characters may get trunkated to 32.<br />
* Since UDP API keys are cached, changing API keys will take some time to clear, usually less than 30 minutes. Attempting to authenticate before that will result in the above error, even if using the correct key and syntax. So wait 30 minutes and try again basically.<br />
<br />
If you get an error like the following:<br />
<br />
[[File:Avdump2cl_authFail2.guide.png|i.imgur.com/oN118Ln.guide.png]]<br />
<br />
* Notice the error is from <code>ACReq.Authentication</code>. This indicates something to do with authentication caused the error.<br />
* In the above command, that is due to a syntax error in the <code>--Auth</code> switch. The correct syntax is <code>--Auth=username:api_key</code> but in the above command the <code>username</code> is missing.<br />
* Press the up arrow key to bring up the previous command in the command prompt window. Then fix the syntax and run the command again. It should then work.<br />
<br />
Assuming dump submission succeeds, the AniDB page for the file will likely show the following:<br />
<br />
[[File:anidb_AddFile12.guide.png|i.imgur.com/Wf8zsGx.guide.png]]<br />
<br />
In other words, while the correct meta-data has been submitted as part of a dump to AniDB, the information for that file has not changed.<br />
<br />
'''This is normal.''' There is a delay for certain submissions to AniDB. The next section contains more information about how change requests work but for now just know there is a delay and the information will be automatically updated later.<br />
<br />
For the file above, this is what the information looked like less than 24-hours later:<br />
<br />
[File:Avdump2cl_submitVerifyComplete.guide.png|i.imgur.com/nwrSeBV.guide.png]<br />
<br />
==== Automating Avdump2 CLI ====<br />
<br />
So far, we have added a single file entry and submitted the associated dump for processing. However, Log Horizon S1 has more than 1 episode. Updating each episode this way, by running <code>Avdump2cl.exe</code> twice, once to create the ed2k link and a second time to submit the dump data, would take an excessively long time. <code>Avdump2cl</code> supports combing different flags together into one command:<br />
<br />
<code>Avdump2cl.exe --Auth=[username]:[api_key] --Exp=[filename] [file/folder]</code><br />
<br />
If the above command syntax is used on a file, <code>Avdump2cl.exe</code> will authenticate with AniDB servers, then if successful, will process the file, submitting the meta-data to AniDB and then export the ed2k link to a file. This means we can run half the number of commands and still get the output needed to update AniDB!<br />
<br />
There is another thing to notice about that syntax. At the end, it says file/folder meaning that <code>Avdump2cl.exe</code> also supports specifying a folder instead of individual files. If a folder is specified, like say: <code>C:\Users\User\Downloads\Log Horizon</code> then <code>Avdump2cl.exe</code> will process every file inside of that folder, generating ed2k links for each file.<br />
<br />
With the above information, the actual command to run would be:<br /><br />
<code>Avdump2cl.exe --Auth=YukinoAi:uFEV55lknCwglqdRp1jte36NQ --Exp=Avdump2cl-ed2k-Links.txt &quot;C:\Users\User\Downloads\Log Horizon&quot;</code><br />
<br />
Notice that <code>C:\Users\User\Downloads\Log Horizon</code> needs quotation marks <code>&quot; &quot;</code> surrounding it because <code>Log Horizon</code> has a space. As long as there are no spaces, quotation marks do not have to be used. Without quotation marks, <code>Avdump2cl.exe</code> will treat and process all of the files in <code>C:\Users\User\Downloads\Log</code> and also all of the files inside the <code>Horizon</code> folder. Since neither of these folders exist, the commad will fail:<br />
<br />
[[File:Avdump2cl_syntaxFail1.guide.png|i.imgur.com/7wV8R5O.guide.png]]<br />
<br />
If using the drag and drop technique instead of copy-paste, quotation marks will automatically be added as appropriate.<br />
<br />
So, running the above command with proper quotation marks will work. The ed2k links generated in the text file can be added to AniDB using the Mass Add page as shown above. However, having to worry about syntax is cumbersome, as is starting a command prompt. Is there not a better way?<br />
<br />
An alternative approach is to create a shell script that will invoke <code>Avdump2cl.exe</code> with the correct syntax automatically. If anything bad happens, like authentication or syntax errors, it will be easy to solve because the correct syntax can just be copied from the text file back to a normal command prompt.<br />
<br />
Open notepad and copy-paste the following cryptic text into a file called <code>AniDBUpdate.bat</code> or just download it [here].<br />
<br />
<pre><br />
@echo off<br />
set username=putUsernameHere<br />
set api_key=putApiKeyHere<br />
set pathToAvdump2=C:\Users\User\Downloads\avdump-gui-2.3.2-portable\appdata\avdump-gui-2.3.2.win32<br />
<br />
set mode=auth<br />
::mode can be either exp or auth<br />
<br />
if /i &quot;%~1&quot; equ &quot;&quot; (goto usage)<br />
if /i &quot;%~1&quot; equ &quot;?&quot; (goto usage)<br />
if /i &quot;%~1&quot; equ &quot;/?&quot; (goto usage)<br />
if not exist &quot;%~1&quot; (echo.<br />
echo &quot;%~1&quot; does not exist<br />
goto usage)<br />
<br />
if not exist &quot;%pathToAvdump2%\Avdump2cl.exe&quot; (echo.<br />
echo &quot;%pathToAvdump2%\Avdump2cl.exe&quot; does not exist<br />
goto usage)<br />
if /i &quot;%username%&quot; equ &quot;putUsernameHere&quot; goto usage<br />
if /i &quot;%api_key%&quot; equ &quot;putApiKeyHere&quot; goto usage<br />
<br />
if /i &quot;%mode%&quot; equ &quot;exp&quot; &quot;%pathToAvdump2%\Avdump2cl.exe&quot; --Exp=&quot;%~dp1\ed2k-%~n1.%random%.txt&quot; &quot;%~1&quot; &quot;%~2&quot; &quot;%~3&quot; &quot;%~4&quot; &quot;%~5&quot; &quot;%~6&quot; &quot;%~7&quot; &quot;%~8&quot; &quot;%~9&quot;<br />
::if /i &quot;%mode%&quot; equ &quot;exp&quot; &quot;%pathToAvdump2%\Avdump2cl.exe&quot; --Exp=&quot;%userprofile%\Desktop\ed2k-Link-%~n1.%random%.txt&quot; &quot;%~1&quot; &quot;%~2&quot; &quot;%~3&quot; &quot;%~4&quot; &quot;%~5&quot; &quot;%~6&quot; &quot;%~7&quot; &quot;%~8&quot; &quot;%~9&quot;<br />
if /i &quot;%mode%&quot; equ &quot;auth&quot; &quot;%pathToAvdump2%\Avdump2cl.exe&quot; --Auth=&quot;%username%:%api_key%&quot; --Exp=&quot;%~dp1\ed2k-%~n1.%random%.txt&quot; &quot;%~1&quot; &quot;%~2&quot; &quot;%~3&quot; &quot;%~4&quot; &quot;%~5&quot; &quot;%~6&quot; &quot;%~7&quot; &quot;%~8&quot; &quot;%~9&quot;<br />
::if /i &quot;%mode%&quot; equ &quot;auth&quot; &quot;%pathToAvdump2%\Avdump2cl.exe&quot; --Auth=&quot;%username%:%api_key%&quot; --Exp=&quot;%userprofile%\Desktop\ed2k-Link-%~n1.%random%.txt&quot; &quot;%~1&quot; &quot;%~2&quot; &quot;%~3&quot; &quot;%~4&quot; &quot;%~5&quot; &quot;%~6&quot; &quot;%~7&quot; &quot;%~8&quot; &quot;%~9&quot;<br />
<br />
goto end<br />
:usage<br />
echo.<br />
echo OMG^! Hi^!^!^! Usage Help:<br />
echo.<br />
echo %~nx0 can be used to automate usage of Avdump2cl.exe<br />
echo Please update &quot;username&quot; and &quot;api_key&quot; before using %~nx0.<br />
echo. <br />
echo CLI Usage: <br />
echo %~nx0 &quot;C:\Users\User\Downloads\Log Horizon&quot;<br />
echo %~nx0 &quot;C:\Users\User\Downloads\Log Horizon\episode01.mkv&quot;<br />
echo.<br />
echo Drag and drop also works.<br />
echo.<br />
echo For &quot;right-click Send to&quot; functionality, copy a shortcut to:<br />
echo &quot;%appdata%\..\roaming\Microsoft\Windows\SendTo&quot;<br />
echo.<br />
pause<br />
<br />
:end<br />
<br />
</pre><br />
[[File:AniDBUpdate_1.guide.png|i.imgur.com/3glAjpw.guide.png]]<br />
<br />
The three highlighted items need to be changed before using the script. Update the username and API key appropriately. Make sure there are no trailing whitespaces in either the username or api_key. &quot;Name&quot; will work but &quot;Name &quot; will not. Example:<br />
<br />
[[File:AniDBUpdate_2.guide.png|i.imgur.com/OhfWiuG.guide.png]]<br />
<br />
For the pathToAvdump2 entry, the path should not include a trailing <code>\</code>.<br />
<br />
Example:<br />
<br />
* <code>C:\avdump-gui-2.3.2-portable</code> will work.<br />
* <code>C:\avdump-gui-2.3.2-portable\</code> will not work.<br />
<br />
After entering the username and the UDP API key, here are 3 ways to run the above text file:<br />
<br />
1) Hardest: Command prompt method: Navigate to the correct directory and type <code>AniDBUpdate.bat</code>.<br />
<br />
[[File:AniDBUpdate_cmd.guide.png|i.imgur.com/3N0Sg5f.guide.png]]<br />
<br />
2) Drag and drop method: Drag and drop a file or folder onto the batch file.<br />
<br />
[[File:AniDBUpdate_drag1.guide.png|i.imgur.com/eLFgKWf.guide.png]]<br />
<br /><br />
[[File:AniDBUpdate_drag2.guide.png|i.imgur.com/sxIleWJ.guide.png]]<br />
<br />
3) Easiest: Send-to method: Use the right-click <code>Send to</code> context menu.<br />
<br />
[[File:AniDBUpdate_drag1.guide.png|i.imgur.com/kuUEJsh.guide.png]]<br />
<br />
For the send-to method to work, the file, or a shortcut to it, must be placed at:<br /><br />
<code>C:\Users\Username\AppData\Roaming\Microsoft\Windows\SendTo</code><br /><br />
To open this folder automatically, paste the following into an explorer address bar or <code>Windows key + r</code><br /><br />
<code>&quot;%appdata%\..\roaming\Microsoft\Windows\SendTo&quot;</code><br />
<br />
# <code>Ctrl + c</code> to copy: <code>&quot;%appdata%\..\roaming\Microsoft\Windows\SendTo&quot;</code><br />
# <code>Windows key + r</code><br />
# <code>Ctrl + v</code> to Paste the above contents<br />
## [[File:AniDBUpdate_sendTo1.guide.png|i.imgur.com/Dw7Ckdc.guide.png]]<br />
# Press <code>Enter</code><br />
# Right-Click - create a new shortcut<br />
## [[File:AniDBUpdate_sendTo2.guide.png|i.imgur.com/VsyL3TV.guide.png]]<br />
# Move the shortcut from where it was created to <code>\SentTo</code>.<br />
## [[File:AniDBUpdate_sendTo3.guide.png|i.imgur.com/iUQCorO.guide.png]]<br />
# Rename the shortcut appropriately.<br />
<br />
With the command prompt and send-to methods:<br />
<br />
* Up to 9 discrete files and folders may be selected<br />
* When sending a folder, all files within that folder and all subfolders will be processed.<br />
<br />
===Avdump2 GUI===<br />
<br />
Avdump2gui.exe is the graphical user interface (GUI) wrapper for <code>Avdump2cl.exe</code> and supports a subset of the features:<br />
<br />
Avdump2 GUI Limitations. The GUI:<br />
<br />
* always requires authenticating.<br />
* will not generate links without specifying a valid username and valid API key pair, every time.<br />
** Note: This information is forcibly saved across instances.<br />
* must be deliberately started every time to be used.<br />
* will not issue an error message when authentication fails and simply not respond.<br />
** If the GUI does not respond, it is advisable to test for authentication errors using <code>Avdump2CL.exe</code>.<br />
* requires updating prior to usage.<br />
<br />
With these limitations in mind. Launch Avdump2gui to have it update automatically.<br />
<br />
# Specify the username and api-key.<br />
# Use the <code>Files</code> and <code>Folder</code> buttons too add files to process.<br />
## [[File:Avdump2gui_1.guide.png|i.imgur.com/3ypUEcP.guide.png]]<br />
# When complete, click start to see what happens.<br />
## If/When nothing happens check for authentication errors using <code>Avdump2CL.exe</code> using the instructions provided above.<br />
# If it works, nothing will happen for a while, and then eventually ed2k links will appear in the ed2k export window. The dump data should have been submitted to AniDB in the background, although there is no way to check.<br />
## [[File:Avdump2gui_2.guide.png|i.imgur.com/r52bp7D.guide.png]]<br />
<br />
The ed2k links in the export window can now be submitted to AniDB. Detailed instructions for this are provided above.<br />
<br />
== Understanding AniDB Change Requests (creqs) ==<br />
<br />
:{{Missing}}<br />
<br />
AniDB is a user-driven database. A normal way to contribute is to issue change requests (creqs for short), which means that a moderator has to approve suggested changes before they are published. Request links can usually be found on every page that has editable content for logged in users.<br />
<br />
* Except for obvious changes, always describe the reason for changes in the request and/or the source of the information.<br />
* Be prepared to follow up the requests made. Creqs will be denied if there is no response to moderator questions.<br />
<br />
More info:<br /><br />
[[How_to_update_or_correct_existing_entries|wiki/How_to_update_or_correct_existing_entries]]<br/><br />
[[How_to_get_started_with_creqing|wiki/How_to_get_started_with_creqing]]<br />
<br />
Avdump2, used above, is AniDB's mechanism to submit automatic change requests (acreqs or auto-creq). These automatic change requests do not always require moderator approval because the information (file-metadata) has been verified programmatically. For auto-creqing:<br />
<br />
* All data sent to the server will be logged with IP and user id.<br />
* There is no direct connection between data sent to AniDB and creqs generated. The data dumps will just be stored for later processing into creqs.<br />
* There is no way to check the current status for a dump.<br />
* Avdump2cl.exe will display a count of the files that have been submitted to the server as output as <code>ACReq ( Done: # [...]</code>, but that is all.<br />
* Usually, it should take at least 24 hours from the moment a file metadata dump has been submited untill the file data actually changes. If any irregularities occur, or when there is too much data pending, it will take more time. The system auto-creqs to add missing tracks within 72 hours.<br />
* It is possible to dump files currently not in the database. The data is still stored and will be used later if/after the file has been registered.<br />
<br />
In other words, when Avdump2 submits meta-data dumps to AniDB, the data itself may get processed into a change request. But first, in order to automatically apply the dumped metadata information to a file, that file must be registered first. The process of submitting ed2k links is that registration process. The metadata dumps themselves also contain the ed2k hash information that serves as the basis to link it to registered files.<br />
<br />
To learn more about creqs please check out:<br />
<br />
"Adding Data" subsection on [[Main_Page|wiki/Main_Page]]<br />
<br />
For further help with a problem or just for chatting visit IRC:<br />
<br />
Wiki page for IRC: [[IRC:anidb|wiki/IRC:anidb]]<br /><br />
Channel Address: irc://irc.synirc.net/anidb</div>YukinoAihttps://wiki.anidb.net/index.php?title=User:YukinoAi&diff=22926User:YukinoAi2017-08-16T01:09:01Z<p>YukinoAi: Created page with "OMG! Hi!!!"</p>
<hr />
<div>OMG! Hi!!!</div>YukinoAihttps://wiki.anidb.net/index.php?title=File:Windowskey_notepad.guide.png&diff=22925File:Windowskey notepad.guide.png2017-08-16T00:56:14Z<p>YukinoAi: </p>
<hr />
<div></div>YukinoAihttps://wiki.anidb.net/index.php?title=File:Windowskey_cmd.guide.png&diff=22924File:Windowskey cmd.guide.png2017-08-16T00:56:04Z<p>YukinoAi: </p>
<hr />
<div></div>YukinoAihttps://wiki.anidb.net/index.php?title=File:Notepad_apiKey_paste.guide.png&diff=22923File:Notepad apiKey paste.guide.png2017-08-16T00:55:43Z<p>YukinoAi: </p>
<hr />
<div></div>YukinoAihttps://wiki.anidb.net/index.php?title=File:Grc_pp_20charas_highlight.guide.png&diff=22922File:Grc pp 20charas highlight.guide.png2017-08-16T00:55:30Z<p>YukinoAi: </p>
<hr />
<div></div>YukinoAihttps://wiki.anidb.net/index.php?title=File:Grc_pp_20characters_copy.guide.png&diff=22921File:Grc pp 20characters copy.guide.png2017-08-16T00:55:16Z<p>YukinoAi: </p>
<hr />
<div></div>YukinoAihttps://wiki.anidb.net/index.php?title=File:Cmd_empty.guide.png&diff=22920File:Cmd empty.guide.png2017-08-16T00:55:06Z<p>YukinoAi: </p>
<hr />
<div></div>YukinoAihttps://wiki.anidb.net/index.php?title=File:Cmd_drag_folder6.guide.png&diff=22919File:Cmd drag folder6.guide.png2017-08-16T00:54:56Z<p>YukinoAi: </p>
<hr />
<div></div>YukinoAihttps://wiki.anidb.net/index.php?title=File:Cmd_drag_folder5.guide.png&diff=22918File:Cmd drag folder5.guide.png2017-08-16T00:54:48Z<p>YukinoAi: </p>
<hr />
<div></div>YukinoAihttps://wiki.anidb.net/index.php?title=File:Cmd_drag_folder4.guide.png&diff=22917File:Cmd drag folder4.guide.png2017-08-16T00:54:40Z<p>YukinoAi: </p>
<hr />
<div></div>YukinoAihttps://wiki.anidb.net/index.php?title=File:Cmd_drag_folder3.guide.png&diff=22916File:Cmd drag folder3.guide.png2017-08-16T00:54:30Z<p>YukinoAi: </p>
<hr />
<div></div>YukinoAihttps://wiki.anidb.net/index.php?title=File:Cmd_drag_folder2.guide.png&diff=22915File:Cmd drag folder2.guide.png2017-08-16T00:54:20Z<p>YukinoAi: </p>
<hr />
<div></div>YukinoAihttps://wiki.anidb.net/index.php?title=File:Cmd_drag_folder.guide.png&diff=22914File:Cmd drag folder.guide.png2017-08-16T00:54:05Z<p>YukinoAi: </p>
<hr />
<div></div>YukinoAihttps://wiki.anidb.net/index.php?title=File:Avdump3cl_auth4.guide.png&diff=22913File:Avdump3cl auth4.guide.png2017-08-16T00:53:53Z<p>YukinoAi: </p>
<hr />
<div></div>YukinoAihttps://wiki.anidb.net/index.php?title=File:Avdump2gui_2.guide.png&diff=22912File:Avdump2gui 2.guide.png2017-08-16T00:53:44Z<p>YukinoAi: </p>
<hr />
<div></div>YukinoAihttps://wiki.anidb.net/index.php?title=File:Avdump2gui_1.guide.png&diff=22911File:Avdump2gui 1.guide.png2017-08-16T00:53:32Z<p>YukinoAi: </p>
<hr />
<div></div>YukinoAihttps://wiki.anidb.net/index.php?title=File:Avdump2cl_syntaxFail1.guide.png&diff=22910File:Avdump2cl syntaxFail1.guide.png2017-08-16T00:53:22Z<p>YukinoAi: </p>
<hr />
<div></div>YukinoAihttps://wiki.anidb.net/index.php?title=File:Avdump2cl_submitVerifyComplete.guide.png&diff=22909File:Avdump2cl submitVerifyComplete.guide.png2017-08-16T00:53:10Z<p>YukinoAi: </p>
<hr />
<div></div>YukinoAihttps://wiki.anidb.net/index.php?title=File:Avdump2cl_submitVerify.guide.png&diff=22908File:Avdump2cl submitVerify.guide.png2017-08-16T00:52:58Z<p>YukinoAi: </p>
<hr />
<div></div>YukinoAihttps://wiki.anidb.net/index.php?title=File:Avdump2cl_help2.guide.png&diff=22907File:Avdump2cl help2.guide.png2017-08-16T00:52:31Z<p>YukinoAi: </p>
<hr />
<div></div>YukinoAihttps://wiki.anidb.net/index.php?title=File:Avdump2cl_help.guide.png&diff=22906File:Avdump2cl help.guide.png2017-08-16T00:52:19Z<p>YukinoAi: </p>
<hr />
<div></div>YukinoAihttps://wiki.anidb.net/index.php?title=File:Avdump2cl_exportTest3.guide.png&diff=22905File:Avdump2cl exportTest3.guide.png2017-08-16T00:52:06Z<p>YukinoAi: </p>
<hr />
<div></div>YukinoAihttps://wiki.anidb.net/index.php?title=File:Avdump2cl_exportTest2.png&diff=22904File:Avdump2cl exportTest2.png2017-08-16T00:51:57Z<p>YukinoAi: </p>
<hr />
<div></div>YukinoAihttps://wiki.anidb.net/index.php?title=File:Avdump2cl_exportTest1.guide.png&diff=22903File:Avdump2cl exportTest1.guide.png2017-08-16T00:51:47Z<p>YukinoAi: </p>
<hr />
<div></div>YukinoAihttps://wiki.anidb.net/index.php?title=File:Avdump2cl_dragTest3.guide.png&diff=22902File:Avdump2cl dragTest3.guide.png2017-08-16T00:51:36Z<p>YukinoAi: </p>
<hr />
<div></div>YukinoAihttps://wiki.anidb.net/index.php?title=File:Avdump2cl_dragTest2.guide.png&diff=22901File:Avdump2cl dragTest2.guide.png2017-08-16T00:51:24Z<p>YukinoAi: </p>
<hr />
<div></div>YukinoAihttps://wiki.anidb.net/index.php?title=File:Avdump2cl_dragTest1.guide.png&diff=22900File:Avdump2cl dragTest1.guide.png2017-08-16T00:51:10Z<p>YukinoAi: </p>
<hr />
<div></div>YukinoAihttps://wiki.anidb.net/index.php?title=File:Avdump2cl_authFail2.guide.png&diff=22899File:Avdump2cl authFail2.guide.png2017-08-16T00:50:57Z<p>YukinoAi: </p>
<hr />
<div></div>YukinoAihttps://wiki.anidb.net/index.php?title=File:Avdump2cl_authFail1.guide.png&diff=22898File:Avdump2cl authFail1.guide.png2017-08-16T00:50:35Z<p>YukinoAi: </p>
<hr />
<div></div>YukinoAihttps://wiki.anidb.net/index.php?title=File:Avdump2cl_auth4.guide.png&diff=22897File:Avdump2cl auth4.guide.png2017-08-16T00:50:22Z<p>YukinoAi: </p>
<hr />
<div></div>YukinoAihttps://wiki.anidb.net/index.php?title=File:Avdump2cl_auth3.guide.png&diff=22896File:Avdump2cl auth3.guide.png2017-08-16T00:50:11Z<p>YukinoAi: </p>
<hr />
<div></div>YukinoAihttps://wiki.anidb.net/index.php?title=File:Avdump2cl_auth2.guide.png&diff=22895File:Avdump2cl auth2.guide.png2017-08-16T00:50:01Z<p>YukinoAi: </p>
<hr />
<div></div>YukinoAihttps://wiki.anidb.net/index.php?title=File:Avdump2cl_auth1.guide.png&diff=22894File:Avdump2cl auth1.guide.png2017-08-16T00:49:51Z<p>YukinoAi: </p>
<hr />
<div></div>YukinoAihttps://wiki.anidb.net/index.php?title=File:Avdump2cl_apiKey_timeout.guide.png&diff=22893File:Avdump2cl apiKey timeout.guide.png2017-08-16T00:49:39Z<p>YukinoAi: </p>
<hr />
<div></div>YukinoAihttps://wiki.anidb.net/index.php?title=File:AniDBUpdate_sendTo3.guide.png&diff=22892File:AniDBUpdate sendTo3.guide.png2017-08-16T00:49:29Z<p>YukinoAi: </p>
<hr />
<div></div>YukinoAihttps://wiki.anidb.net/index.php?title=File:AniDBUpdate_sendTo2.guide.png&diff=22891File:AniDBUpdate sendTo2.guide.png2017-08-16T00:49:19Z<p>YukinoAi: </p>
<hr />
<div></div>YukinoAihttps://wiki.anidb.net/index.php?title=File:AniDBUpdate_sendTo1.guide.png&diff=22890File:AniDBUpdate sendTo1.guide.png2017-08-16T00:49:08Z<p>YukinoAi: </p>
<hr />
<div></div>YukinoAihttps://wiki.anidb.net/index.php?title=File:AniDBUpdate_drag2.guide.png&diff=22889File:AniDBUpdate drag2.guide.png2017-08-16T00:48:44Z<p>YukinoAi: </p>
<hr />
<div></div>YukinoAihttps://wiki.anidb.net/index.php?title=File:AniDBUpdate_drag1.guide.png&diff=22888File:AniDBUpdate drag1.guide.png2017-08-16T00:48:34Z<p>YukinoAi: </p>
<hr />
<div></div>YukinoAihttps://wiki.anidb.net/index.php?title=File:AniDBUpdate_cmd.guide.png&diff=22887File:AniDBUpdate cmd.guide.png2017-08-16T00:48:23Z<p>YukinoAi: </p>
<hr />
<div></div>YukinoAihttps://wiki.anidb.net/index.php?title=File:AniDBUpdate_2.guide.png&diff=22886File:AniDBUpdate 2.guide.png2017-08-16T00:48:13Z<p>YukinoAi: </p>
<hr />
<div></div>YukinoAi