Shadow Files: Difference between revisions

From AniDB
Jump to navigation Jump to search
mNo edit summary
mNo edit summary
 
(13 intermediate revisions by 7 users not shown)
Line 1: Line 1:
<div style="font-size: 110%; text-align: center; background: #ffaaaa; margin: .5em 10%; padding: 0.2em 1em; border: #aaaaaa 1px solid;">Note: This page is for a so far nonexistent feature of AniDB.<br>It is only meant to provide information for those who have never heard of it before.</div>
<div style="font-size: 110%; text-align: center; background: #ffaaaa; margin: .5em 10%; padding: 0.2em 1em; border: #aaaaaa 1px solid;">Note: This page is for a so far only partially implemented feature of AniDB.<br>It is only meant to provide information for those who have never heard of it before.</div>
{{TOCright}}
{{TOCright}}
==Why==
==Why==
AniDB is built around files, and the basic structure of anidb assumes that each file will contain one episode. This is often not true, in two variations: split-episode files, and multi-episode files. Also there is the case of separate subtitle files.
AniDB is built around files, and the basic structure of AniDB assumes that each file will contain one episode. This is often not true, in two variations: split-episode files, and multi-episode files. Also there is the case of separate subtitle files.


==How==
==How==
Line 12: Line 13:
==More details==
==More details==
===Split episodes===
===Split episodes===
The most common occurence of this are movies: almost every movie added the anidb will have several different versions released by different groups, some will only be one single file released, but some will be released as part 1 and 2 of 2, or even part 1, 2 and 3 of 3. With shadow-files all the files would be under the same "Complete Movie" entry, and when you select to get a version that is split into multiple files, you would see that it has more than one file, and be able to get each of the files you needed.
The most common occurrence of this are movies: almost every movie added the AniDB will have several different versions released by different groups, some will only be one single file released, but some will be released as part 1 and 2 of 2, or even part 1, 2 and 3 of 3. With shadow-files all the files would be under the same "Complete Movie" entry, and when you select to get a version that is split into multiple files, you would see that it has more than one file, and be able to get each of the files you needed.


