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

From AniDB
Jump to navigation Jump to search
m (→‎1.2 Metadata: Removed extra ")")
({{Avdump-current-version}})
 
(51 intermediate revisions by 13 users not shown)
Line 1: Line 1:
'''=The Anidb Tutorial='''
{{TOCright}}
AniDB is file based. Because of this, all group release statuses in AniDB are calculated from the added files! Keep that in mind.
{{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.}}
{{eyecatch|Note|Do '''NOT''' add files that '''only''' you have: self-(re)encoded or corrupted files should not be added.}}
{{eyecatch|WARNING|Do '''NOT''' add [[Content:Files#What_is_accepted.3F|personal files]].}}


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


This tutorial is meant for those not familiar with anidb specifically the part in which the user is asked to contribute to it.
===Step 2===
Anidb is a USERDRIVEN SITE which means users are expected to keep it updated by adding files, new anime and anything else datawise.
''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 {{Avdump-current-version}}.''
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)
* 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 {{Avdump-current-version}} icon on your desktop).
* Set your AniDB username and UDP API key.
{{eyecatch|Note|To use {{Avdump-current-version}}, 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.


-------------
===Step 3===
{{eyecatch|Note|When registering the new file information (audio tracks, subtitles) it's better to set just the minimum. The {{Avdump-current-version}} 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.}}
{{eyecatch|Note|If there are external subtitle files with a release, they should be added in a separate batch to any video files. The same goes for files with different numbers of tracks, such as unsubtitled OP/ED files.}}
* Go to the entry of the [[Content:Anime|Anime]] in AniDB you want to add a release for.
* Scroll down to the groups block on the page and click the '''[[Mass add:Files|add new release]]''' button.
* 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.
* 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).


=1. Vocabulary=
===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====
[[File:Animegroup_releasenotes1.PNG|200px|thumb|text-bottom|right|Step 1: click on the Animegroup comment edit button to edit the release notes.]]
[[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.}}
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.


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


==1.1 General==
Please see [[Groupentries:Status#Animegroup_Release_Note_Comments|our release note comments main page]] for standardized formatting of release notes.


*Anidb: This Site
*URL: Uniform Resource Locator eg. www.anidb.net
*IRC: Internet Relay Chat, a protocol used to chat and secondary to transfer files. Many Clients for the prog are available the most popular one probably being mirc which is very configurable and extendable with scripts.
*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.
*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)
*Codec: A piece of software used to encode audio or video data.
*Bitrate: Amounts of bits per second. An easy eg. Mp3 128kbps, 192kbps, etc.
*FPS: Frames Per Second. Assuming you know what a frame is this is obvious. ==


==1.2 Metadata==
<span style="font-size:60%">For a more lengthy guide: [[Tutorial:How to Add Files for Dummies!/The Prolix Addendum|The Prolix Addendum]].</span>
 
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.
The screenshot show the full addfile template with all possible data you can add for one file.
'''Note: BOLD LINES YOU HAVE TO INPUT MANUALLY CAUSE ANIDB CLIENTS CAN'T INPUT THOSE AUTOMATICALLY'''
 
Screenshot: [[Image:Metadata.JPG|thumb|Add a File Dialogue]]
 
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'''
*MD5 Sum: Another Hash which will be added automatically by avdump (more on avdump later)
*Sha1 Sum: See MD5 Sum
*CRC Sum: See MD5 Sum
Other
-----
*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=
 
 
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.
 
Which ones are we gonna talk about here?
 
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.
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]]
# 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]]
# Aply 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.
## 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.
# 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 01:12, 19 December 2021

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

Note To use Avdump3, you need to create an UDP API Key (choose anything you'd like) in your profile ( 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 Avdump3 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.
Note If there are external subtitle files with a release, they should be added in a separate batch to any video files. The same goes for files with different numbers of tracks, such as unsubtitled OP/ED files.
  • 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.