Make your own free website on Tripod.com
Magic File Renamer Help
Formatting Parameters

Formatting parameters can be used in MFR in any text box that accepts a format string. You should see a list of available formatting parameters to the right of the filter's customization panel when formatting parameters are available. Formatting parameters can be customized and added to the format string using ths tool, but can also be types manually into the format string.
Each formatting parameter (bounded between <..> will be parsed and replaced with a text literal) in the renaming process.

List of available formatting parameters:

Note: strings should be written as-is, without any quotas. When (bit) is specified near a field, 1 is for "ON" and "0" is for "OFF".

Full Name
<WN>
Full file name (Initial + Extension)



Name
<FN>
File name without extension (Initial only)



Extension
<EXT>
File's extension



Token
<TKN:token-num,sep-str,inc-next,work-on>
One of the substrings generated when seperating work-on string into tokens using a seperator string.
token-num: Index of token to retreive. First is 1.
sep-str: Seperator string used to seperate tokens.
inc-next: (bit) Retreive all tokens starting from token-num.
work-on: String to divide into tokens. Should be another legal format string.
Example:
<TKN:2,-,0,<FN>>    Avalanches_-_Frontier_Psychiatrist.mp3 --> _Frontier_Psychiatrist



Substring
<SUB:start-pos,end-pos,work-on>
A substring of work-on string.
start-pos: Index of character to start copying from. A negative value means that index will be counted from the end of the string.
sep-str: Index of character to end copying in. A negative value means that index will be counted from the end of the string.
work-on: String to extract substring from. Should be another legal format string.
Example:
<sub:-1,-2,<EXT>>    test.backup --> up



Folder
<P[:n]>
File's parent folder at level n. In n is not specified, default level is 1.
Example:
<p>    c:\Family\1999\johnny.jpg --> 1999
<p:2>    c:\Family\1999\johnny.jpg --> Family



Drive
<P[:n]>
Drive letter for the disk where the file is located.
Example:
<DRV>    c:\games\pacman --> C



Disk Label
<LBL>
Drive's label for the disk where the file is located.



Date
<DT[:date-format-string]>
File's date. Date format can be altered using the date-format-string. See Date/Time Format String Guide.
Example:
<DT:mm-yy>    file.ext --> h-98



Time
<DT[:date-format-string]>
File's time. Time format can be altered using the date-format-string. See Date/Time Format String Guide.
Example:
<TM:h-nn>    file.ext --> 16-59



Size
<SZ[:size-measuring-unit-specifier[,digits-after-decimal-point]]>
File's size.
size-measuring-unit-specifier: Unit for measuring file size.
A: Automatic (unit will be selected according to file's size, and unit sign will be added automatically. This is default if size-measuring-unit-specifier is not specified.
B: Bytes (B).
K: Kilobytes (KB).
M: Megabytes (MB).
G: Gigabytes (GB).
digits-after-decimal-point: Number of digits to add after decimal point. Default is 2. Maximum is 18.

Example:
<SZ>     (as <SZ:A,2>)
<SZ:B>    (as <SZ:B,2>)
<SZ:K,3>



Counter
<SN[:start-from,[inc-by,[leading-zeros-style,[reset-on-dirs],[total-length]]]]]>
A counter (serial number). Files will be numbered by the order they appears is the rename list. You can manipulate rename list order by dragging filenames within the rename list (when auto-order is off).
start-from: Number to start counting from. Can be negative. will be assigned to the first filename in the rename list. Default value is 1.
inc-by: Value to increase counter for each filename. Can be negative. Default value is 1.
leading-zeros-style: A digit that determines leading-zeros style for the counter.
0: None - no leading zeros will be added (default).
1: Auto - number of leading zeros will be fixed automatically. In this state, reset-on-dirs is unavailable.
2: Custom - Number of leading zeros is fixed by the next parameter, total-length.
reset-on-dirs: (bit). Reset counter when switching folders. If 1, counter will be resetted to start-from value if current file path is different from previous file path. Available when leading-zeros-style is not Automatic.
total-length: Length of numbers in the counter. Leading zeros will be added to shorter numbers. This is applicable only when leading-zeros-style is Custom. Default is 2.

Example:
<SN>     (as <SN:1,1,0,0,2>)
<SN:3,-1,1>
<SN:1,1,2,1,3>



Name List Entry
<NL:name-list-file-path>
An entry (row) in a name list file. Name list file is a text file in which each row is an entry.

Example:
<NL:c:\temp\names.txt>



Random Char
<RND[:range-start,range-end]>
A random character from a custom range of characters. Default range is A..Z.
range-start: A character to start range from. Should have the lower ASCII value in range.
range-end: A character to end range in. Should have the higher ASCII value in range.

Example:
<RND>
<RND:1,9>
<RND:a,z>