===Multiple episodes===
===Multiple episodes===
This happens alot when series air 2 episodes at the same time; there is normally not a separate opening/ending, and the episodes flow seamlessly into eachother. If you add one of these files, when shadow-files are implemented, all episodes that are contained in the file will get added to your mylist even though you only have 1 actual file. Also, for animes that end in these kind of special episodes, the groups' status will change to '''completed''' instead of ''stalled'' as they are now.<br><small>''[[Groupentries:Status|further information]]''</small>
This happens a lot when series air 2 episodes at the same time; there is normally not a separate opening/ending, and the episodes flow seamlessly into each other. If you add one of these files, when shadow-files are implemented, all episodes that are contained in the file will get added to your MyList even though you only have 1 actual file. Also, for anime that end in these kind of special episodes, the groups' status will change to '''completed''' instead of ''stalled'' as they are now.
:''...[[Groupentries:Status|further information]]''


===Separate subtitles===
===Separate subtitles===
Very often movies will first be released as RAWs without subtitles, then afterwards, subtitles may be provided; but you can't be sure which RAW the subtitles are made for. The wrong raw for the wrong subtitles will most likely make the subtitles out of sync. With shadow-files you would be able to add the raws and the subtitle files to the correct shadow-file(s) in order to group them together in a logical way.
Very often movies will first be released as RAWs without subtitles, then afterwards, subtitles may be provided; but you can't be sure which RAW the subtitles are made for. The wrong raw for the wrong subtitles will most likely make the subtitles out of sync. With shadow-files you would be able to add the RAWs and the subtitle files to the correct shadow-file(s) in order to group them together in a logical way.


===Illustrations===
Here I have made some (crap) illustrations to further illuminate how it works, and what the differences are:
<center>
{| cellspacing=0 width=85%
|colspan=2 style="border-bottom: 1px solid;"|
|-
!Current (without shadow-files)
!style="border-left:1px solid;" width=50%|With shadow-files
|-
!colspan=2 style="border-top: 1px solid; border-bottom: 1px solid;"|Normal files
|-
|valign=bottom style="padding-right: 5px;"|[[Image:Current-normal.png|frame|none]]
|valign=bottom style="border-left:1px solid; padding-left: 5px;"|[[Image:Shadow-normal.png|frame|none]]
|-
|valign=top style="padding-right: 5px;"|Currently it works like this for normal files and episodes.
|valign=top style="border-left:1px solid; padding-left: 5px;"|With shadow-files, the episode would link to the shadow-file and the shadow-file would link to the real file. Note that the shadow-files are transparent here - you will not notice a difference.
|-
!colspan=2 style="border-top: 1px solid; border-bottom: 1px solid;"|Multi-episode files
|-
|valign=bottom style="padding-right: 5px;"|[[Image:Current-multi.png|frame|none]]
|valign=bottom style="border-left:1px solid; padding-left: 5px;"|[[Image:Shadow-multi.png|frame|none]]
|-
|valign=top style="padding-right: 5px;"|Currently if the file you have has multiple episodes in it, you need to add a generic file for the other episodes if you want to keep your MyList correct.
|valign=top style="border-left:1px solid; padding-left: 5px;"|With shadow-files, you would only add the file you have, and both episodes would be added to your MyList.
|-
!colspan=2 style="border-top: 1px solid; border-bottom: 1px solid;"|Split-episode files
|-
|valign=bottom style="padding-right: 5px;"|[[Image:Current-split.png|frame|none]]
|valign=bottom style="border-left:1px solid; padding-left: 5px;"|[[Image:Shadow-split.png|frame|none]]
|-
|valign=top style="padding-right: 5px;"|Currently if an episode or movie is released in many files, you would have to add each of those files to your MyList, and if they are not part of the regular episodes (i.e., listed as "<tt>O1 Episode 1 (Part 1 of 2)</tt>" and "<tt>O2 Episode 1 (Part 2 of 2)</tt>"), you would also need to add a generic file separately if you want your MyList to look like it should.
|valign=top style="border-left:1px solid; padding-left: 5px;"|With shadow-files all files would be associated with the correct episode.
|-
!colspan=2 style="border-top: 1px solid; border-bottom: 1px solid;"|Separate subtitles for one episode
|-
|valign=bottom style="padding-right: 5px;"|[[Image:Current-subs-normal.png|frame|none]]
|valign=bottom style="border-left:1px solid; padding-left: 5px;"|[[Image:Shadow-subs-normal.png|frame|none]]
|-
|valign=top style="padding-right: 5px;"|Right now, subs and RAWs are added separately to each episode, and you need to specify in a comment in the subfile which RAW it belongs to.
|valign=top style="border-left:1px solid; padding-left: 5px;"|With shadow-files you would add the subs and the RAWs to the same shadow-file, and they would be grouped together that way.
|-
!colspan=2 style="border-top: 1px solid; border-bottom: 1px solid;"|Separate subtitles for many episodes
|-
|valign=bottom style="padding-right: 5px;"|[[Image:Current-subs-manysubsinone.png|frame|none]]
|valign=bottom style="border-left:1px solid; padding-left: 5px;"|[[Image:Shadow-subs-manysubsinone.png|frame|none]]
|-
|valign=top style="padding-right: 5px;"|Currently, if you have a file with many subtitles in it, say a rar archive with subs for more than one episode, you need to add that to a Special "Other" episode "<tt>O1 Subtitles for episodes 1-2</tt>".
|valign=top style="border-left:1px solid; padding-left: 5px;"|With shadow-files, you would add those subs to each shadow-file associated with the correct RAW for each episode.
|-
|colspan=2 style="border-top: 1px solid;"|
|}
</center>


==Current Workarounds==
==Current Workarounds==
;Split episodes:Currently for things like movies, when split files are released, they will get added to episode 2 and 3 (or 4, 5 and 6 in case of 3-file-splits).<br>However, if it is an OVA, this is sometimes not feasible, and it may get added to a special "Other" episode instead.<br><small>''[[Files:Split-episode_files|further information]]''</small>
;Split episodes:Currently for things like movies, when split files are released, they will get added to episode 2 and 3 (or 4, 5 and 6 in case of 3-file-splits).<br>However, if it is an OVA, this is sometimes not feasible, and it may get added to a special "Other" episode instead.
;Multiple episodes:The current workaround for split episodes is to add the file to the first episode that it contains, and add [[generic files]] to your mylist for the remaining episodes in the file instead.<br>For some OVAs though, there will be special "Other" episodes added named something like "O1 Episode 1-3" or something like that.<br><small>''[[Files:Multi-episode_files|further information]]''</small>
:''...[[Files:Split-episode files|further information]]''
;Separate subtitles:There are a few different cases of these:<br>'''1.''' One subtitle file for one episode: the file will most likely be added to the episode with a comment telling which RAW(s) it belongs to.<br>'''2.''' Several subtitlefiles in an archive of some sort: The file will be added to a special "Other" listed as something like "O1 Subtitles for episodes 1-5".<br><small>''[[Content:Subtitles|further information]]''</small>
 
;Multiple episodes:The current workaround for split episodes is to add the file to the first episode that it contains, and add [[generic files]] to your MyList for the remaining episodes in the file instead.<br>For some OVAs though, there will be special "Other" episodes added named something like "O1 Episode 1-3" or something like that.
:''...[[Files:Multi-episode files|further information]]''
 
;Separate subtitles:There are a few different cases of these:<br>'''1.''' One subtitle file for one episode: the file will most likely be added to the episode with a comment telling which RAW(s) it belongs to.<br>'''2.''' Several subtitle files in an archive of some sort: The file will be added to a special "Other" listed as something like "O1 Subtitles for episodes 1-5".
:''...[[Content:Subtitles|further information]]''


{{eyecatch|Note|Though not completely implementing Shadow Files, [[Content:File relations#File-Ep Relations|file<->ep]] and [[Content:File relations#File-File Relations|file<->file]] relations take care of some of the situations above, read the respective documentation for more information.}}


==Other resources==
==Other resources==
*http://tracker.anidb.info/view.php?id=113 - tracker entry
* {{t|113|tracker entry}}
*http://www.anidb.net/forum/viewtopic.php?t=621 - the original thread
* {{OldThreadLink|621|the original thread}}
*http://www.anidb.net/forum/viewtopic.php?t=1538 - further discussion
* {{OldThreadLink|1538|further discussion}}
*http://www.anidb.net/forum/viewtopic.php?t=3063 - more detail about multi-episode-files problem
* {{OldThreadLink|3063|more detail about multi-episode-files problem}}
 
[[Category:Development]]

Latest revision as of 21:10, 13 May 2009

Note: This page is for a so far only partially implemented feature of AniDB.
It is only meant to provide information for those who have never heard of it before.

Why

AniDB is built around files, and the basic structure of AniDB assumes that each file will contain one episode. This is often not true, in two variations: split-episode files, and multi-episode files. Also there is the case of separate subtitle files.

How

Basically, what shadow-files would do is create an extra layer over the files - the episodes would point to shadow-files, and the shadow-files would then point to the actual files, be it just one single file, or more than one. Also, the shadow-file can belong to more than one single episode.

When

Because it would change the underlying structure of AniDB this would require a total rewrite of the database. Therefore, it will not be done in the current version. When (and if) AniDB gets a complete rewrite, it will most likely be included from the start.

More details

Split episodes

The most common occurrence of this are movies: almost every movie added the AniDB will have several different versions released by different groups, some will only be one single file released, but some will be released as part 1 and 2 of 2, or even part 1, 2 and 3 of 3. With shadow-files all the files would be under the same "Complete Movie" entry, and when you select to get a version that is split into multiple files, you would see that it has more than one file, and be able to get each of the files you needed.

Multiple episodes

This happens a lot when series air 2 episodes at the same time; there is normally not a separate opening/ending, and the episodes flow seamlessly into each other. If you add one of these files, when shadow-files are implemented, all episodes that are contained in the file will get added to your MyList even though you only have 1 actual file. Also, for anime that end in these kind of special episodes, the groups' status will change to completed instead of stalled as they are now.

...further information

Separate subtitles

Very often movies will first be released as RAWs without subtitles, then afterwards, subtitles may be provided; but you can't be sure which RAW the subtitles are made for. The wrong raw for the wrong subtitles will most likely make the subtitles out of sync. With shadow-files you would be able to add the RAWs and the subtitle files to the correct shadow-file(s) in order to group them together in a logical way.

Illustrations

Here I have made some (crap) illustrations to further illuminate how it works, and what the differences are:

Current (without shadow-files) With shadow-files
Normal files
Currently it works like this for normal files and episodes. With shadow-files, the episode would link to the shadow-file and the shadow-file would link to the real file. Note that the shadow-files are transparent here - you will not notice a difference.
Multi-episode files
Currently if the file you have has multiple episodes in it, you need to add a generic file for the other episodes if you want to keep your MyList correct. With shadow-files, you would only add the file you have, and both episodes would be added to your MyList.
Split-episode files
Currently if an episode or movie is released in many files, you would have to add each of those files to your MyList, and if they are not part of the regular episodes (i.e., listed as "O1 Episode 1 (Part 1 of 2)" and "O2 Episode 1 (Part 2 of 2)"), you would also need to add a generic file separately if you want your MyList to look like it should. With shadow-files all files would be associated with the correct episode.
Separate subtitles for one episode
Right now, subs and RAWs are added separately to each episode, and you need to specify in a comment in the subfile which RAW it belongs to. With shadow-files you would add the subs and the RAWs to the same shadow-file, and they would be grouped together that way.
Separate subtitles for many episodes
Currently, if you have a file with many subtitles in it, say a rar archive with subs for more than one episode, you need to add that to a Special "Other" episode "O1 Subtitles for episodes 1-2". With shadow-files, you would add those subs to each shadow-file associated with the correct RAW for each episode.

Current Workarounds

Split episodes
Currently for things like movies, when split files are released, they will get added to episode 2 and 3 (or 4, 5 and 6 in case of 3-file-splits).
However, if it is an OVA, this is sometimes not feasible, and it may get added to a special "Other" episode instead.
...further information
Multiple episodes
The current workaround for split episodes is to add the file to the first episode that it contains, and add generic files to your MyList for the remaining episodes in the file instead.
For some OVAs though, there will be special "Other" episodes added named something like "O1 Episode 1-3" or something like that.
...further information
Separate subtitles
There are a few different cases of these:
1. One subtitle file for one episode: the file will most likely be added to the episode with a comment telling which RAW(s) it belongs to.
2. Several subtitle files in an archive of some sort: The file will be added to a special "Other" listed as something like "O1 Subtitles for episodes 1-5".
...further information
Note Though not completely implementing Shadow Files, file<->ep and file<->file relations take care of some of the situations above, read the respective documentation for more information.

Other resources