NOTE: This is the help page from Métamorphose 1, it is only
provided here to give a general idea of usage, and the actual program WILL be
different!!
The Main tab is where renaming operations are set.
You must make changes here to do any renaming.
[Buttons]
[Order of Operations]
[Renaming Fields:
Search & Replace/Modify/Move Insert Modify length]
BUTTONS:
The buttons work by inserting a bit of text in a text field. When the Preview
button is clicked, the text will be turned into an operation. For example, activating the
Prefix field and clicking on the date button, makes the text ':date:' appear
in the field, which is then turned into today's date when renaming the item(s). This
allows for great flexability, as you can mix and match operations and text. So if you
wanted to have a seperator between the prefix and the original filename, after pressing
the button type '_', the field now contains ':date:_', and assuming today is
august 6, 1223, the files will be renamed as such: 08-06-1223_file.ext
You may put as many operations and text as you want, so long as the item name doesn't go
over 255 characters. So something like this is perfectly valid:
:numb:_some text_:date:_:time:_:track:-:performer:-:title:

The numbering button inserts an auto numbering sequence. By default,
numbering starts at 1, increments by 1, and is 0 padded to the largest
number (so if there's 100 items, will count 001, 002, etc..). You can change
all these settings and more in the Numbering tab.

The Date and Time buttons insert a pre-formated date or time,
respectively. Default formating for date is: MM-DD-YYYY, time is: HH.MM.SS
(12 hour format). Both will use current date/time. To change settings use the
Date and Time tab.

The ID3 button will insert ID3 information retrieved from the .mp3 file.
I say 'the' file because it will look at each file and get its information. You
can select which section you want by using the dropdown menu. If an mp3 file is missing
the information you request, a blank space will be put in. Other file types and folders
are ignored.
ORDER OF OPERATIONS:
The order in which the different operations are executed within the application. Different
from the interface's order (but much more logical, no?), so I thought I would list it here.
- Length Modification
- Search and Replacement / Modification / Move
- Prefix
- Suffix
- File Extension
- Insertion
RENAMING FIELDS:
This is the inner heart of Métamorphose. You must make changes here to do any renaming.

These checkboxes let you specify which part of an item will be modifyed. If
'name' is checked, the folder and file names will be acted upon. If extension
is checked file extensions will be modified.

This allows to add a directory (folder) to place all the renamed items into. You can
add sub-folders with the 'sub-dir' button. You may use all the other buttons
described above in this field as well.

Add a prefix to the item.

Add a suffix to the item.

A very powerful tool to search names and then modify the match in some way. Most
operations are done using this. You can search a name for a certain text, using a
regular expression, or by position. You can then replace this text completly, change
its case, or move it to another location.

The text to search for. You may enter in any character, so to seach for a space,
simply press the spacebar. If this field is left blank than the entire name is matched.

Makes the text search case-sensitive.

Search for a regular expression. Every match will be acted upon. Having I checked
makes the search case insensitive, U matches in Unicode mode (to match non-ascii
characters such as 'é' with things like \w).

Search for a regular expression character set. ^ will match any character NOT in the set,
[a-z] matches all alpabetical characters (upper AND lower case), and [0-9] matches all
numbers.
You may use these without defining a regular expression. Otherwise the RE is compiled as such:
'(regular expression) | (character sets)'.
Also [a-z] is not really '[a-z]', it is '[^\W\d]' for proper matching in Unicode mode.

Click this to see a regular expression quick reference. You can keep the help window open and still
access the main program.

Search by position. The first number is where to start searching from. 0 is always the first character
in the name.

How many characters to match. Don't worry if the amount of characters exceeds the length of the name.

Determine wether to match from the begining of the name or the end. If by end, then
the Position value is automatically changed according to the Length.

Replace each match with the specified text or operation. If using regular expressions, you can use
backreferences (i.e. type in "\1" without the quotes).

Modify the case of each match.

Move the first match to a position.

Use a fixed position. 0 makes the match the first character of the name, -1 the last.

Use a specified text as the location of the move. You can set wether to put the match before or
after, or to replace this text. If no match is found, nothing is done. Use of regular expressions
is also permited.
|

Use these to insert text or an operation at a specified point in the name.

Specify an absolute point to insert into. Starts at 0 and wraps around, so 0 = first character,
1 = second character, -1 last character.
|

Change the length of the name in various ways.

How to modify the length. Pad will increase the length up to a given size, Cut will shorten it,
and Both, well, does both.

Change the length to this size. If you are using only Pad and the name is this size or longer,
or if a name is shorter than this and you are using Cut, then nothing is done. Using Both
will make all names eactly this size, whatever the means.

Direction for the modification.

This is the character to use for the padding. You can use any character your computer can work with.

Allows setting a specific point to insert the padding. If left at 0, then it will be the first character
of the chosen direction. If anything other than 0, it will work just like insert at position
(1 = second charcater, -1 = last character), ignoring the direction completly.
|