MP3 specific formatting parameters:

Duration
<MP3_DURATION[:unit-seperator]>
Duration of a MP3 file. Time measuring unit will be fixed automatically, and a unit sign will be added.
unit-seperator: A string which will be used to seperate hours, minutes and seconds. Can be empty. Default is ' .

Example:
<MP3_DURATION>
<MP3_DURATION:>
<MP3_DURATION:->



<MP3_BITRATE> Bitrate in K
<MP3_CHANNEL> Channel mode (mono, stereo..)
<ID3V1:ARTIST> Artist name from the ID3v1 tag
<ID3V1:TITLE> Song title from the ID3v1 tag
<ID3V1:ALBUM> Album name from the ID3v1 tag
<ID3V1:YEAR> Year from the ID3v1 tag
<ID3V1:GENRE> Genre name from the ID3v1 tag
<ID3V1:COMMENT> Comment from the ID3v1 tag.
<ID3V1:TRACK> Track number from the ID3v1.1 tag.
<ID3V2:TPE1> Artist name from the ID3v2 tag
<ID3V2:TIT2> Song title from the ID3v2 tag
<ID3V2:TALB> Album name from the ID3v2 tag
<ID3V2:TYER> Year from the ID3v2 tag
<ID3V2:TCON> Genre name from the ID3v2 tag
<ID3V2:COMM> Comment from the ID3v2 tag
<ID3V2:TRCK> Track # from the ID3v2 tag
<ID3V2:Txxx> Specific text field from ID3v2 tag frame (field).
Txxx is the wanted frame. For a full list of text frames supported in ID3v2 press here.
Example: <TCOM> will result the 'Composer' field in ID3v2 tag.



Date/Time Format String Guide:

The following format specifiers are supported:

d Displays the day as a number without a leading zero (1-31)
dd Displays the day as a number with a leading zero (01-31)
ddd Displays the day as an abbreviation (Sun-Sat)
dddd Displays the day as a full name (Sunday-Saturday)
dddddd Displays the date in long date format
m Displays the month as a number without a leading zero (1-12).
If the m specifier immediately follows an h or hh specifier, the minute rather than the month is displayed.
mm Displays the month as a number with a leading zero (01-12).
If the mm specifier immediately follows an h or hh specifier, the minute rather than the month is displayed.
mmm Displays the month as an abbreviation (Jan-Dec)
mmmm Displays the month as a full name (January-December)
yy Displays the year as a two-digit number (00-99).
yyyy Displays the year as a four-digit number (0000-9999).
   
h Displays the hour without a leading zero (0-23).
hh Displays the hour with a leading zero (00-23).
n Displays the minute without a leading zero (0-59).
nn Displays the minute with a leading zero (00-59).
s Displays the second without a leading zero (0-59).
ss Displays the second with a leading zero (00-59).
t Displays the time in short format.
tt Displays the time in long format.
am/pm ses the 12-hour clock for the preceding h or hh specifier, and displays 'am' for any hour before noon, and 'pm' for any hour after noon. The am/pm specifier can use lower, upper, or mixed case, and the result is displayed accordingly.
a/p Uses the 12-hour clock for the preceding h or hh specifier, and displays 'a' for any hour before noon, and 'p' for any hour after noon. The a/p specifier can use lower, upper, or mixed case, and the result is displayed accordingly.
ampm Uses the 12-hour clock for the preceding h or hh specifier, and displays AM for any hour before noon, and PM for any hour after noon.



Format specifiers may be written in upper case as well as in lower case letters--both produce the same result.


ID3V2.3.0 Text Frames:

TALB Album/Movie/Show title
TBPM BPM (beats per minute)
TCOM Composer
TCON Content type
TCOP Copyright message
TDAT Date
TDLY Playlist delay
TENC Encoded by
TEXT Lyricist/Text writer
TFLT File type
TIME Time
TIT1 Content group description
TIT2 Title/songname/content description
TIT3 Subtitle/Description refinement
TKEY Initial key
TLAN Language(s)
TLEN Length
TMED Media type
TOAL Original album/movie/show title
TOFN Original filename
TOLY Original lyricist(s)/text writer(s)
TOPE Original artist(s)/performer(s)
TORY Original release year
TOWN File owner/licensee
TPE1 Lead performer(s)/Soloist(s)
TPE2 Band/orchestra/accompaniment
TPE3 Conductor/performer refinement
TPE4 Interpreted, remixed, or otherwise modified by
TPOS Part of a set
TPUB Publisher
TRCK Track number/Position in set
TRDA Recording dates
TRSN Internet radio station name
TRSO Internet radio station owner
TSIZ Size
TSRC ISRC (international standard recording code)
TSSE Software/Hardware and settings used for encoding
TYER Year
TXXX User defined text information frame

[Index]