Tutorial:How to Add Files for Dummies!/The Prolix Addendum: Difference between revisions

In the last box of characters labeled <code>a-z, A-Z, 0-9</code>, highlight 20-30 characters as shown below.

Then copy the selected characters to the clipboard.

* <code>Ctrl + c</code>

Change tabs back to AniDB's page.

In the empty field under the <code>UDP API Key</code>, right-click and select <code>Paste</code>. Alternatively: <code>Ctrl + v</code>.<br />

Click on the <code>Apply</code> button at the bottom. It should be right above <code>Back</code>.<br />

The <code>UDP API Key</code> field should turn into asterisks (*) to show that it has saved it properly.<br />

The API key should also be saved for use with Avdump2 later on, so lets save it to notepad.

<code>Windows key</code> or Click on the start menu and type in <code>notepad</code>.

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>).

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>:

The Avdump2 GUI will simply not respond when authentication fails. More on this later.

At the top right next to <code>Search</code> change the search type from <code>all</code> to <code>group</code>.

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).

* <code>Windows key</code> - Type <code>cmd.exe</code> and press <code>Enter</code>.

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>.

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.

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.

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.

Enter <code>cd</code> and a single space.

Press <code>Enter</code>.

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>.

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>.

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.

Running <code>Avdump2CL.exe</code> without any options will list many available options.

Running <code>Avdump2CL.exe --help</code> will list all of the available options.

====Generating ed2k Links Using Avdump2 CLI====

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.

The file name with the full path will be automatically populated in the command prompt window.

At the very bottom, paste the ed2k link from and click on <code>Next</code>.

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>.

Success!

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.

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.

* 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.

The auth flag has the following syntax:

<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:

Enter a space and then drag and drop the file to add to AniDB into the command prompt window as before:

The command below should be sufficent to submit the meta-data.

Press <code>Enter</code>. If it works, the following should appear after processing completes:

The line that says:<br />

If you get an error like the following:<br />

* Double check the API key is correct.

If you get an error like the following:

* Notice the error is from <code>ACReq.Authentication</code>. This indicates something to do with authentication caused the error.

Assuming dump submission succeeds, the AniDB page for the file will likely show the following:

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.

For the file above, this is what the information looked like less than 24-hours later:

==== Automating Avdump2 CLI ====

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:

If using the drag and drop technique instead of copy-paste, quotation marks will automatically be added as appropriate.

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.

<pre>

set username=putUsernameHere

set api_key=putApiKeyHere

set mode=auth

goto usage)

goto usage)

if /i &quot;%username%&quot; equ &quot;putUsernameHere&quot; goto usage

if /i &quot;%api_key%&quot; equ &quot;putApiKeyHere&quot; goto usage

goto end

:end

</pre>

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:

For the pathToAvdump2 entry, the path should not include a trailing <code>\</code>.

1) Hardest: Command prompt method: Navigate to the correct directory and type <code>AniDBUpdate.bat</code>.

2) Drag and drop method: Drag and drop a file or folder onto the batch file.

<br />

3) Easiest: Send-to method: Use the right-click <code>Send to</code> context menu.

For the send-to method to work, the file, or a shortcut to it, must be placed at:<br />

# <code>Windows key + r</code>

# <code>Ctrl + v</code> to Paste the above contents

# Press <code>Enter</code>

# Right-Click - create a new shortcut

# Move the shortcut from where it was created to <code>\SentTo</code>.

# Rename the shortcut appropriately.

# Specify the username and api-key.

# Use the <code>Files</code> and <code>Folder</code> buttons too add files to process.

# When complete, click start to see what happens.

## If/When nothing happens check for authentication errors using <code>Avdump2CL.exe</code> using the instructions provided above.

# 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.

The ed2k links in the export window can now be submitted to AniDB. Detailed instructions for this are provided above.