Difference between revisions of "Tutorial:How to Add Files for Dummies!"

From AniDB
Jump to navigation Jump to search
(Swap step 4 and 5)
 
(43 intermediate revisions by 10 users not shown)
Line 1: Line 1:
=The Anidb Tutorial=
+
{{TOCright}}
==Introduction==
+
AniDB is file based. Because of this, all group release statuses in AniDB are calculated from the added files! Keep that in mind.
This tutorial is meant for those not familiar with anidb specifically the part in which the user is asked to contribute to it.
+
{{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.}}
Anidb is a USERDRIVEN SITE which means users are expected to keep it updated by adding files, new anime and anything else datawise.
+
{{eyecatch|Note|Do '''NOT''' add files that '''only''' you have: self-(re)encoded or corrupted files should not be added.}}
This tutorial will go from step one meaning if you read it all you should know how to add data succesfully using anidb clients (more on that later)
+
{{eyecatch|WARNING|Do '''NOT''' add [[Content:Files#What_is_accepted.3F|personal files]].}}
  
-------------
+
===Step 1===
 +
* Verify that the group you want to add a release for has already been added (see [[Content:Groups|Groups]]).
 +
* If not, add the group details before continuing.
  
=1. Vocabulary=
+
===Step 2===
This part is for people unknown to the words codecs, bitrate, or even video and audio. This guide assumes you can atleast understand basic english!
+
''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]].''
 +
* 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]].
 +
* Install it.
 +
* Start it (click the avdump2 icon on your desktop).
 +
* Set your AniDB username and UDP API key.
 +
{{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.}}
 +
* Select what you want to scan from the main menu: files or folders.
 +
* Click Start.
  
