AniDB O'Matic - Documentation: Local file renaming: Difference between revisions

m
→‎E / EPISODE: fandubs are normal eps with audio track type fandub
m (→‎E / EPISODE: fandubs are normal eps with audio track type fandub)
 
(91 intermediate revisions by 3 users not shown)
Line 7: Line 7:
File extensions are automatically added to the end of the pattern.
File extensions are automatically added to the end of the pattern.


==Sample patters==
==Sample patterns==
{|
'''English anime title with fallback'''
|- valign="top"
<pre>
|English anime title with<br> fallback||<code>set('atitle', at('en'))<br>if(length(atitle)=0, set('atitle', at('x-jat')))<br>if(length(atitle)=0, set('atitle', at('x-jat', 'short')))<br>if(length(atitle)=0, set('atitle', at('ja')))</code>
set('atitle', at('en'))
|- valign="top"
if(length(atitle)=0, set('atitle', at('x-jat')))
|Japanese transcription anime<br> title with fallback||<code>set('atitle', at('x-jat'))<br>if(length(atitle)=0, set('atitle', at('x-jat', 'short')))<br>if(length(atitle)=0, set('atitle', at('en')))</code>
if(length(atitle)=0, set('atitle', at('ja')))
|- valign="top"
if(length(atitle)=0, set('atitle', A.Name))
|Japanese kanji anime title<br> with fallback||<code>set('atitle', at('ja'))<br>if(length(atitle)=0, set('atitle', at('x-jat')))<br>if(length(atitle)=0, set('atitle', at('x-jat', 'short')))<br>if(length(atitle)=0, set('atitle', at('en')))</code>
</pre>
|- valign="top"
'''Japanese transcription anime title with fallback'''
|English episode title with<br> fallback||<code>set('etitle', et('en'))<br>if(length(etitle)=0, set('etitle', et('x-jat')))<br>if(length(etitle)=0, set('etitle', et('ja')))</code>
<pre>
|- valign="top"
set('atitle', at('x-jat'))
|Japanese transcription episode<br> title with fallback||<code>set('etitle', et('x-jat'))<br>if(length(etitle)=0, set('etitle', et('en')))</code>
if(length(atitle)=0, set('atitle', at('en')))
|- valign="top"
if(length(atitle)=0, set('atitle', A.Name))
|Japanese kanji episode title<br> with fallback||<code>set('etitle', et('ja'))<br>if(length(etitle)=0, set('etitle', et('x-jat')))<br>if(length(etitle)=0, set('etitle', et('en')))</code>
</pre>
|- valign="top"
'''Japanese kanji anime title with fallback'''
|File version||<code>set('version', if(F.Version>1, 'v'+F.Version, ''))</code>
<pre>
|- valign="top"
set('atitle', at('ja'))
|Padded episode number||<pre>set('mepno', max(A.TotalEpisodeCount, E.EpisodeTypeCount))
if(length(atitle)=0, set('atitle', at('x-jat')))
if(length(atitle)=0, set('atitle', at('en')))
if(length(atitle)=0, set('atitle', A.Name))
</pre>
'''English episode title with fallback'''
<pre>set('etitle', et('en'))
if(length(etitle)=0, set('etitle', et('x-jat')))
if(length(etitle)=0, set('etitle', et('ja')))
if(length(etitle)=0, set('etitle', E.Name))
</pre>
'''Japanese transcription episode title with fallback'''
<pre>
set('etitle', et('x-jat'))
if(length(etitle)=0, set('etitle', et('en')))
if(length(etitle)=0, set('etitle', E.Name))
</pre>
'''Japanese kanji episode title with fallback'''
<pre>
set('etitle', et('ja'))
if(length(etitle)=0, set('etitle', et('x-jat')))
if(length(etitle)=0, set('etitle', et('en')))
if(length(etitle)=0, set('etitle', E.Name))
</pre>
'''File version and censor flag
<pre>
set('censored', 'unknown')
set('version', F.Version)
set('state_map', F.State mod 4096)
if(state_map>=2048, set('version', 9) + set('state_map', state_map - 2048))
if(state_map>=1024, if(version<9,set('version', 8)) + set('state_map', state_map - 1024))
if(state_map>=512, if(version<9,set('version', 7)) + set('state_map', state_map - 512))
if(state_map>=256, if(version<9,set('version', 6)) + set('state_map', state_map - 256))
if(state_map>=128, set('censored', 'yes') + set('state_map', state_map - 128))
if(state_map>=64, set('censored', 'no') + set('state_map', state_map - 64))
set('version', if(version>1, 'v'+F.Version, ''))
set('censored',if(censored='yes','[Censored]',''))
</pre>
'''Padded episode number'''
<pre>
set('mepno', if(E.TypeId=1, max(A.TotalEpisodeCount, E.EpisodeTypeCount), E.EpisodeTypeCount))
set('epno', padl(E.EpisodeNo, max(1, length(mepno)), '0'))
set('epno', padl(E.EpisodeNo, max(1, length(mepno)), '0'))
if(E.TypeId=2, set('epno', 'S'+epno))
if(E.TypeId=2, set('epno', 'S'+epno))
Line 30: Line 69:
if(E.TypeId=4, set('epno', 'T'+epno))
if(E.TypeId=4, set('epno', 'T'+epno))
if(E.TypeId=5, set('epno', 'P'+epno))
if(E.TypeId=5, set('epno', 'P'+epno))
if(E.TypeId=6, set('epno', 'O'+epno))</pre>
if(E.TypeId=6, set('epno', 'O'+epno))
|- valign="top"
</pre>
|First letter for organizing<br>by letter||<code>set('head', copy(atitle, 1, 1))<br>if(numeric(head), set('head', '0-9'))</code>
'''First letter for organizing by letter'''
|- valign="top"
<pre>
|Group name||<code>set('groupname', if(F.GroupId>0, if(length(G.Name)>0, G.Name, G.Shortname), 'no group'))<br>set('groupname', if(length(groupname)>0, '['+groupname+']'))</code>
set('head', copy(atitle, 1, 1))
|- valign="top"
if(numeric(head), set('head', '0-9'))
|Group short name||<code>set('groupname', if(F.GroupId>0, if(length(G.Shortname)>0, G.Shortname, G.Name), 'no group'))<br>set('groupname', if(length(groupname)>0, '['+groupname+']'))</code>
</pre>
|- valign="top"
'''Group name'''
|CRC32||<code>set('crc', '('+uc(H.Crc32)+')')</code>
<pre>
|-
set('groupname', if(G, if(length(G.Name)>0, G.Name, G.Shortname), 'no group'))
|}
set('groupname', if(length(groupname)>0, '['+groupname+']'))
</pre>
'''Group short name'''
<pre>
set('groupname', if(G, if(length(G.Shortname)>0, G.Shortname, G.Name), 'no group'))
set('groupname', if(length(groupname)>0, '['+groupname+']'))
</pre>
'''CRC32'''
<pre>
set('crc', if(H, H.Crc32, F.Crc))
if(length(crc)>0, set('crc', '('+uc(crc)+')')
</pre>
'''Current filename (removing the path)'''
<pre>set('path_filename', PATH)
set('path_parts', 1)
for('i', 1, length(path_filename), if(copy(path_filename, i, 1) = '\', set('path_parts', path_parts+1)))
set('path_filename', split(path_filename, '\', path_parts))</pre>
===Complex samples===
See [[AniDB O'Matic - Documentation: Local file renaming - Samples | the article with samples]]


==Default pattern==
==Default pattern==
<code><pre>set('atitle', at('x-jat'))
 
if(length(atitle)=0, set('atitle', at('x-jat', 'short')))
'''ATTENTION!''' The default pattern has a bug. See below for instructions to fix it.
<pre>set('atitle', at('x-jat'))
if(length(atitle)=0, set('atitle', at('en')))
if(length(atitle)=0, set('atitle', at('en')))
if(length(atitle)=0, set('atitle', A.Name))
set('atitle', replace(atitle, '\', ' '))
set('etitle', et('en'))
set('etitle', et('en'))
if(length(etitle)=0, set('etitle', et('x-jat')))
if(length(etitle)=0, set('etitle', et('x-jat')))
if(length(etitle)=0, set('etitle', et('ja')))
if(length(etitle)=0, set('etitle', et('ja')))
set('version', if(F.Version>1, 'v'+F.Version, ''))
if(length(etitle)=0, set('etitle', E.Name))
set('etitle', replace(etitle, '\', ' '))
set('version', if(F.Version&gt;1, 'v'+F.Version, ''))
set('mepno', max(A.TotalEpisodeCount, E.EpisodeTypeCount))
set('mepno', max(A.TotalEpisodeCount, E.EpisodeTypeCount))
set('epno', padl(E.EpisodeNo, max(1, length(mepno)), '0') + version)
set('epno', padl(E.EpisodeNo, max(1, length(mepno)), '0') + version)
Line 57: Line 119:
if(E.TypeId=5, set('epno', 'P'+epno))
if(E.TypeId=5, set('epno', 'P'+epno))
if(E.TypeId=6, set('epno', 'O'+epno))
if(E.TypeId=6, set('epno', 'O'+epno))
set('crc', '('+uc(H.Crc32)+')')
set('groupname', if(G, if(length(G.Shortname)>0, G.Shortname, G.Name), 'no group'))
atitle + ' - ' + epno + ' - ' + etitle + ' ' + groupname + crc + '.' + F.FileType
set('groupname', if(length(groupname)>0, '['+groupname+']'))
</pre></code>
set('groupname', replace(groupname, '\', ' '))
set('crc', if(H, H.Crc32, F.Crc))
if(length(crc)>0, set('crc', '('+uc(crc)+')'))
set('filename', limit(limit(limit(atitle, 90) + ' - ' + epno + ' - ' + etitle, 200) + ' ' + groupname, 235) + crc + '.' + F.FileType)
set('filename', replace(filename, '*', ' '))
set('filename', replace(filename, '/', ' '))
set('filename', replace(filename, '?', ' '))
set('filename', replace(filename, ':', ' '))
set('filename', replace(filename, '"', ' '))
set('filename', replace(filename, '&lt;', ' '))
set('filename', replace(filename, '&gt;', ' '))
set('filename', replace(filename, '|', ' '))
set('filename', replace(filename, '`', "'"))
set('filename', replace(filename, '  ', ' '))
filename
</pre>
'''ATTENTION!''' The default pattern has a bug. To fix it, find the following line:
<pre>set('mepno', max(A.TotalEpisodeCount, E.EpisodeTypeCount))</pre>
And replace it with:
<pre>set('mepno', if(E.TypeId=1, max(A.TotalEpisodeCount, E.EpisodeTypeCount), E.EpisodeTypeCount))</pre>


==Objects==
==Objects==
Line 65: Line 146:
===A / ANIME===
===A / ANIME===
{|
{|
|AnimeNFOId||integer||
! scope="col" width="180" | Name
|-
! scope="col" width="60" | Type
|AnimeNFOStr||string||
! scope="col" | Description
|-
|-valign=top
|Category||integer||
|Category||integer||Anime Type<br>
|-
1: Unknown<br>
|Date||integer||
2: TV Series<br>
|-
3: OVA<br>
|Description||string||
4: Movie<br>
|-
5: Other<br>
|Name||string||
6: Web<br>
|-
7: TV Special<br>
|PictureUrl||string||
8: Music Video
|-
|-valign=top
|Producer||string||
|CategoryStr||string||Category text value.
|-
|-valign=top
|ReviewAverage||integer||
|Name||string||Anime main title
|-
|-valign=top
|ReviewCount||integer||
|ReviewAverage||integer||Average review score
|-
|-valign=top
|TotalEpisodeCount||integer||
|ReviewCount||integer||Total number of reviews
|-
|-valign=top
|Updated||integer||
|TotalEpisodeCount||integer||Number of episodes according to AniDB. 0 if unknown.
|-
|-valign=top
|Url||string||
|VoteAverage||integer||Average voter score
|-
|-valign=top
|VoteAverage||integer||
|VoteCount||integer||Total number of votes
|-
|-valign=top
|VoteCount||integer||
|Year||string||Anime airing year(s). For example 2007-2008.
|-
|-valign=top
|Year||string||
|EpisodeCount||integer||Number of normal episodes according to AoM.
|-
|-valign=top
|EpisodeCount||integer||
|SpecialEpisodeCount||integer||Number of special episodes according to AoM.
|-
|-valign=top
|GenreCount||integer||
|DownloadState||String||Current download state according to AoM:<br>
|-
adsIgnore: not yet calculated<br>
|GenreString||string||
adsComplete: have all normal episodes<br>
|-
adsHaveAll: have all available normal episodes<br>
|SpecialEpisodeCount||integer||
adsIncomplete: have some of the available normal episodes<br>
|-
adsHaveNone: have no files in mylist for this anime
|CategoryStr||string||
|-valign=top
|-
|WatchedState||string||Current watched state according to AoM:<br>
|DownloadState||TAniDBAnimeDownloadState||
awsIgnore: not yet calculated<br>
|-
awsAll: All episodes watched<br>
|WatchedState||TAniDBAnimeWatchedState||
awsPartial: Some episodes watched<br>
|-
awsNone: No episodes watched
|StatusState||TAniDBAnimeStatusState||
|-valign=top
|-
|StatusState||string||Current status of mylist entries according to AoM, my contain multiple values separated by commas:<br>
|StartYear||integer||
assIgnore: not yet calculated<br>
assUnknown: Uknown<br>
assOnHDD: On HDD<br>
assOnCD: On CD<br>
assDeleted: Deleted
|-valign=top
|StartYear||integer||Numeric start year from AirDate.
|-valign=top
|EndYear||integer||Numeric end year from EndDate.
|-valign=top
|AirDate||integer||Air date in unix time, AniDB format.
|-valign=top
|EndDate||integer||End date in unix time, AniDB format.
|-valign=top
|Restricted||boolean||'''Unreliable''' True for hentai, otherwise false.
|-valign=top
|MylistCurrentEpisodeCount||integer||Number of episodes in mylist.
|-valign=top
|MylistSpecialEpisodeCount||integer||Number of special episodes in mylist.
|-valign=top
|WatchedCount||integer||Number of episodes watched.
|-valign=top
|SpecialWatchedCount||integer||Number of special episodes watched.
|}
|}


===E / EPISODE===
===E / EPISODE===
{|
{|
|Aired||integer||
! scope="col" width="180" | Name
|-
! scope="col" width="60" | Type
|AnimeId||integer||
! scope="col" | Description
|-
|-valign="top"
|Date||integer||
|AirDate||integer||Episode first air date.
|-
|-valign="top"
|EpisodeNo||integer||
|EpisodeNo||integer||AniDB episode number.
|-
|-valign="top"
|EpisodeStr||string||
|EpisodeStr||string||Episode number with type prefix.
|-
|-valign="top"
|EpisodeStrPadded||string||
|EpisodeStrPadded||string||Episode number with type prefix padded based on the total number of episodes of that particular type.
|-
|-valign="top"
|IsSpecial||boolean||
|EpisodeTypeCount||integer||Number of episodes in this anime with the same type.
|-
|-valign="top"
|Length||integer||
|IsSpecial||boolean||True if not a normal episode. False otherwise.
|-
|-valign="top"
|Name||string||
|Length||integer||Length in minutes.
|-
|-valign="top"
|Other||string||
|Name||string||AniDB main title.
|-
|-valign="top"
|Updated||integer||
|Other||string||Description field from AniDB.
|-
|-valign="top"
|TypeId||integer||
|TypeId||integer||Episode type:<br>
|-
1: Regular Episode<br>
|IsRecap||boolean||
2: Special<br>
3: Opening/Ending/Credits<br>
4: Trailer/Promo/Ads<br>
5: Parody<br>
6: Other
|-valign="top"
|IsRecap||boolean||True if episode is a recap.
|}
|}


===F / FILE===
===F / FILE===
{|
{|
|AnimeId||integer||
! scope="col" width="180" | Name
|-
! scope="col" width="60" | Type
|BitrateAudio||integer||
! scope="col" | Description
|-
|-valign="top"
|BitrateVideo||integer||
|Crc||string||AniDB CRC32 value.
|-
|-valign="top"
|Crc||string||
|CrcStatus||string||CRC32 status according to AnIDB:<br>
|-
crcUnknown: unkwnown<br>
|CrcStatus||TAniDBCRCStatus||
crcOk: known valid<br>
|-
crcInvalid: known invalid
|Date||integer||
|-valign="top"
|-
|Ed2k||string||AniDB ED2K value.
|Ed2k||string||
|-valign="top"
|-
|EpisodeStart||integer||Lowest related episode number of the same type within this anime.
|EpisodeId||integer||
|-valign="top"
|-
|EpisodeEnd||integer||Highest related episode number of the same type within this anime.
|FileType||string||
|-valign="top"
|-
|EpisodeList||string||List of episodes within this anime covered by this file.<br>Format: 1,2,3,7,17,93,O1,C3,U77
|GroupId||integer||
|-valign="top"
|-
|EpisodeListDetails||string||Detailed list of episodes covered by this file.<br>Format: (EpisodeStr:EpisodeTypeId:AnimeId:EpisodeId:StartPercent:EndPercent)<br>Example:
|LanguageId||integer||
1:1:357:95304:0:10,2:1:357:95960:0:100,6:1:357:108200:0:100,C1:3:357:108202:0:100
|-
|-valign="top"
|Length||integer||
|FileType||string||File extension.
|-
|-valign="top"
|Md5||string||
|Length||integer||File length in seconds.
|-
|-valign="top"
|Name||string||
|Md5||string||AniDB MD5 value.
|-
|-valign="top"
|Other||string||
|Other||string||File description.
|-
|-valign="top"
|QualityId||integer||
|Quality||integer||File quality, possible values:<br>
|-
unknown<br>
|Released||integer||
very high<br>
|-
high<br>
|ResolutionHeight||integer||
med<br>
|-
low<br>
|ResolutionWidth||integer||
very low<br>
|-
corrupted<br>
|Sha1||string||
eyecancer
|-
|-valign="top"
|Size||int64||
|Released||integer||Release date in unix time.
|-
|-valign="top"
|State||integer||
|ResolutionHeight||integer||'''Does not work''' Video height in pixels.
|-
|-valign="top"
|SubtitleId||integer||
|ResolutionWidth||integer||'''Does not work''' Video width in pixels.
|-
|-valign="top"
|TypeId||integer||
|Sha1||string||AniDB SHA1 value.
|-
|-valign="top"
|TypeState||integer||
|Size||int64||Size in bytes.
|-
|-valign="top"
|Updated||integer||
|State||integer||AniDB state bitmap.
|-
|-valign="top"
|UserCount||integer||
|Source||string||Source media, possible values:<br>
|-
unknown<br>
|UserCountRelease||integer||
camcorder<br>
|-
TV<br>
|UserCountShare||integer||
VHS<br>
|-
DTV<br>
|Version||integer||
LD<br>
|-
DVD<br>
|GroupShort||string||
SVCD<br>
|-
VCD<br>
|GroupLong||string||
HKDVD<br>
|-
www<br>
|DubLanguageString||string||
HDTV<br>
|-
HD-DVD<br>
|SubLanguageString||string||
Blu-ray
|-
|-valign="top"
|QualityString||string||
|TypeState||integer||Source ID.
|-
|-valign="top"
|ResolutionString||string||
|UserCount||integer||Number of users with this file. (Wildly inaccurate.)
|-
|-valign="top"
|TypeString||string||
|Version||integer||File version from state.
|-valign="top"
|GroupShort||string||Short group name.
|-valign="top"
|GroupLong||string||Long group name.
|-valign="top"
|ResolutionString||string||'''Does not work''' Video WidthxHeight.
|}
|}


===G / GROUP===
===G / GROUP===
{|
{|
|Email||string||
! scope="col" width="180" | Name
|-
! scope="col" width="60" | Type
|IrcChannel||string||
! scope="col" | Description
|-
|IrcServer||string||
|-
|Name||string||
|-
|Other||string||
|-
|Rating||integer||
|-
|Shortname||string||
|-
|Url||string||
|-
|-
|Votes||integer||
|colspan="3"|''Warning, this object might be unassigned. If so all values return False.''
|-valign="top"
|Name||string||Group name.
|-valign="top"
|Other||string||Group description.
|-valign="top"
|Rating||integer||Average vote rating for this group.
|-valign="top"
|Shortname||string||Short group name.
|-valign="top"
|Votes||integer||Number of votes for this group.
|}
|}


===H / HASH===
===H / HASH===
{|
{|
|Crc32||string||
! scope="col" width="180" | Name
|-
! scope="col" width="60" | Type
|Ed2k||string||
! scope="col" | Description
|-
|-valign="top"
|Md5||string||
|colspan="3"|''Warning, this object might be unassigned. If so all values return False.''
|-
|-valign="top"
|Sha1||string||
|Crc32||string||AoM CRC32 value.
|-
|-valign="top"
|Size||int64||
|Ed2k||string||AoM ED2K value.
|-
|-valign="top"
|FPS||double||
|Md5||string||AoM MD5 value.
|-
|-valign="top"
|Length||double||
|Sha1||string||AoM SHA1 value.
|-
|-valign="top"
|VideoFourCC||string||
|Size||integer||AoM size in bytes.
|-
|VideoCompression||string||
|-
|VideoCodec||string||
|-
|VideoHeight||integer||
|-
|VideoWidth||integer||
|-
|VideoBitrate||double||
|-
|VideoVBR||boolean||
|-
|AudioIdentCodec||integer||
|-
|AudioCodec||string||
|-
|AudioSamplerate||integer||
|-
|AudioBitrate||double||
|-
|AudioVBR||boolean||
|}
|}


===M / MYLIST===
===M / MYLIST===
{|
{|
|AnimeId||integer||
! scope="col" width="180" | Name
|-
! scope="col" width="60" | Type
|Date||integer||
! scope="col" | Description
|-
|-valign="top"
|EpisodeId||integer||
|colspan="3"|''Warning, this object might be unassigned. If so all values return False.''
|-
|-valign="top"
|FileId||integer||
|Other||string||Entry other/description text.
|-
|-valign="top"
|MylistId||integer||
|Source||string||Entry source text.
|-
|-valign="top"
|Other||string||
|State||integer||Entry state, possible values:<br>
|-
0: unknown<br>
|Source||string||
1: internal storage (hdd)<br>
|-
2: external storage (cd/dvd/...)<br>
|State||integer||
3: deleted<br>
|-
|-valign="top"
|Storage||string||
|Storage||string||Entry storage text.
|-
|-valign="top"
|Watched||boolean||
|Watched||boolean||True if watched, otherwise false.
|-
|-valign="top"
|WatchedDate||integer||
|WatchedDate||integer||Watched date in unixtime.
|}
 
==Properties==
 
{|
|-valign=top
|ACTIVEPATTERN||string||The current rename pattern after cleanup.
|-valign=top
|PATH||string||Current path to the file. May be ''.
|-valign=top
|BASEPATH||string||Base path of the current file manager. May be ''.
|}
|}


==Functions==
==Functions==
{|
{|
|at(lang[, type])||text||Returns an anime title of '''type''' and '''lang'''. '''type''' and '''lang''' can be either texts or numbers. If no type is specified, main and official are checked.<br>Example: at(2, 4) = official japanese title<br>Example: at('japanese (transcription)', 'main') = title shown in AoM<br>Example: at('en') = official english title
! scope="col" | Function
|-
! scope="col" width="60" | Type
! scope="col" | Description
|-valign="top"
|at(lang)||text||Returns a main/official anime title in '''lang'''. '''lang''' can be either a text or a number. <br>Example: at(2) = japanese title<br>Example: at('japanese (transcription)') = japanese transcription<br>Example: at('en') = english title
|-valign="top"
|atr(id, lang)||text||Returns a main/official anime title of anime with '''id''' in '''lang'''. '''lang''' can be either a text or a number. <br>Example: at(2) = japanese title<br>Example: at('japanese (transcription)') = japanese transcription<br>Example: at('en') = english title
|-valign="top"
|contains(find, text)||boolean||Returns true if '''find''' is found in '''text'''.<br>Example: contains('bcd', 'abcdef') = true
|contains(find, text)||boolean||Returns true if '''find''' is found in '''text'''.<br>Example: contains('bcd', 'abcdef') = true
|-
|-valign="top"
|copy(text, start[, length])||string||Returns '''length''' letters from letter number '''start''' of '''text'''.<br>Example: copy('abcdefgh', 3, 2) = 'cd'
|copy(text, start[, length])||string||Returns '''length''' letters from letter number '''start''' of '''text'''.<br>Example: copy('abcdefgh', 3, 2) = 'cd'
|-
|-valign="top"
|et(lang)||text||Returns an episode title in '''lang'''. '''lang''' can be either a text or a number.<br>Example: et(2) = japanese title<br>Example: et('en') = english title
|et(lang)||text||Returns an episode title in '''lang'''. '''lang''' can be either a text or a number.<br>Example: et(2) = japanese title<br>Example: et('en') = english title
|-
|-valign="top"
|etr(id, lang)||text||Returns an episode title of episode with '''id''' in '''lang'''. '''lang''' can be either a text or a number.<br>Example: et(2) = japanese title<br>Example: et('en') = english title
|-valign="top"
|for(name, start, end, task)||string||Runs '''task''' '''start''' to '''end''' times setting '''name''' to t1he current position each round.<br>Example: for('i', 1, 5, '?'+i) = '?1?2?3?4?5'
|-valign="top"
|function(name, stmt, stmt, ...)||string||Declares the function '''name''' which will execute stmt1, stmt2 etc. Parameters can be sent to function calls but there is only 1 GLOBAL scope.<br>Example: function('rreplace', set('temp', param1), for('i', 1, 10, set('temp', replace(temp, '&nbsp;&nbsp;', ' '))), temp)<br>rreplace(somevalue)
|-valign="top"
|getanime(name, id)||object||Sets the variable '''name''' to the anime object for '''id'''.<br>Example: getanime('a2', 78)
|-valign="top"
|getepisode(name, id)||object||Sets the variable '''name''' to the episode object for '''id'''.<br>Example: getepisode('e2', 8878)
|-valign="top"
|if(test, trueval[, falseval])||any||If statement, returns '''trueval''' if '''test''' is true, otherwise returns '''falseval'''.<br> Example: if(23=23, 'equal', 'not equal') = 'equal'
|if(test, trueval[, falseval])||any||If statement, returns '''trueval''' if '''test''' is true, otherwise returns '''falseval'''.<br> Example: if(23=23, 'equal', 'not equal') = 'equal'
|-
|-valign="top"
|in(find, text...)||boolean||Checks if '''find''' is present in a number of '''text''' parameters.<br>Example: in('bb', 'aa', 'bb', 'cc', 'dd') = true
|in(find, text...)||boolean||Checks if '''find''' is present in a number of '''text''' parameters.<br>Example: in('bb', 'aa', 'bb', 'cc', 'dd') = true
|-
|-valign="top"
|join(glue, text...)||string||Joins together two or more '''text'''s, empty parameters are ignored with no glue added.<br>Example: join(' ', 'a', 'b', 'c') = 'a b c'
|join(glue, text...)||string||Joins together two or more '''text'''s, empty parameters are ignored with no glue added.<br>Example: join(' ', 'a', 'b', 'c') = 'a b c'
|-
|-valign="top"
|lc(text)||string||Converts '''text''' to lower case.<br>Example: lc('ABCDEF') = 'abcdef'
|lc(text)||string||Converts '''text''' to lower case.<br>Example: lc('ABCDEF') = 'abcdef'
|-
|-valign="top"
|length(text)||number||Returns the length of '''text'''.<br>Example: length('abcdef') = 6
|length(text)||number||Returns the length of '''text'''.<br>Example: length('abcdef') = 6
|-
|-valign="top"
|limit(text, length[, end])||string||Limits the length of '''text''' to at most '''length''' characters. '''End''' is optional, if specified and the text is cropped, it'll be added at the end of text.<br>Example: limit(e, 100) or limit('abcdefghijklmnop', 7, '...') = 'abcd...'
|limit(text, length[, end])||string||Limits the length of '''text''' to at most '''length''' characters. '''End''' is optional, if specified and the text is cropped, it'll be added at the end of text.<br>Example: limit(e, 100) or limit('abcdefghijklmnop', 7, '...') = 'abcd...'
|-
|-valign="top"
|max(number...)||number||Returns the highest supplied number<br>Example: max(1, 7, 3, 9, 2) = 9
|-valign="top"
|min(number...)||number||Returns the lowest supplied number<br>Example: min(1, 7, 3, 9, 2) = 1
|min(number...)||number||Returns the lowest supplied number<br>Example: min(1, 7, 3, 9, 2) = 1
|-
|-valign="top"
|max(number...)||number||Returns the highest supplied number<br>Example: max(1, 7, 3, 9, 2) = 9
|-
|numeric(var)||boolean||Returns true if '''var''' contains a numeric value.<br>Example: numeric('11') = true
|numeric(var)||boolean||Returns true if '''var''' contains a numeric value.<br>Example: numeric('11') = true
|-
|-valign="top"
|pad(text)||string||Converts text to sentence case.<br>Example ?sc(a)
|pad(text, newlength[, padchar])||string||Pads '''text''' on both sides to make it '''length''' characters long.<br>Example ?pad('hello', 9, '_') = '__hello__'
|-
|-valign="top"
|padl(text)||string||Converts text to sentence case.<br>Example ?sc(a)
|padl(text, newlength[, padchar])||string||Pads '''text''' on the left side to make it '''length''' characters long.<br>Example ?padl('hello', 9, '_') = '____hello'
|-
|-valign="top"
|padr(text)||string||Converts text to sentence case.<br>Example ?sc(a)
|padr(text, newlength[, padchar])||string||Pads '''text''' on the right side to make it '''length''' characters long.<br>Example ?padr('hello', 9, '_') = 'hello____'
|-
|-valign="top"
|replace(text, find[, replace])||string||Replaces all occurences of '''find''' with '''replace''' in '''text'''.<br>Example: replace('HELLO THERE!', 'THERE', 'TREES') = 'HELLO TREES!'
|-valign="top"
|replacei(text, find[, replace])||string||Case insensitive replace of all occurences of '''find''' with '''replace''' in '''text'''.<br>Example: replace('HELLO tHeRe!', 'ThErE', 'TREES') = 'HELLO TREES!'
|-valign="top"
|sc(text)||string||Converts '''text''' to sentence case.<br>Example: sc('HELLO THERE!') = 'Hello there!'
|sc(text)||string||Converts '''text''' to sentence case.<br>Example: sc('HELLO THERE!') = 'Hello there!'
|-
|-valign="top"
|set(name, data)||nothing||Declares a new variable called '''name''' containing '''data'''.<br>Example: set('temp', 'text')
|set(name, data)||nothing||Declares a new variable called '''name''' containing '''data'''.<br>Example: set('temp', 'text')
|-
|-valign="top"
|split(text, find, index)||string||Splits '''text''' on '''find''' and returns the specified '''index'''. Index starts from 1.<br>Example: split('2011-05-19', '-', 2) = 05
|split(text, find, index)||string||Splits '''text''' on '''find''' and returns the specified '''index'''. Index starts from 1.<br>Example: split('2011-05-19', '-', 2) = 05
|-
|-valign="top"
|start(text, find)||boolean||Checks if '''find''' matches the start of '''text'''.<br>Example: start('1999', '199') = true
|start(text, find)||boolean||Checks if '''find''' matches the start of '''text'''.<br>Example: start('1999', '199') = true
|-
|-valign="top"
|starti(text, find)||boolean||Checks if '''find''' matches the start of '''text'''. Case insensitive.<br>Example: start('1999', '199') = true
|-valign="top"
|substr(text, start[, length])||string||Alias for copy.
|-valign="top"
|tc(text)||string||Converts '''text''' to title case.<br>Example: tc('HELLO THERE!') = 'Hello There!'
|tc(text)||string||Converts '''text''' to title case.<br>Example: tc('HELLO THERE!') = 'Hello There!'
|-
|-valign="top"
|trim(text)||string||Removes leading and trailing spaces from '''text'''.
|-valign="top"
|uc(text)||string||Converts '''text''' to upper case.<br>Example: uc('abcd') = 'ABCD'
|uc(text)||string||Converts '''text''' to upper case.<br>Example: uc('abcd') = 'ABCD'
|}
|}
Line 396: Line 524:
==Constant expressions==
==Constant expressions==
There are two ways to specify string literals:<br>
There are two ways to specify string literals:<br>
&#39;text&#39; - use &#39;&#39; to insert a &#39; (e.g. &#39;her&#39;&#39;s&#39;)<br>
&#39;text&#39;<br>
or<br>
or<br>
"text" - use \" to insert a "  (e.g. "a \"quotation\"")
"text"


Number literals are simply written as numbers:<br>
Number literals are simply written as numbers:<br>
Line 406: Line 534:
true<br>
true<br>
false
false
==Comments==
Start a line with // if you wish to write a comment:<br>
<pre>// This is a comment</pre>


==File managers==
==File managers==
File managers are used to automatically manage file renaming / removing and adding / updating files in your MyList.
File managers are used to automatically manage file renaming / removing and adding / updating files in your MyList.
===Source paths===
Each file manager can have multiple source folders. File managers can be set to search these folders recursively or only the folder itself for files.
While it's possible adding a source path to multiple file managers is strongly discouraged.
===Rename pattern===
Each file manager can have 1 renaming pattern. To use multiple patterns you need to specify multiple patterns. The rename pattern can contain a part of a path or a full path to indicate where the file should be stored. The path part of a rename might be ignored under certain circumstances however, see below.
===Target paths===
A file manager can have one or more target paths for moving files. If no target path is specified the folder the file was found in will be used instead. If there are multiple target paths the file manager will try to figure out where the file has the most related files. This is determined by a) the anime the file belongs to and b) the anime group the file belongs to. If there's not enough space available on the target drive it'll check the next preferred target if there's enough space and so on. If no space is available in any target path the file will be renamed in it's current location, but with any path part of the file removed, aka the filename part of the rename pattern will be used but the file will remain in the folder it was found in.
===Only move known files===
This will make the file manager ignore files which are not in AniDB, they'll be visible on the known files page, but they will never be moved or renamed.
===Automatically remove deleted files===
This will make the file manager remove files it can't find any more from the known files page. This rule ignores files stored on removable media.
===Don't remove files if the volume can't be found===
This will prevent the file manager from removing files it can't find when the whole volume is gone, this rule would for example prevent your known files from being cleared if your network cable is unplugged or a HDD is disconnected.
===Add new files to AniDB===
This will make the file manager automatically add found files to your MyList.
===Automatically update the storage field of MyList entries===
This will make the file manager automatically update the storage field of MyList entries based on the volume it's stored on. This field currently only works for files on a removable storage such as a DVD. The label used will be the label of the removable media, e.g. DVD #013.
===Automatically mark found files as OnHDD or OnRemovable in MyList===
This will make the file manager update your MyList to OnHDD if the file was found on a HDD or Network drive, or OnRemovable if the file is on a CD/DVD.
===Automatically mark removed files as Deleted in MyList===
This will make the file manager update your MyList to indicate the file has been deleted if removed by the above rule.
83

edits

MediaWiki spam blocked by CleanTalk.
MediaWiki spam blocked by CleanTalk.