==1.1 General==
+
===Step 3===
*Anidb: This Site
+
{{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.}}
*URL: Uniform Resource Locator eg. www.anidb.net
+
* Go to the entry of the [[Content:Anime|Anime]] in AniDB you want to add a release for.
*IRC: Internet Relay Chat, a protocol used to chat and secondary to transfer files. Many Clients for the protocol are available the most popular one, probably, being mIRC which is very configurable and extendable with scripts.
+
* Scroll down to the groups block on the page and click the '''[[Mass add:Files|add new release]]''' button.
*Metadata: Metadata (sometimes called metainformation) is "data about data", of any sort in any media. An item of metadata may describe an individual datum, or content  item, or a collection of data including multiple content items. (For More: http://en.wikipedia.org/wiki/Metadata). In short this is the data or information you as user inputs in the db when adding a file.
+
* 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.
*Hash: A hash is a calculated series of characters which hold information about a specific file. Anidb uses the ED2K Hash to identify it's files and make sure they are unique. Other hashes are also required to add if you do it manually because the more hashes the surer you can be the file is unique. The most known hash is the CRC Hash which can be found in many anime filenames by default, an example: Ghost_In_The_Shell_SAC_2nd_GIG_01.DVD(H264.AC3_5.1)[KAA]['''F0EF9123'''].mkv. The bold piece in the filename is the CRC. (For more on this http://en.wikipedia.org/wiki/Hash_function)
+
* Set the group, source, release date, quality, track, and language options. There are some default templates to help you along.
*Codec: A piece of software used to encode audio or video data.
+
* Click ''Next''.
*Bitrate: Amounts of bits per second. An easy eg. Mp3 128kbps, 192kbps, etc.
+
* 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.
*FPS: Frames Per Second. Assuming you know what a frame is this is obvious. ==
+
* 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).
  
==1.2 Metadata==
+
===Step 4 (optional)===
This is the list (which should be as complete as i can get it) of all the data you can input when adding a file to anidb.  
+
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:
The screenshot show the full addfile template with all possible data you can add for one file.
+
* Go to the entry of the file where you can see all the file-related details like bitrate, codec etc.
'''Note: BOLD LINES YOU HAVE TO INPUT MANUALLY CAUSE ANIDB CLIENTS CAN'T INPUT THOSE AUTOMATICALLY'''
+
* At the bottom of that page you will find a link called '''add new episode relation'''.
 
+
* Choose the other episode this file belongs to and hit add.
Screenshot: [[Image:Metadata.JPG|thumb|Add a File Dialogue]]
+
Repeat this process for any additional episodes the file spans.
 
 
Hashes:
 
-------
 
  
*'''ED2K Sum/Hash: The most important hash and REQUIRED! You can not add a file without it. This you always have to input manually'''
+
===Step 5 (Optional)===
*MD5 Sum: Another Hash which will be added automatically by avdump (more on avdump later)
+
====Animegroup Release Note Comments====
*Sha1 Sum: See MD5 Sum
+
[[File:Animegroup_releasenotes1.PNG|200px|thumb|text-bottom|right|Step 1: click on the Animegroup comment edit button to edit the release notes.]]
*CRC Sum: See MD5 Sum
+
[[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.]]
+
{{eyecatch|Note|If there are any uncertainties, such as examples not covered below, please consult [http://anidb.net/up560966 CDB-Man] for clarification.}}
Other
+
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.
-----
 
 
*Size: Size of the file in bytes.
 
*Lenght: Playing length of the file in minutes
 
*Type: Type, select from the dropdown box
 
*Extension: Leave this on autodetect normally.
 
*'''Quality/Source: The Quality of the file, And the Source from which it was encoded. eg. DVD, DTV, HDTV etc'''
 
*'''Version: Sometimes the group makes mistakes and wants to correct them by releasing a second (third, fourth...) version, usually called v2 (v3, v4, ...). This field is usually based on information in the file name (where no information normally means version 1).<br>'''
 
Even if a group releases two files of the same episode it does not mean that the first has to be marked v1 and the second v2. There are other reasons to do something like that other than correcting mistakes like; different source (DTV/DVD), different sub languages, high and low quality versions, etc.
 
*'''Released: Date of release, Only add this when you are sure.'''
 
*'''Released by: The Group that released this file. Use the search function or dropdown list. If the group released another file for this anime already it will be in the dropdown list. If you cannot find the group you need to add it first.'''
 
 
Video Track Info
 
----------------------
 
 
*Track Toggle: If there is no video or audio check this.
 
*Pixel Resolution: resolution of the video in pixels; eg. 640x480 1280x720
 
*Codec/Bitrate/FPS: Video Codec/ Bitrate the video codec uses / Frames Per Second
 
*Flags: Some options you can generally leave blank unless you know what they mean and they apply to the file.
 
 
Audio Track Info
 
----------------------
 
 
*Track Toggle: If there is no video or audio check this.
 
*'''Type: Select the appropriate type from the dropdown box'''
 
*'''Language: Select from dropdownbox'''
 
*Codec/Bitrate: Codec and Bits per second
 
*Channels: the amount of audio channels the stream has. eg. 2.0, 5.1
 
 
Subtitle info
 
----------------------
 
 
*Track Toggle: If there isn't any check this
 
*Type: Select the apropriate type from the dropdown box
 
*'''Language: Select from the dropdown box'''
 
*Flags: Some options you can generally leave blank unless you know what they mean and they apply to the file.
 
 
Comments
 
--------
 
 
Self-explanatory (see screenshot above)
 
  
=2. Anidb Clients=
+
====How to Add Animegroup Release Note Comments====
Anidb has a number of clients you can use. What is a client? A client is a program that uses anidb data or is used to input data into anidb.
+
The animegroup release note comments can be edited directly from the anime page.
  
Which ones are we gonna talk about here?
+
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>
 +
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)
  
Primarily we are gonna talk about AVdump, AOM and Webaom. These clients all have wiki pages of their own and the only stuff that will be said about them here is what you have to know of them to add a file to anidb.
+
Please see [[Groupentries:Status#Animegroup_Release_Note_Comments|our release note comments main page]] for standardized formatting of release notes.
How to set it up and how to use it for that purpose. If you want to use them for more I'll refer you to their own pages.
 
  
==2.1 AVdump==
 
Q: What is AVdump?<br>
 
A: Avdump is a small program that can analyze a video/audio file, recognize the codec, bitrate, resolution and lots of other info and send it to anidb.
 
 
 
Q: Is the program hard to use?<br>
 
A: No. It requires you to set it up once afterwhich using it is a matter of two, three clicks and everything works automatically.
 
 
 
Q: Where can I find detailed info about AVdump?<br>
 
A: http://wiki.anidb.net/w/Avdump
 
 
 
===2.1.1 Setting up AVdump===
 
Setting up avdump can be done in different ways. This way is in my opinion the one that will make it the easiest in use.
 
 
IMPORTANT!: You need an anidb apipass!
 
You can set your apipass in your profile options. (See Screenshot) Input a desired pass in the set api key field
 
  
[[Image:Api_Pass.JPG|thumb|Setting your api pass]]
+
<span style="font-size:60%">For a more lengthy guide: [[Tutorial:How to Add Files for Dummies!/The Prolix Addendum|The Prolix Addendum]].</span>
 
# First download the latest version of avdump here (http://static.anidb.net/client/avdump.rar)
 
# Unpack it in a folder of choice.
 
# Rightclick on avdump.exe and press create shortcut.
 
# Now rightclick on the shortcut you just created and click properties
 
# As in the screenshot to the left input @ target: -o -ac:anidbusername:apipass -p
 
[[Image:Avdump2.jpg]]
 
# Apply and press OK
 
# Rightclick on the shortcut and press rename. Rename it too Avdump Auto Creq. Aply and Ok
 
# Now if you have hidden folders and files enabled already skip this and goto 9
 
## Go to Extra -> Mapoptions in explorer.
 
##* (For Vista) Go to Organize -> Folder and Search Options.
 
## Go to the "view" tab
 
## Now go down untill you see: "Enable Hidden Files and Folders"
 
## Press Apply and Ok
 
[[Image:Hidden-Files-and-Folders.jpg|thumb|Enable Hidden Files and Folders]]
 
# Rightclick the shortcut and press cut.
 
# Now in the explorer adress bar type: x:\Documents and Settings\user\SendTo. x: being the hdd windows is installed on and user being your username in windows.
 
#* (For Vista) Go to C:\Users\<username>\AppData\Roaming\Microsoft\Windows\SendTo, also assuming your windows is installed on C: drive
 
# Paste the shortcut in this map by pressing Ctrl+v.
 
 
You have now succesfully installed Avdump and you can autocreq any file on your computer.
 
 
 
===2.1.2 Using AVdump===
 
From now on you can use avdump by rightclicking the file you wanna dump to the db, going to the "send to" and then clicking "Avdump AuroCreq"
 
 
 
Simple isn't it :)
 
 
===2.1.3 Updating AVdump===
 
AVdump gets updated and everytime this happens it will be on anidb's mainpage. The only thing you need to do to update is dl the new version and unpack it in the folder your avdump is. the shortcut will stay the same and work fine.
 
 
 
Easy isn't it ;)
 

Latest revision as of 13:47, 13 October 2020

AniDB is file based. Because of this, all group release statuses in AniDB are calculated from the added files! Keep that in mind.

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.
Note Do NOT add files that only you have: self-(re)encoded or corrupted files should not be added.
WARNING Do NOT add personal files.

Step 1

  • Verify that the group you want to add a release for has already been added (see Groups).
  • If not, add the group details before continuing.

Step 2

To add files to AniDB you need the 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.

  • Get Avdump GUI. More help/info on Avdump GUI can be found here on the Avdump GUI page.
  • Install it.
  • Start it (click the avdump2 icon on your desktop).
  • Set your AniDB username and UDP API key.
Note To use Avdump2, you need to create an UDP API Key (choose anything you'd like) in your profile (Button profile.gif on AniDB), under Profile -> Account -> UDP API Key.
  • Select what you want to scan from the main menu: files or folders.
  • Click Start.

Step 3

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.
  • Go to the entry of the Anime in AniDB you want to add a release for.
  • Scroll down to the groups block on the page and click the add new release button.
  • Copy the ed2k:// links from the ed2k-export window and paste those lines into the big text area on the add new release page.
  • Set the group, source, release date, quality, track, and language options. There are some default templates to help you along.
  • Click Next.
  • 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.
  • 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).

Step 4 (optional)

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:

  • Go to the entry of the file where you can see all the file-related details like bitrate, codec etc.
  • At the bottom of that page you will find a link called add new episode relation.
  • Choose the other episode this file belongs to and hit add.

Repeat this process for any additional episodes the file spans.

Step 5 (Optional)

Animegroup Release Note Comments

Step 1: click on the Animegroup comment edit button to edit the release notes.
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.
Note If there are any uncertainties, such as examples not covered below, please consult CDB-Man for clarification.

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.

How to Add Animegroup Release Note Comments

The animegroup release note comments can be edited directly from the anime page.

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

Please see our release note comments main page for standardized formatting of release notes.


For a more lengthy guide: The Prolix Addendum.