den4b Wiki - User contributions [en]

ReNamer:Regular Expressions

2009-08-30T08:43:55Z

Krtek: replacing with , replacing (0x201C and 0x201D) quotes with normal (0x22)

{{Cleanup|
* Replace all span color highlights with custom '''hl-*''' classes found in [[MediaWiki:Common.css]].(krtek: probably already done)
* Replace all '''""''' (0x201C and 0x201D) quotes with normal '''""''' (0x22). (krtek: probably already done)
* Check for italized " (quotes) and make them normal. Especially ending quotes got italized or bolded.
* }}

Regular Expressions (RegEx) allow you to use precise search conditions, such as:

*Your search string ''must'' be located at the beginning (or at the end) of a line,
*The specified text must occur ''n'' times, etc.

RegEx expressions use '''$ . ^ { [ ( | ) * + ? \ ''' characters (called ''metacharacters'') in various combinations to specify all these conditions.The search engine ''interprets'' these metacharacters, rather than finding a literal match for them.

The RegEx search expression is called a "'''''RegEx pattern"''''', because a single expression can match a large number of actual text that has the specified ''pattern.'' For example, the RegEx pattern '''b?t''' matches with '''bat''', '''bet''', '''bit''', '''bot''' and '''but, '''etc.

Remember that RegEx strings are case-sensitive (The words''' cat''', ''' CAT''',''' cAt''', ''' Cat''', ''' caT''', ''' cAT''', ''' CAt '''and '''CaT '''are not equivalent).

Also, note that even the digits (0-9) are "numeric characters" for RegEx.

In this section, the RegEx expressions (patterns) are shown in '''bold orange'''. The target strings (which are compared with the RegEx expression for a possible match) are shown in '''bold black. '''A part of the target text is color-coded to provide a clue as to why a certain part matches ('''green''' color), or does not match ('''red''' color)

=== Simple (literal) matches ===

When the search string does not contain any metacharacters, the RegEx engine works like "normal" search. (it tries to find an exact copy of the search string.) (This is also known as "literal match").

If you want to find a literal match for a metacharacter, put a backslash '''\''' ''before'' it. (The '''\''' character is called "''escape character''", because it lets the metacharacter escape from its special duty, and lets it act as a normal character. Its combination with a metacharacter is called "''escape sequence''").

For example, metacharacter '''^''' matches the beginning of string, but '''\^''' matches the character '''^'''.

Note that the RegEx pattern '''\\''' matches the character '''\'''.

{| class="prettytable"
|-
| <center>'''RegEx pattern'''</center>
| <center>'''Matches-'''</center>
| <center>'''Remarks'''</center>
|-
| <center>'''foobar'''</center>
| <center>'''foobar'''</center>
| This RegEx pattern does not contain any metacharacters; so all characters are matched literally.
|-
| '''\^FooBarPtr'''
| <center>'''^FooBarPtr'''</center>
| The '''\^''' escape sequence searches for the character '''^''' ''literally'' .
|}

=== Escape sequences ===

We already saw one use of escape sequence (above).

Specific escape sequences are interpreted as special conditions, as listed below.

{| class="prettytable"
|-
| <center>'''RegEx pattern'''</center>
| <center>'''matches-'''</center>
|-
| <center>'''\xnn'''</center>
| Character represented by the hex code ''nn''
|-
| <center>'''\x{nnnn}'''</center>
| two bytes char with hex code nnnn (unicode)
|-
| <center>'''\t'''</center>
| tab (HT/TAB), same as \x09 (Hex 09)
|-
| <center>'''\n'''</center>
| new line (NL), same as \x0a (Hex 0a)
|-
| <center>'''\r'''</center>
| carriage return (CR), same as \x0d (Hex 0d)
|-
| <center>'''\f'''</center>
| form feed (FF), same as \x0c (Hex 0c)
|-
| <center>'''foo\x20bar'''</center>
| matches '''foo bar''' (note the space in the middle), but does ''not'' match '''foobar'''
|-
| <center>'''\tfoobar'''</center>
| matches '''foobar''' preceded by a tab (the tab is needed for the match)
|}

Note that the tab, new line, carriage return, and form feed are known as "white spaces". But RegEx can distinguish between them. This allows you to make high-precision searches.

=== Character Classes ===

A character class is a list of characters in square brackets '''[]''', which will match any one (and ''only one''-) character from the list.

Note that-

*The characters are not separated with a comma or a space.
*If you repeat any character in the list, it is considered only once (duplicates are ignored).
*A hyphen '''-''' is used to indicate range of characters.

{| class="prettytable"
|-
| <center>'''RegEx Pattern'''</center>
| <center>'''Remarks'''</center>
|-
| <center>'''[abdef]'''</center>
| Matches '''d''', '''e''', or '''f''' (only ''one'' character), but no other characters
|-
| <center>'''[c-m]'''</center>
| Matches any one (and only one) of the small alphabetical characters, from '''c''' to '''m'''
|-
| <center>'''[G-J]'''</center>
| Matches any one (and only one) of the capital alphabetical characters from '''G''' to '''J'''
|-
| <center>'''[a-zA-Z]'''</center>
| Matches any one (and only one) of the alphabetical characters (capital or small)
|-
| <center>'''[5-8]'''</center>
| Matches any one (and only one) of numerical characters from '''5''' to '''8'''
|-
| <center>'''[\n-\x0D]'''</center>
|
Matches any one (and only one) of '''#10''',''''' '''#11 ''',''''' #12 ''or '''''#13''' (Note the use of [[ReNamer:Regular Expressions#Simple_.28literal.29_matches|escape sequence]] inside a class)

|}

There are some special conditions:

*If you do not want any of the characters in the specified class, then place '''^''' at the very beginning of the list (RegEx interprets that as "none of the characters listed in this class").
*If you want '''[''' or ''']''' itself to be a member of a class, put it at the start or end of the list, or create a [[ReNamer:Regular Expressions#Simple_.28literal.29_matches|escape sequence]] (by putting '''\''' before it).

{| class="prettytable" style="width: 539px; height: 206px;"
|-
| <center>'''RegEx Pattern'''</center>
| <center>'''Remarks'''</center>
|-
| <center>'''[-az]'''</center>
| matches '''a'','''''z''', and '''-''' '''(since '''–''' is put at the beginning, the escape sequence is not needed)
|-
| <center>'''[a\-z]'''</center>
| matches '''a'','''''z''', and '''-''' ''' (since '''–''' is ''not'' at the beginning/end, the escape sequence ''is'' needed)
|-
| <center>'''[^0-9]'''</center>
| matches any ''non-digit'' character
|-
| <center>'''[]-a]'''</center>
| matches any character from ''']''' to '''a'''. (since '''] '''is at the beginning, the escape sequence ''is'' ''not'' needed)
|-
| <center>'''foob[aeiou]r'''</center>
| Matches with '''foob'''''a'''''r''', '''foob'''''e'''''r,''' etc. but not '''foob'''''b'''''r''', '''foob'''''c'''''r''', etc.
|-
| <center>'''foob[^aeiou]r'''</center>
| Matches with '''foob'''''b'''''r''', '''foob'''''c'''''r''' etc. but not '''foob'''''a'''''r''', '''foob'''''e'''''r''', etc.
|}

@@@ The "]-a" example would need a clarification as to what is the natural sequence of characters, and where is a superset of all possible characters described?

=== Predefined Classes ===

Some of the character classes are used so often that RegEx has predefined escape sequences to represent them.

{| class="prettytable"
|-
| <center>'''RegEx Pattern'''</center>
| <center>'''Remarks'''</center>
|-
| <center>'''\w'''</center>
| an alphanumeric character, including an ''underscore'' ('''_''')
|-
| <center>'''\W'''</center>
| a non-alphanumeric character
|-
| <center>'''\d'''</center>
| a numeric character
|-
| <center>'''\D'''</center>
| a non-numeric character
|-
| <center>'''\s'''</center>
| any space (same as the '''[ \t\n\r\f]''' class)
|-
| <center>'''\S'''</center>
| a non space
|-
| <center>'''.'''</center>
| any character in line (the symbol is just a dot)
|}

Notice that the capitalized letter is used to negate (for example, compare '''\w''' with '''\W''')

=== Word/Text Boundaries ===

A word boundary (\b) is a spot between two characters that has a \w on one side of it and a \W on the other side of it (in either order), counting the imaginary characters off the beginning and end of the string as matching a \W.

{| class="prettytable"
|-
| <center>'''RegEx Pattern'''</center>
| <center>'''Remarks'''</center>
|-
| <center>'''\b'''</center>
| word boundary
|-
| <center>'''\B'''</center>
| not word boundary
|-
| <center>'''\A'''</center>
| start of text ('''^''' is an alternative)
|-
| <center>'''\Z'''</center>
| end of text ('''$''' is an alternative)
|}

These markers are combined with the search string to specify where exactly you want the search string to be. For example, '''\bhis\b '''will search for a whole word '''his''', but will ignore '''this''', '''history '''or '''whistle'''.

=== Iterators (Quantifiers) ===

Iterators (quantifiers) are meta-characters that specify how many times the ''preceding'' expression has to repeat, A typical example is to find a 3-to-5 digit number.

RegEx newbies often place the iterators ''after'' the character that needs to repeat. Just remember that RegEx syntax is exact opposite of the usual English syntax. So, instead of "''four dogs''", we would have to say "''dogs four''", RegEx-style.

Iterators can be 'Greedy' or 'Non-Greedy'. Greedy means the expression grabs as ''much'' matching text as possible. In contrast, the non-greedy expression tries to match as ''little'' as possible.

For example,

*when '''b+''' (a greedy expression) is applied to string '''abbbbc''', it returns '''bbbb''',
*but when '''b+? '''(a non-greedy expression) is applied to '''abbbbc''', it returns only '''b'''.

Note that a '''? '''attached to a greedy expression makes it non-greedy.

{| class="prettytable"
|-
! <center>RegEx pattern</center>
! <center>Remarks</center>
! <center>Greedy?</center>
! <center>Remarks</center>
|-
| <center>'''*'''</center>
| zero or more
| <center>Yes</center>
| equivalent to '''{0,}'''
|-
| <center>'''+'''</center>
| one or more
| <center>Yes</center>
| equivalent to '''{1,}'''
|-
| <center>'''?'''</center>
| zero or one
|
| equivalent to '''{0,1}'''
|-
| <center>'''{n}'''</center>
| exactly ''n'' times
| <center>Yes</center>
|
|-
| <center>'''{n,}'''</center>
| at least ''n'' times
| <center>Yes</center>
|
|-
| <center>'''{n,m}'''</center>
| at least ''n'' but not more than ''m'' times
| <center>Yes</center>
|
|-
| <center>'''*?'''</center>
| zero or more
| <center>No</center>
| equivalent to '''{0,}?'''
|-
| <center>'''+?'''</center>
| one or more
| <center>No</center>
| equivalent to '''{1,}?'''
|-
| <center>'''??'''</center>
| zero or one
| <center>No</center>
| equivalent to '''{0,1}?'''
|-
| <center>'''{n}?'''</center>
| exactly ''n'' times
| <center>No</center>
|
|-
| <center>'''{n,}?'''</center>
| at least ''n ''times
| <center>No</center>
|
|-
| <center>'''{n,m}?'''</center>
| at least ''n'' but not more than ''m'' times
| <center>No</center>
|
|}

Let us see some examples:

{| class="prettytable"
|-
! <center>RegEx pattern</center>
! <center>Remarks</center>
|-
| <center>'''foob.*r'''</center>
| matches '''foobar''', '''foobalkjdflkj9r''' and '''foobr'''
|-
| <center>'''foob.+r'''</center>
| matches '''foobar''', '''foobalkjdflkj9r''' but not '''foobr'''
|-
| <center>'''foob.?r'''</center>
| matches '''foobar,''' '''foobbr''' and '''foobr''' but not '''foobalkj9r'''
|-
| <center>'''fooba{2}r'''</center>
| matches '''foobaar'''
|-
| <center>'''fooba{2,}r'''</center>
| matches '''foobaar,''' '''foobaaar''', '''foobaaaar''' etc. but not '''foobar'''
|-
| <center>'''fooba{2,3}r'''</center>
| matches '''foobaar''', or '''foobaaar''' but not '''foobaaaar''' or '''foobar'''
|}

=== Alternatives ===

A RegEx expression can have multiple alternative characters or subexpressions. The metacharacter '''|''' is used to separate the alternatives.

For example, '''fee|fie|foe '''will match with '''fee''', '''fie''', or '''foe''' in the target string.

It is difficult to understand where each alternative starts and ends. This is why it is a common practice to include alternatives in parentheses, to make it easier to understand.

For example, '''fee|fie|foe '''can be written as '''f(e|i|o)e''', to make it easier to understand.

Alternatives are tried from left to right, so the first alternative found for which the entire expression matches, is the one that is chosen. For example, when matching '''foo|foot''' against '''barefoot,''' only the '''foo '''part will match, because that is the first alternative tried, and it successfully matches the target string. (This is important when you are capturing matched text using parentheses.)

{| class="prettytable"
|-
| <center>'''RegEx Pattern'''</center>
| <center>'''Remarks'''</center>
|-
| '''foo(bar|foo)'''
| matches '''foobar''' or '''foofoo'''
|}

Also remember that alternatives cannot be used inside a character class (square brackets), because '''|''' is interpreted as a literal within '''[]'''. That means '''[fee|fie|foe]''' is same as '''[feio|]'''. (The other characters are treated as duplicates, and ignored).

=== Subexpressions ===

Parts of any RegEx pattern can be enclosed in brackets (), just like using brackets in a mathematics formula. Each part that is enclosed in brackets is called a "''subexpression".''

The brackets serve two main purposes:

*Better readability, as in the mathematical formula '''a+(b+c).'''
*Make a functional group, as in the mathematical formula '''a(b+c).''' This group is evaluated first.

Let us see some examples:

{| class="prettytable"
|-
| <center>'''RegEx Pattern'''</center>
| <center>'''Remarks'''</center>
|-
| <center>'''(fee)|(fie)|(foe)'''</center>
| Much better readability than the equivalent RegEx pattern '''fee|fie|foe'''.
|-
| <center>'''(foobar){2,3}'''</center>
| Matches with the entire enclosed string '''foobar '''repeated 2 or 3 times'''.'''
(i.e., matches with '''foobarfoobar '''or '''foobarfoobarfoobar''') (The iterator acts on the entire subexpression. Compare with the example below!)

|-
| <center>'''foobar{2,3}'''</center>
| Matches with '''fooba''' followed by the character '''r '''repeated 2 or 3 times'''. '''(i.e., matches with foobarr or foobarrr) (The iterator acts only on the last character.)
|-
| '''foob([0-9]|a+)r'''
| matches only the character '''foob0r''', '''foob1r ''', '''foobar''', '''foobaar''', '''foobaaaar''', etc. (The subexpression is evaluated first.)
|}

=== Backreferences ===

You must have told (or heard-) jokes like this one:

"Two guys walk in a bar. The '''''first guy''''' says.... Then the '''''second guy''''' replies....".

Then you are already familiar with ''backreferences''!

A ''"backreference"'' is a ''numbered reference ''to a previously mentioned thing.

RegEx also has backreferences. Let us understand how backreferences are defined in RegEx.

The RegEx engine tries to find text that matches the ''whole'' RegEx pattern. If a matching text is found, the RegEx engine identifies the matching text for each of the subexpressions in the pattern.

At this stage, the RegEx engine gives numbers to these matching parts:

*The text that matches the ''entire'' RegEx expression takes the number '0'.
*The text matching any subexpression is given a number based on the position of that subexpression inside the pattern. In other words, text matching the ''n''th subexpression will take the number 'n'.

Now we use those numbers to refer to the entire pattern and/or subexpressions. (That is why these numbers are called '''"backreference"'''.)

The backreference to the ''n''th subexpression is written as '''\n'''.

The backreferences can be used to compose the RegEx pattern itself, as shown below:

{| class="prettytable"
|-
| <center>'''(.)\1+'''</center>
| matches '''aaaa '''and '''cc '''(any single character that is repeated twice or more)
|-
| <center>'''(.+)\1+'''</center>
| matches '''aaaa''', '''cc''', '''abababab''', '''123123'''
(a set of one or more characters, repeated twice or more)

(The character-sets are alternately colored '''blue''' and '''pink '''for easy identification. Observe how a RegEx pattern can match quite different text! )

|}

==== Substitution of text using backreference ====

The backreferences are also used in ''find-and-replace'' operations, to re-assemble new text from old.

*The expressions '''\1''' through '''\9''' serve as backreferences to the subexpressions found in the RegEx pattern. The expression '''\0 '''is used to represent the text that matches the whole RegEx pattern. These are used in the "find" part of the operation.
*The expressions '''$1''' through '''$9''' represent the actual text that matches the ''respective'' subexpressions.These are used in the "replace" part of the operation.

The replacement text is typically a combination of-

*The text that matched the subexpressions, and
*Some new text.

Note that the RegEx pattern ''may'' have some parts that are not enclosed in (). (In other words, it may have parts that are not subexpressions.) Such parts are not used in the replacement text.

Here are some "find-and-replace" examples:

{| class="prettytable"
|-
! Expression
! Replace
! Description
|-
| <center>(.*) (.*)</center>
| <center>$2, $1</center>
| Switch two words around and put a comma after the resulting first word. Example: if input string is "John Smith", then output will be "Smith, John".
Notice that the replacement text also has additional literal text in the middle (comma and space).

|-
| <center>\b(\d{2})-(\d{2})-(\d{4})\b</center>
| <center>$3-$2-$1</center>
| Find date sequences in dd-mm-yyyy format and reverse them into yyyy-mm-dd format. (e.g. 25-10-2007 is converted to 2007-10-25).
'''Note''': This is not a very robust example, because \d can represent any digit in range of 0-9. That means sequences like 99-99-9999 also will match this pattern, resulting in a problem. This in fact shows that you need to be careful with RegEx patterns!

|-
| <center>\[.*?\]</center>
|
| Remove the contents of the [...] (square brackets), and the brackets too. (Replace with ''nothing'' means ''deleting''.)

|}

=== Limitations for binary data ===

One of the known limitation of RegEx engine when working with binary data is that the input string is not search beyond the first occurrence of NULL character (\x00). This would not affect file names because there are simply no NULL characters in them, but may affect parsing of binary content of files when working in [[ReNamer:Pascal Script|Pascal Script]] for example.

=== External links ===

*[http://www.regular-expressions.info/ www.regular-expressions.info]
**Excellent site devoted to regular expressions. Nicely structured and with many easy-to-understand examples.
*[http://www.regexpstudio.com/ www.regexpstudio.com]
**Freeware regular expressions library for Delphi.

ReNamer:Managing rules

2009-08-29T21:01:22Z

Krtek: /* Editing rules */ removed a paragraph where it stayed that Translit and PascalScript rules differs from the others in case of editing

This section explains how to add rules, remove rules, edit a rule and change the order in which they are applied to files and folders.

=== Adding rules ===

#Rules can be added by using any of the following methods:
#*Click the [[Image:AddRuleButton.png]] button,
#*Click inside the '''Rules''' area,
#*Press the '''Ins''' key when the ReNamer window is active.
#The '''Add Rule''' window pops up:
#:<center>[[Image:HowAddRulesWorks.png]]</center>
#:[[ReNamer:Managing_rules#Selecting_a_rule|Select]] the desired rule.
#The options for the selected rule appear immediately in the '''Configuration''' area (at right).
#:Set the desired parameters, as explained in each rule.
#Press the [[Image:AddRuleButton.png]] button at the bottom of the window. The rule is added to the stack and the window is closed.
#Repeat steps 1-5 to add more rules. Each new rule is added at the end of the stack.
#To close the window without adding a rule press the [[Image:CloseButton.png]] button at bottom (or the [[Image:CloseWindowButton.png]] button at the top right corner).

=== Removing (deleting) rules ===

To remove an existing rule, [[ReNamer:Managing rules#Selecting_a_rule|select]] it and press '''DEL''' or click on the [[Image:RemoveButton.png]] button.

=== Changing the order of the rules ===

All rules are applied to each file in the order they appear. Even with the same set of rules, the end-result can be very different if the order of the rules is changed.

You can change the order of rules using any of the following methods:

#Using the [[Image:UpButton.png]] and [[Image:DownButton.png]] buttons.
#Pressing '''CTRL''' + '''Up/Down''' arrows.
#Drag-and-drop any rule with mouse.

=== Editing rules ===

Editing a rule means changing its parameters and options, and then saving the rule.

You can edit a rule using any of the following methods:

#Double-click on it,
#Right-click on it and select the '''Edit Rule '''option
#[[ReNamer:Managing rules#Selecting_a_rule|Select]] it and press '''ENTER.'''

A window similar to the '''Add Rules''' window appears. There are only ''two'' minor differences: the button at the bottom is titled '''Save Rule''', and the rules list in the left pane is grayed out (because you are not supposed to select rules in this window).

Change the parameters and options, and press the '''Save Rule '''button or '''ENTER'''.

=== Selecting a rule ===

When a rule is selected, its entire row is highlighted with blue background.

{| class="prettytable"
|-
| Selected rule
| [[Image:SelectedRule.png]]
|-
| Unselected rule
| [[Image:UnselectedRule.png]]
|}

Only one rule can be selected at a time.

To select a rule, use any of the following methods:

#Click anywhere in the row except on the check box.
#Use the Up/Down arrow keys on your keyboard to move the selection to another rule.

=== Marking and Unmarking a rule ===

A rule is marked by putting a tick in its check box[[Image:CheckedCheckbox.png]]. Conversely, it is unmarked by removing the tick [[Image:UncheckedCheckbox.png]].

ReNamer uses only the ''marked'' rules for the ''preview'' and ''renaming'' operations.

So unmarking a rule is useful to temporarily disable the rule ''without'' having to remove it from the '''Rules''' pane.

To mark/unmark the rules:

#Click on the check box.
#[[ReNamer:Managing_rules#Selecting_a_rule|Select]] a rule and press the '''Spacebar''' (on your keyboard)

(Repeat of any of these actions toggles the marked/unmarked status.)

The reasons for unmarking a rule are:

#You want to remove the effect of a rule and see what happens to the files.
#You have a favorite set of rules that you use often. However, you need to remove a few rules in some cases. A trick is to save the superset of rules and reload them automatically each time you start ReNamer. Then in each session, unmark some rules.

ReNamer:Managing rules

2009-08-29T20:59:56Z

Krtek: /* Selecting a rule */ only one rule can be selected at a time

This section explains how to add rules, remove rules, edit a rule and change the order in which they are applied to files and folders.

=== Adding rules ===

#Rules can be added by using any of the following methods:
#*Click the [[Image:AddRuleButton.png]] button,
#*Click inside the '''Rules''' area,
#*Press the '''Ins''' key when the ReNamer window is active.
#The '''Add Rule''' window pops up:
#:<center>[[Image:HowAddRulesWorks.png]]</center>
#:[[ReNamer:Managing_rules#Selecting_a_rule|Select]] the desired rule.
#The options for the selected rule appear immediately in the '''Configuration''' area (at right).
#:Set the desired parameters, as explained in each rule.
#Press the [[Image:AddRuleButton.png]] button at the bottom of the window. The rule is added to the stack and the window is closed.
#Repeat steps 1-5 to add more rules. Each new rule is added at the end of the stack.
#To close the window without adding a rule press the [[Image:CloseButton.png]] button at bottom (or the [[Image:CloseWindowButton.png]] button at the top right corner).

=== Removing (deleting) rules ===

To remove an existing rule, [[ReNamer:Managing rules#Selecting_a_rule|select]] it and press '''DEL''' or click on the [[Image:RemoveButton.png]] button.

=== Changing the order of the rules ===

All rules are applied to each file in the order they appear. Even with the same set of rules, the end-result can be very different if the order of the rules is changed.

You can change the order of rules using any of the following methods:

#Using the [[Image:UpButton.png]] and [[Image:DownButton.png]] buttons.
#Pressing '''CTRL''' + '''Up/Down''' arrows.
#Drag-and-drop any rule with mouse.

=== Editing rules ===

Editing a rule means changing its parameters and options, and then saving the rule.

You can edit a rule using any of the following methods:

#Double-click on it,
#Right-click on it and select the '''Edit Rule '''option
#[[ReNamer:Managing rules#Selecting_a_rule|Select]] it and press '''ENTER.'''

A window similar to the '''Add Rules''' window appears. There are only ''two'' minor differences: the button at the bottom is titled '''Save Rule''', and the rules list in the left pane is grayed out (because you are not supposed to select rules in this window).

Change the parameters and options, and press the '''Save Rule '''button or '''ENTER'''.

*There are two notable exceptions: the [[ReNamer:Rules:Translit|'''Translit''']] and [[ReNamer:Rules:PascalScript|'''PascalScript''']] rules are actually ''collections'' of individual rules. You have to select an individual Translit rule or Pascal script and edit it. So the above description does not apply to those rules. Click on the hyperlinks above to see how to edit these two rules.

=== Selecting a rule ===

When a rule is selected, its entire row is highlighted with blue background.

{| class="prettytable"
|-
| Selected rule
| [[Image:SelectedRule.png]]
|-
| Unselected rule
| [[Image:UnselectedRule.png]]
|}

Only one rule can be selected at a time.

To select a rule, use any of the following methods:

#Click anywhere in the row except on the check box.
#Use the Up/Down arrow keys on your keyboard to move the selection to another rule.

=== Marking and Unmarking a rule ===

A rule is marked by putting a tick in its check box[[Image:CheckedCheckbox.png]]. Conversely, it is unmarked by removing the tick [[Image:UncheckedCheckbox.png]].

ReNamer uses only the ''marked'' rules for the ''preview'' and ''renaming'' operations.

So unmarking a rule is useful to temporarily disable the rule ''without'' having to remove it from the '''Rules''' pane.

To mark/unmark the rules:

#Click on the check box.
#[[ReNamer:Managing_rules#Selecting_a_rule|Select]] a rule and press the '''Spacebar''' (on your keyboard)

(Repeat of any of these actions toggles the marked/unmarked status.)

The reasons for unmarking a rule are:

#You want to remove the effect of a rule and see what happens to the files.
#You have a favorite set of rules that you use often. However, you need to remove a few rules in some cases. A trick is to save the superset of rules and reload them automatically each time you start ReNamer. Then in each session, unmark some rules.

ReNamer:Managing rules

2009-08-29T20:59:11Z

Krtek: /* Removing (deleting) rules */ you can't select multiple rules and then delete them

This section explains how to add rules, remove rules, edit a rule and change the order in which they are applied to files and folders.

=== Adding rules ===

#Rules can be added by using any of the following methods:
#*Click the [[Image:AddRuleButton.png]] button,
#*Click inside the '''Rules''' area,
#*Press the '''Ins''' key when the ReNamer window is active.
#The '''Add Rule''' window pops up:
#:<center>[[Image:HowAddRulesWorks.png]]</center>
#:[[ReNamer:Managing_rules#Selecting_a_rule|Select]] the desired rule.
#The options for the selected rule appear immediately in the '''Configuration''' area (at right).
#:Set the desired parameters, as explained in each rule.
#Press the [[Image:AddRuleButton.png]] button at the bottom of the window. The rule is added to the stack and the window is closed.
#Repeat steps 1-5 to add more rules. Each new rule is added at the end of the stack.
#To close the window without adding a rule press the [[Image:CloseButton.png]] button at bottom (or the [[Image:CloseWindowButton.png]] button at the top right corner).

=== Removing (deleting) rules ===

To remove an existing rule, [[ReNamer:Managing rules#Selecting_a_rule|select]] it and press '''DEL''' or click on the [[Image:RemoveButton.png]] button.

=== Changing the order of the rules ===

All rules are applied to each file in the order they appear. Even with the same set of rules, the end-result can be very different if the order of the rules is changed.

You can change the order of rules using any of the following methods:

#Using the [[Image:UpButton.png]] and [[Image:DownButton.png]] buttons.
#Pressing '''CTRL''' + '''Up/Down''' arrows.
#Drag-and-drop any rule with mouse.

=== Editing rules ===

Editing a rule means changing its parameters and options, and then saving the rule.

You can edit a rule using any of the following methods:

#Double-click on it,
#Right-click on it and select the '''Edit Rule '''option
#[[ReNamer:Managing rules#Selecting_a_rule|Select]] it and press '''ENTER.'''

A window similar to the '''Add Rules''' window appears. There are only ''two'' minor differences: the button at the bottom is titled '''Save Rule''', and the rules list in the left pane is grayed out (because you are not supposed to select rules in this window).

Change the parameters and options, and press the '''Save Rule '''button or '''ENTER'''.

*There are two notable exceptions: the [[ReNamer:Rules:Translit|'''Translit''']] and [[ReNamer:Rules:PascalScript|'''PascalScript''']] rules are actually ''collections'' of individual rules. You have to select an individual Translit rule or Pascal script and edit it. So the above description does not apply to those rules. Click on the hyperlinks above to see how to edit these two rules.

=== Selecting a rule ===

When a rule is selected, its entire row is highlighted with blue background.

{| class="prettytable"
|-
| Selected rule
| [[Image:SelectedRule.png]]
|-
| Unselected rule
| [[Image:UnselectedRule.png]]
|}

Only one rule can be selected at a time.

You can select multiple rules and carry out certain actions on all these rules in one stroke.

To select a rule, use any of the following methods:

#Click anywhere in the row except on the check box.
#Use the Up/Down arrow keys on your keyboard to move the selection to another rule.

=== Marking and Unmarking a rule ===

A rule is marked by putting a tick in its check box[[Image:CheckedCheckbox.png]]. Conversely, it is unmarked by removing the tick [[Image:UncheckedCheckbox.png]].

ReNamer uses only the ''marked'' rules for the ''preview'' and ''renaming'' operations.

So unmarking a rule is useful to temporarily disable the rule ''without'' having to remove it from the '''Rules''' pane.

To mark/unmark the rules:

#Click on the check box.
#[[ReNamer:Managing_rules#Selecting_a_rule|Select]] a rule and press the '''Spacebar''' (on your keyboard)

(Repeat of any of these actions toggles the marked/unmarked status.)

The reasons for unmarking a rule are:

#You want to remove the effect of a rule and see what happens to the files.
#You have a favorite set of rules that you use often. However, you need to remove a few rules in some cases. A trick is to save the superset of rules and reload them automatically each time you start ReNamer. Then in each session, unmark some rules.

ReNamer:Using presets

2009-08-29T20:57:12Z

Krtek:

A "preset" is a set of rules that is saved with a user-defined name. It can optionally save the [[ReNamer:Menus for the Files pane#Filters_menu|Filter setting]] also.

You can save frequently used sets of rules as presets, and load them instantly. This saves you a lot of time. Without the presets, you would have to compose the same set of rules each time you start the program.

ReNamer assigns a keyboard shortcut automatically to each saved preset, so that it can be loaded in the '''Rules '''pane with least effort. You can create an unlimited number of presets (but in practice, you would need about 4-5 presets)

{| class="wikitable"
|-
! To do this
! Do this...
|-
| align="center" | Save a preset
|
# Create a list of rules ([[ReNamer:Managing rules|Managing rules]]).
# Set the required [[ReNamer:Menus for the Files pane#Filters_menu|Filter settings]] (optional).
# Press '''CTRL+S''', or use the '''Presets > Save As''' menu option.
# A window pops up: <center>[[Image:SavePresetDialog.png]]</center>
# Enter a new name in the '''Name''' box, or select one of the existing presets listed below to overwrite it.
# Put a tick in the check box if you want to save the current filter settings.
# Press the '''Save''' button. The preset is saved.

ReNamer automatically assigns shortcuts to the first nine of presets (as they appear in the alphabetical order). The sequence of shortcuts will be '''CTRL+1''', '''CTRL+2''', etc. These shortcuts cannot be edited.

'''Note:''' At any point of time, you can abort the process by pressing '''ESC''' or closing the window.
|-
| align="center" | Load an existing preset
| You can load any of the presets by pressing its shortcut ('''CTRL+1''', etc. see above). If you do not remember the shortcuts, use the '''Preset > Load''' menu to see the master list of all existing presets and select a preset from that list.The selected preset is loaded.
|-
| align="center" | Append an existing preset to current set of rules
| You can append any of the presets to the end of the current rules stack. To do it, follow these steps:
# Press '''CTRL+M''' or use the '''Presets > Manage''' menu option.
# The '''Presets manager''' window pops up: <center>[[Image:PresetsManager.png]]</center>
# Select the preset you want to append and then press the [[Image:Append_preset_button.png]] button.
# Close the '''Preset Manager''' window.
|-
| align="center" | Delete an existing preset
| Sometimes you may not need a preset any longer. To delete it, follow these steps:
# Press '''CTRL+M''' or use the '''Presets > Manage''' menu option.
# The '''Presets manager''' window pops up: <center>[[Image:PresetsManager.png]]</center>
# Select the preset you want to delete and then press '''DEL''' key or the [[Image:PresetDeleteButton.png]] button.
# Close the '''Preset Manager''' window.
|-
| align="center" | Rename a preset
|
To rename a preset, follow these steps:
# Press '''CTRL+M''' or use the '''Presets > Manage''' menu option.
# The Preset manager window pops up.
# Select the preset you want to rename and then press '''F2''' or the [[Image:RenamePresetButton.png]] button.
# The following dialog pops up: [[Image:RenamePresetDialog.png|center]]
# Edit the name (or enter a new name), and press '''OK''' or '''ENTER'''.

To abort the process at any time, press '''ESC''' or close the window.
|-
| align="center" | Edit a preset
|
The preset manager can show the contents of a preset (i.e., settings of all rules and filters) as editable text. You can simply edit the rules and filters by changing the text.

To edit a preset, follow these steps:

# Press '''CTRL+M''' or use the '''Presets > Manage''' menu option.
# The '''Presets manager''' window pops up: [[Image:PresetsManager.png|center]]
# Select the preset you want to edit and then press '''F4''' or the [[Image:EditPresetButton.png]] button.
# A warning pops up: [[Image:EditPresetWarning.png|center]]
# Click on '''Yes'''. A Notepad (text editor) window pops up with the selected preset: [[Image:PresetEditWindow.png|center]]
#: Notice that:
#:* This window shows the preset name in the title bar, and all settings (rules and filters).
#:* In each rule, the parameters are shown in '''ParameterName:ParameterValue '''format.
#:* All such pairs are separated by a semicolon (''';''').
# Edit the settings and then close the file. A confirmation dialog pops up. [[Image:SaveChangedmpFileDialog.png|center]]7. Click on '''Yes'''. Now the preset is edited.
|-
| align="center" | Copy a preset
| You may want to duplicate an existing preset and create a variation by editing it (or just take a backup of the preset before experimenting with it).

To duplicate a preset, follow these steps:

# Press '''CTRL+M''' or use the '''Presets > Manage''' menu option.
# The '''Presets manager''' window pops up: [[Image:PresetsManager.png|center]]
# Select the preset you want to duplicate and then press the [[Image:CopyPresetButton.png]] button.
# A duplicate copy of the preset is created.
# Now go ahead and edit the original present (or its copy).
# Finally close the '''Presets Manager''' window.
|}

File:PresetsManager.png

2009-08-29T20:54:33Z

Krtek: uploaded a new version of "File:PresetsManager.png": I've tried to upgrade that file once with no result (as in narayans post http://www.den4b.com/forum/viewtopic.php?pid=3666#p3666). I guess this time will be the same.

Presets Manager

File:PresetsManager.png

2009-08-29T20:49:53Z

Krtek: uploaded a new version of "File:PresetsManager.png"

Presets Manager

File:Append preset button.png

2009-08-29T20:45:20Z

Krtek:

ReNamer:Menus for the Files pane

2009-08-29T20:42:32Z

Krtek: /* Options menu */ Count marked and selected files clarification

ReNamer has a menu bar between the '''Rules''' and '''Files''' panes [[Image:MenuStrip.png]].

This appendix describes options available from this menu.

=== Files button ===

When you click on the [[Image:FilesButton.png]] button, the following list pops up:
<center>[[Image:FileMenu.png]]</center>
{| class="prettytable" style="width: 619px; height: 218px;"
|-
| Analyze Name
| Opens [[ReNamer:Analyze|analysis window]], and loads the names of the selected files into it.
|-
| Edit New Name '''F2'''
| Starts manual editing of the selected filename.
|-
| [[ReNamer:Menus for the Files pane#Shell submenu|Shell]]
| Options for Windows shell operations.
|-
| [[ReNamer:Menus for the Files pane#Mark submenu|Mark]]
| Options for [[ReNamer:Adding_files_and_folders#Marking_and_Unmarking_the_files|marking]] specific items.
|-
| [[ReNamer:Menus for the Files pane#Clear submenu|Clear]]
| Options for [[ReNamer:Adding_files_and_folders#Marking_and_Unmarking_the_files|removing]] specific items from the '''Files''' pane.
|-
| [[ReNamer:Menus for the Files pane#Select submenu|Select]]
| Options for [[ReNamer:Adding_files_and_folders#Selecting_files|selecting]] specific items.
|-
| [[ReNamer:Menus for the Files pane#Move submenu|Move]]
| Options for moving specific items.
|-
| Remove selected items '''Del'''
| Remove selected items from the ReNamer's '''File''' pane. (This command does not delete the items from the disk.)
|}

This menu provides second-level options, as follows:

==== Shell submenu ====
<center>[[Image:ShellSubMenu.png]]</center>
 

{| class="prettytable"
|-
| Open File'''                Enter'''
| Open the selected file using its default associated application.
|-
| Open with Notepad'''  Shift+Enter'''
| Open the file with notepad. Useful when you want to see the raw data in the file. (When viewed this way, the file will not be displayed in its original formatting. It may not be easily readable.)
|-
| Open operating folder '''Ctrl+Enter'''
| Launch Windows Explorer and open the folder where the selected file is located. Highlight (select) the file in it.
|-
| File properties '''Alt+Enter'''
| Display the properties of the selected file. Typically, file size, dates (created/modified/accessed), comments, author, attributes (hidden, system, etc.)
|-
| Cut Files to clipboard '''Shift+Ctrl+X'''
| Cuts the selected file(s) to clipboard. All files will be moved to one folder, no matter where they were initially located. (Note: If you do not paste the file(s) in a target application, the '''Cut''' operation is automatically canceled.)
|-
| Copy Files to clipboard '''Shift+Ctrl+C'''
| Copies selected file(s) to clipboard. All files will be copied to one folder, no matter where they were initially located.
|-
| Delete files to Recycle Bin
| Deletes the selected file(s) to Recycle Bin. (They can be recovered from the Recycle Bin.)
Note that if the file is too large for the Recycle Bin, Windows will warn you that it will not be put in Recycle Bin, but deleted permanently. If you confirm, the file is deleted permanently.

|}

==== Mark submenu ====
<center>[[Image:MarkSubmenu.png]]</center>
'''Note'''''': '''Marking of files is explained [[ReNamer:Adding files and folders#Marking_and_Unmarking_the_files|here]]. 

{| class="prettytable"
|-
| Mark'''       Shift+M'''
| Mark all selected files. If some files are already marked, they remain marked.
|-
| UnMark'''   Shift+U'''
| Unmark all selected files. If some files are already unmarked, they remain unmarked.
|-
| Invert Marking '''Ins'''
| Marked files become unmarked, and vice versa.
|-
| Mark only changed (Inc. Case)
| [[ReNamer:Adding files and folders#Marking_and_Unmarking_the_files|Mark]] files that have been changed. Files that had just change of case (and nothing else) will also be marked. ("''Change of case''" means some letters are converted capital-to-small and/or small-to-capital)
|-
| Mark only changed (Exc. Case)
| [[ReNamer:Adding files and folders#Marking_and_Unmarking_the_files|Mark]] files that have been changed, but do not consider changes of case. ("''Change of case''" means some letters are converted capital-to-small and/or small-to-capital)
|-
| Mark only selected
| Mark files that are selected. If some unselected files are already marked, they will be unmarked.
|-
| Mark by Mask
| Pops up a Mask window:
[[Image:MarkByMask.png]]

Specify a mask pattern. All files that match this mask will be marked.

You can enter multiple masks (separating them with semicolon). If a file matches any of these masks, it will be marked.

|}

==== Clear submenu ====
<center>[[Image:ClearSubmenu.png]]</center>
'''Note''': The term "''Clear''" means remove from '''Files''' pane of ReNamer. 

{| class="prettytable"
|-
| Clear All
| Clear all files loaded in the pane.
|-
| Clear Renamed
| Clear all files which have been renamed just before this command. Note that even if some files are not affected by the rules, they are still regarded as renamed successfully.
Only files that failed to rename (those with an '''x''' mark) will remain in the pane.

|-
| Clear Failed
| Only files that failed to rename (those with an '''x''' mark) will be cleared.
All other files (including files whose names were not altered by the rules) will remain in the '''Files''' pane.

|-
| Clear Valid
| Clear files that have valid names after Preview (but haven't been renamed yet).
|-
| Clear Invalid
| Clear files that got invalid (causing conflicts, empty or with forbidden characters etc.) names after Preview (but before renaming).
|-
| Clear Marked
| Clear all marked files.
|-
| Clear Not Marked
| Clear all files that are not marked.
|-
| Clear Not Changed '''Ctrl+D'''
| Clear all files that haven't been changed by the Preview. This also includes all files that have their New Name field empty (eg. because they have been successfully renamed or haven't been previewed since last renaming operation).
|}

==== Select submenu ====
<center>[[Image:SelectSubmenu.png]]</center>
Note: Selection of files is explained [[ReNamer:Adding files and folders#Selecting_files|here]]. 

{| class="prettytable"
|-
| Select All'''  Ctrl+A'''
| All files in the pane will be selected.
|-
| Invert Selection'''  Ctrl+I'''
| Selected files become deselected, and vice versa.
|-
| Select by Name Length  '''Ctrl+L'''
| Pops up a window:
[[Image:SelectByFileNameLengthDialog.png]]

Specify the length of file name. Only files that exceed that length will be selected.

The length refers to the whole filename including dot and the extension.

'''Note''': A typical application is to check if the file can be put on a CD/DVD. The maximum length allowed in ISO 9660-compliant file-system is 64 characters. Longer file names are truncated when you burn a CD/DVD. It is difficult to correlate such files with their originals. To avoid such problems, shorten the names ''before'' burning the CD/DVD.

|-
| Select by Extension  '''Ctrl+E'''
| Pops up a window:
[[Image:SelectByExtnDialog.png]]

Specify the extension (without the dot). All files having that extension will be selected.

You can enter multiple extensions (they must be separated by semicolons - not comma).

|-
| Select by Mask'''  Ctrl+M'''
| Pops up this window:
[[Image:SelectByMask.png]]

Specify the [[ReNamer:Masks|mask]]. All files matching that pattern will be selected. You can enter multiple masks (they must be separated by semicolons - not comma).

|}

==== Move submenu ====
<center>[[Image:MoveSubmenu.png]]</center>
 

{| class="prettytable"
|-
| Up'''      Ctrl+Up'''
| Moves the selected file up. This is used to re-arrange files in the list.
It is easier to use the keyboard shortcut '''CTRL+UpArrow'''.

|-
| Down'''  Ctrl+Down'''
| Moves the selected file down. This is used to re-arrange the files list.
It is easier to use the keyboard shortcut '''CTRL+DownArrow'''.

|}

=== Filters menu ===

When you click on the [[Image:FiltersButton.png]] button, the '''Filters''' window pops up. It controls what gets added to the '''Files''' pane when you use the [[Image:AddFoldersButton.png]] button or [[ReNamer:Adding files and folders#Adding files using the Drag-and-drop method|Drag & Drop]] or [[ReNamer:Adding files and folders#Adding files using the copy-and-paste method |Copy & Paste]] methods. 

{| class="prettytable"
|-
| [[Image:FilterSettingsDialog.png]]
| The options work as follows:
{| class="prettytable"
|-
| <center>'''Option'''</center>
| <center>'''Effect'''</center>
|-
| Add files within folders
| If you want to rename only directories, you would need to UNTICK ''Add files within folders'' option, and tick ''Add folders as files'' option. This will stop files being added from scanned folders.
|-
| Add folders as files
| ReNamer treats folder just like a single filename (not as a container that holds files and subfolders). So only the folder is loaded, and not the files in it. Useful for renaming the folder itself.
|-
| Include subfolders
| Loads contents from all subfolders recursively.
|-
| Include hidden items
| To protect hidden items, deselect this option.
|-
| Include system items
| To protect files reserved for system (OS), deselect this option.
|-
| Skip root folders when added as files
| Works when the ''Add folders as files'' and ''Include subfolders'' options are selected. When it's on, ReNamer adds all the subfolders but not the root folder itself.
|-
| Masks
| All added files (or folders as files) must match specified [[ReNamer:Masks|mask(s)]]. For example, if you enter '''*.jpg;*.gif;*.png''' as masks, ReNamer will add only files with these extensions. Everything else will be filtered ''out''(not added to ReNamer).
|-
| Apply only to the file name
| Changes how the masks (see above) are applied.
For example, suppose you have file '''''C:\Folder\File.ext'''''. If ''this'' option is ON, only the filename part ('''''File.ext''''') will be checked against the mask(s). But if ''this'' option is OFF, the entire path ('''''C:\Folder\File.ext''''') will be checked against the mask(s).

|}

Press '''Save''' to save changes.

|}

'''Filters''' menu is also accessible from the '''Add Folder''' window. For details see [[ReNamer:Adding files and folders#Adding items using the 'Add Folders' button |Adding items using the 'Add Folders' button]] section.

=== Export menu ===
When you click on the [[Image:ExportButton.png]] button, the following list pops up:

<center>[[Image:ExportMenu.png]]</center>

{| class="prettytable"
| Export file paths and undo paths
| Exports ''file paths'' and ''undo paths'' to the .csv (comma separated) or .txt (tab separated) file.

|-
| Export file paths and new names
| Exports ''file paths'' and ''new names'' to the .csv (comma separated) or .txt (tab separated) file.

|-
| Import file paths and new names
| Imports ''file paths'' and ''new names'' from the .csv (comma separated) or .txt (tab separated) file.

|-
| Import files from text-list or play-list
| Imports ''file paths'' from the .txt/.log file (one file per line) or .m3u/.pls playlist.

'''Note:''' It will load file paths into '''Files''' pane only if the file really exists on your file system.
|-
| Export new names to clipboard
| Export ''new names'' to clipboard. One name per line.

|-
| Import new names from clipboard
| Imports ''new names'' from clipboard. Every name should be placed in a new line.

If there is less lines in the clipboard text than files in '''Files''' pane last files won't be renamed. 
If there is more lines in the clipboard text than files in '''Files''' pane, then last lines won't be used.
|-
| Export all columns to clipboard
| Exports ''all columns'' to clipboard as a tab separated text.
|}

=== Options menu ===

When you click on the [[Image:OptionsButton.png]] button, the following list pops up:
<center>[[Image:OptionsMenu.png]]</center>
{| class="prettytable"
|-
| Autosize columns
| Auto-size all columns, to accommodate the longest entry in each column.
|-
| Validate new names
| Check if the new names are valid.
|-
| Fix conflicting new names
| Add incremental numbers as suffixes to avoid conflicts in names. For example, if a new name for a file is Name1, and if such a file already exists in the target folder, then a suffix (2) is added to the newly renamed file. If more than one files have such name conflicts, ReNamer uses incremental numbers (i.e. (2), (3)...) as suffixes to make sure that each file gets a unique name.
|-
| Highlight changed names
| Usually you load files only because you want to change their names. Yet, sometimes, some files escape all the rules you have loaded and remain unchanged. In such cases, you may want to know why that happened.
ReNamer can highlight files that are going to be changed. Now you can investigate the remaining files.

'''Note:''' ''Highlight changed names'' option works as a switch: it turns highlighting ON and OFF.

'''Tip:''' You can unmark the rules selectively and see the effect on the files. That will tell you which rules are working on which files. Once your analysis is over, you can mark all rules.

|-
| Analyze sample text
| It opens the [[ReNamer:Analyze|Analyze window]].
Thanks to that option you don't have to load files to the '''Files''' pane just to check if your rules work as desired. 
It is extremally useful when you want to help others on the forum.

*Enter any text that looks like your target files, and see whether the rules work as desired on that text.
*Edit the rules if the desired result is not achieved
*Once you are satisfied with the rules, apply them on the real files or post the set of rules on the forum.

'''Note:''' Analyze sample text won't be any help if the rules base on the files properties (and not only on the filename). Analyze tool won't be able eg. to extract Meta tag from the text in its window.

|-
| Apply rules to the clipboard
| When you choose this option your rules will be applied to the text in clipboard instead of files in the '''Files''' pane. This might be useful eg. when working with word processors that don't support RegEx'es.
|-
| Count marked and selected files '''Alt + I'''
| It pops up a window like this
<center>[[Image:Count_marked_selected.png]]</center>

where '''Total''' stands for total number of files loaded into the '''Files''' pane, and
'''Marked''' and '''Selected''' stand for number of marked and selected files respectively.

|}

ReNamer:Rules:CleanUp

2009-08-29T14:59:42Z

Krtek: /* CleanUp Rule */

== CleanUp Rule ==
<center>[[Image:CleanUpRule.png]]</center>
This rule cleans up the filenames from (or for) commonly used naming conventions for internet, peer-to-peer networks and other resources. Multiple problems can be removed at once.

The parameters are as follows:

{| class="prettytable"
|-
| <center>'''Parameter'''</center>
| <center>'''Details'''</center>
|-
| Strip out content of brackets
| A typical use of this option is to strip the needless comments attached to filenames, such as '''(best!!)'''.
*This option removes the brackets also.
*You can select any/all of the various types of brackets.

If you do NOT want to delete the content within the brackets, use the [[ReNamer:Rules:Strip|Strip]] rule instead. 

|-
| Replace these characters with spaces
| These characters occurring in the file names are removed and a space is inserted in their place.
|-
|Fix spaces
|Replace multiple consecutive spaces with a single space.
It also removes spaces from the beginning and the end of the filename:
*If '''skip extention''' is selected it removes spaces from the beginning and end of the ''base name'' (''before'' the extention). 
*If '''skip extention''' is deselected it removes spaces from the beginning and from the end of the ''filename'' (''after'' the extention).

|-
|Insert a space in front of capitalized letters
|Often words in the file name are just joined together, without spaces or underscores to separate them. Each word begins with a capital letter, so that you can read it easily.

This option separates such words in the file name.
:For example, '''SeparateTheseWords.pdf''' becomes '''Separate These Words.pdf'''.

(Note that if there is a capitalized letter at the very beginning of the name, ReNamer does NOT add a space before it.)
|-
| Prepare for SharePoint
| Prepares the file for hosting it on [http://www.microsoft.com/sharepoint/prodinfo/what.mspx Microsoft Sharepoint].
#strips standard forbidden filename characters
#strips consecutive dots
#strips '''#''', '''%''', '''~''', '''&'''
#replaces '''{''' and '''}''' with '''(''' and ''')'''

|-
| Skip extension
| If this check box is selected, the extension will be ignored by the rule.
|}

ReNamer:Rules

2009-08-29T14:59:22Z

Krtek: /* Overview of Rules */

== Overview of Rules ==

ReNamer has an extensive set of rules. These rules can be combined together, in a logical sequence, to perform nearly any thinkable operation with the filename. You can also [[ReNamer:Manual editing|manually edit]] the name of any file.

The table below lists all rules, with a brief description of each rule. The subsequent chapters provide more details for each rule (follow the links).

{| class="prettytable"
|-
! Rules
! Description
|-
| [[ReNamer:Rules:Insert|Insert]]
| Insert the specified text into the filename: as prefix, as suffix, at the specified position, before- or after the specified text. There is also an option to insert meta tags into the filename.
|-
| [[ReNamer:Rules:Delete|Delete]]
| Delete a portion of the filename, usually defined by character positions: from the specified position, from the occurrence of the specified delimiter, until the specified number of characters, until occurrence of the specified delimiter or till the end. This rule can be set to process the filename in a right-to-left manner.
|-
| [[ReNamer:Rules:Remove|Remove]]
| Remove the specified text from the filename: first, last or all occurrences. Optionally, wildcards can be used within this rule, to remove masked text fragments.
|-
| [[ReNamer:Rules:Replace|Replace]]
| This rule is very much like the '''Remove '''rule (above). It has similar options, except that instead of removing the text fragments, it will replace them with the specified text.
|-
| [[ReNamer:Rules:Rearrange|Rearrange]]
| This rule allows you to chop up the existing file name by any delimiter or position and reuse any/all of the parts in any order to compose a new name.
|-
| [[ReNamer:Rules:Extension|Extension]]
| Change extension of files to the specified extension, or to the extension automatically detected through the internal database of binary signatures.
|-
| [[ReNamer:Rules:Strip|Strip]]
| Strip all occurrences of the specified characters from the filename. This rule has predefined character sets, like digits, symbols, brackets, but you can also define your own character set.
|-
| [[ReNamer:Rules:Case|Case]]
| Change the case of the filename: capitalize each word, to lower case, to upper case, invert case, or capitalize only the first letter and force the rest to lowercase (as in a sentence). There is also an option to force case for the manually entered fragments, for example: CD, DVD, India, ReNamer, etc.
|-
| [[ReNamer:Rules:Serialize|Serialize]]
| Use numeric incremental or random sequences of digits to put filenames into an order.
|-
| [[ReNamer:Rules:CleanUp|CleanUp]]
| Cleanup filenames from (or for) commonly used naming conventions for Internet, peer-to-peer networks, and other resources.
|-
| [[ReNamer:Rules:Translit|Translit]]
| Transliterate Non-English characters from different languages into their English/Latin representation. Useful for preparing files for network storage and transfer. Several transliteration maps are built in, and you can define your own maps.
|-
| [[ReNamer:Rules:RegEx|RegEx]]
|
RegEx (=Regular Expressions) is used for complex pattern/expression matching and replacing operations. Although it may look complex at first, you can learn it quite easily, using the guide provided in this manual!

|-
| [[ReNamer:Rules:PascalScript|PascalScript]]
| Scripting allows programming-aware users to code their own renaming rule using predefined set of functions. This rule uses Pascal/Delphi programming syntax and conventions. Extremely powerful feature in the right hands.
|-
| [[ReNamer:Rules:UserInput|UserInput]]
| Rule that simply sets the new names of the files to the names entered in a list (one name per line).
|}

Each of these rules are explained in the following sections.

ReNamer:Rules

2009-08-29T14:52:49Z

Krtek: /* Overview of Rules */

== Overview of Rules ==

ReNamer has an extensive set of rules. These rules can be combined together, in a logical sequence, to perform nearly any thinkable operation with the filename. You can also [[ReNamer:Manual editing|manually edit]] the name of any file.

The table below lists all rules, with a brief description of each rule. The subsequent chapters provide more details for each rule (follow the links).

{| class="prettytable"
|-
! Rules
! Description
|-
| [[ReNamer:Rules:Insert|Insert]]
| Insert the specified text into the filename: as prefix, as suffix, at the specified position, before- or after the specified text. There is also an option to insert meta tags into the filename.
|-
| [[ReNamer:Rules:Delete|Delete]]
| Delete a portion of the filename, usually defined by character positions: from the specified position, from the occurrence of the specified delimiter, until the specified number of characters, until occurrence of the specified delimiter or till the end. This rule can be set to process the filename in a right-to-left manner.
|-
| [[ReNamer:Rules:Remove|Remove]]
| Remove the specified text from the filename: first, last or all occurrences. Optionally, wildcards can be used within this rule, to remove masked text fragments.
|-
| [[ReNamer:Rules:Replace|Replace]]
| This rule is very much like the '''Remove '''rule (above). It has similar options, except that instead of removing the text fragments, it will replace them with the specified text.
|-
| [[ReNamer:Rules:Rearrange|Rearrange]]
| This rule allows you to chop up the existing file name by any delimiter or position and reuse any/all of the parts in any order to compose a new name.
|-
| [[ReNamer:Rules:Extension|Extension]]
| Change extension of files to the specified extension, or to the extension automatically detected through the internal database of binary signatures.
|-
| [[ReNamer:Rules:Strip|Strip]]
| Strip all occurrences of the specified characters from the filename. This rule has predefined character sets, like digits, symbols, brackets, but you can also define your own character set.
|-
| [[ReNamer:Rules:Case|Case]]
| Change the case of the filename: capitalize each word, to lower case, to upper case, invert case, or capitalize only the first letter and force the rest to lowercase (as in a sentence). There is also an option to force case for the manually entered fragments, for example: CD, DVD, India, ReNamer, etc.
|-
| [[ReNamer:Rules:Serialize|Serialize]]
| Use numeric incremental or random sequences of digits to put filenames into an order.
|-
| [[ReNamer:Rules:CleanUp|CleanUp]]
| Cleanup filenames for (or from) commonly used naming conventions for Internet, peer-to-peer networks, and other resources.
|-
| [[ReNamer:Rules:Translit|Translit]]
| Transliterate Non-English characters from different languages into their English/Latin representation. Useful for preparing files for network storage and transfer. Several transliteration maps are built in, and you can define your own maps.
|-
| [[ReNamer:Rules:RegEx|RegEx]]
|
RegEx (=Regular Expressions) is used for complex pattern/expression matching and replacing operations. Although it may look complex at first, you can learn it quite easily, using the guide provided in this manual!

|-
| [[ReNamer:Rules:PascalScript|PascalScript]]
| Scripting allows programming-aware users to code their own renaming rule using predefined set of functions. This rule uses Pascal/Delphi programming syntax and conventions. Extremely powerful feature in the right hands.
|-
| [[ReNamer:Rules:UserInput|UserInput]]
| Rule that simply sets the new names of the files to the names entered in a list (one name per line).
|}

Each of these rules are explained in the following sections.

ReNamer:Rules:CleanUp

2009-08-29T14:52:24Z

Krtek:

== CleanUp Rule ==
<center>[[Image:CleanUpRule.png]]</center>
This rule cleans up the filenames for (or from) commonly used naming conventions for internet, peer-to-peer networks and other resources. Multiple problems can be removed at once.

The parameters are as follows:

{| class="prettytable"
|-
| <center>'''Parameter'''</center>
| <center>'''Details'''</center>
|-
| Strip out content of brackets
| A typical use of this option is to strip the needless comments attached to filenames, such as '''(best!!)'''.
*This option removes the brackets also.
*You can select any/all of the various types of brackets.

If you do NOT want to delete the content within the brackets, use the [[ReNamer:Rules:Strip|Strip]] rule instead. 

|-
| Replace these characters with spaces
| These characters occurring in the file names are removed and a space is inserted in their place.
|-
|Fix spaces
|Replace multiple consecutive spaces with a single space.
It also removes spaces from the beginning and the end of the filename:
*If '''skip extention''' is selected it removes spaces from the beginning and end of the ''base name'' (''before'' the extention). 
*If '''skip extention''' is deselected it removes spaces from the beginning and from the end of the ''filename'' (''after'' the extention).

|-
|Insert a space in front of capitalized letters
|Often words in the file name are just joined together, without spaces or underscores to separate them. Each word begins with a capital letter, so that you can read it easily.

This option separates such words in the file name.
:For example, '''SeparateTheseWords.pdf''' becomes '''Separate These Words.pdf'''.

(Note that if there is a capitalized letter at the very beginning of the name, ReNamer does NOT add a space before it.)
|-
| Prepare for SharePoint
| Prepares the file for hosting it on [http://www.microsoft.com/sharepoint/prodinfo/what.mspx Microsoft Sharepoint].
#strips standard forbidden filename characters
#strips consecutive dots
#strips '''#''', '''%''', '''~''', '''&'''
#replaces '''{''' and '''}''' with '''(''' and ''')'''

|-
| Skip extension
| If this check box is selected, the extension will be ignored by the rule.
|}

ReNamer:Sorting files

2009-08-29T14:49:58Z

Krtek:

Sorting files in the '''Files''' pane can be done either manually or automatically. Manual sorting is done via the [[ReNamer:Menus for the Files pane|files table context menu]]. Automatic sorting is done via the '''Files''' pane column headers. ReNamer allows you to sort files by any of the available columns. Below are shown two examples where files are sorted by Name in ascending order and by Created Date in descending order.

<center>[[File:ReNamer Sort Name Ascending.png]] [[File:ReNamer Sort Date Descending.png]]</center>

Simply left-click on the column by which you would like to sort. You should see sort icon [[File:ReNamer Sort Triangle Ascending.png]] (ascending) appear beside the column name. Click again on the same column to sort in descending order, and the icon will change to [[File:ReNamer Sort Triangle Descending.png]] (descending).

Right-click on the column headers in order to get the full list of available columns and get an option to cancel the sorting.

<center>[[File:ReNamer Files Table Columns.png]]</center>

ReNamer:Meta Tags

2009-08-29T14:13:00Z

Krtek:

Meta tags allow users to extract some meta information associated with files and use it for renaming.

There are 2 different ways for using meta tags:

*Using [[ReNamer:Rules:Insert|Insert]] or [[ReNamer:Rules:Insert|Replace]] rule to insert meta data directly into the filename,
*Using [[ReNamer:Pascal Script:Functions#Meta Tags Extraction|CalculateMetaTag]] function in a [[ReNamer:Rules:PascalScript|PascalScript]] to do more complex manipulations with meta data.

{| class="wikitable"
|-
! Tag
! Description
|-
| Date_Now
| Current Date
|-
| File_SizeBytes
| Size of file in bytes
|-
| File_SizeKB
| Size of file in Kb
|-
| File_SizeMB
| Size of file in Mb
|-
| File_DateCreated
| File created date
|-
| File_DateModified
| File last modified date
|-
| File_FileName
| Full name of the file without the path
|-
| File_FilePath
| Full name of the file with the path
|-
| File_BaseName
| Base name of the file
|-
| File_Extension
| Extension of the file
|-
| File_FolderName
| Name of the parent folder
|-
| File_DOSName
| Short name in the 8.3 format
|-
| ID3_Artist
| ID3 Artist
|-
| ID3_Title
| ID3 Title
|-
| ID3_Album
| ID3 Album
|-
| ID3_Year
| ID3 Year
|-
| ID3_Genre
| ID3 Genre
|-
| ID3_TrackNo
| ID3 Track Number
|-
| ID3_PartOfSet
| ID3 Part Of Set
|-
| WMA_Artist
| WMA Artist
|-
| WMA_Title
| WMA Title
|-
| WMA_Album
| WMA Album
|-
| WMA_Year
| WMA Year
|-
| WMA_Genre
| WMA Genre
|-
| WMA_TrackNo
| WMA Track Number
|-
| FLAC_Artist
| FLAC Artist
|-
| FLAC_Title
| FLAC Title
|-
| FLAC_Album
| FLAC Album
|-
| FLAC_Year
| FLAC Year
|-
| FLAC_Genre
| FLAC Genre
|-
| FLAC_TrackNo
| FLAC Track Number
|-
| Audio_Duration
| Duration of an Audio file
|-
| Audio_DurationMins
| Duration of an Audio file in minutes
|-
| Audio_DurationSecs
| Duration of an Audio file in seconds
|-
| HTML_Title
| Title tag extracted from an HTML file
|-
| EXIF_Date
| EXIF Original Date
|-
| EXIF_Model
| EXIF Camera Model
|-
| EXIF_Make
| EXIF Camera Make
|-
| EXIF_Description
| EXIF Image Description
|-
| IPTC_ObjectName
| IPTC Object Name
|-
| IPTC_Caption
| IPTC Image Caption
|-
| IPTC_Headline
| IPTC Image Headline
|-
| IPTC_Location
| IPTC Location Name
|-
| IPTC_City
| IPTC City
|-
| TIFF_Date
| TIFF Date
|-
| TIFF_Model
| TIFF Model
|-
| TIFF_Make
| TIFF Make
|-
| TIFF_Description
| TIFF Description
|-
| Image_WidthAndHeight
| Real Width and Height of an image in pixels
|-
| Image_Width
| Real Width of an image in pixels
|-
| Image_Height
| Real Height of an image in pixels
|-
| Image_Pixels
| Amount of pixels in the image
|-
| Document_Title
| Summary Information: Title
|-
| Document_Subject
| Summary Information: Subject
|-
| Document_Author
| Summary Information: Author
|-
| Document_PageCount
| Summary Information: Number of Pages
|-
| Hash_MD5
| MD5 Hash of a file
|-
| Hash_SHA1
| SHA1 Hash of a file
|-
| Hash_CRC32
| CRC32 Checksum of a file
|-
| Email_DateSent
| Email date sent
|-
| Email_Subject
| Email subject
|-
| Email_Sender
| Email sender
|-
| Outlook_ID
| Outlook Message ID
|-
| Outlook_DateSent
| Outlook Message Date Sent
|-
| Outlook_Subject
| Outlook Message Subject
|-
| Outlook_Sender
| Outlook Message Sender
|-
| AVI_FramesPerSecond
| AVI Frames per Second
|-
| AVI_TotalFrames
| AVI Total amount of Frames
|-
| AVI_Duration
| AVI Duration in H:M:S format
|-
| AVI_DurationMins
| AVI Duration in Minutes
|-
| AVI_DurationSecs
| AVI Duration in Seconds
|-
| AVI_WidthAndHeight
| AVI Dimensions in WxH format
|-
| AVI_Width
| AVI Width in Pixels
|-
| AVI_Height
| AVI Height in Pixels
|-
| AVI_VideoCodec
| AVI Video Codec
|-
| BinarySign_Extension
| Binary File Signature: Extension
|-
| BinarySign_Description
| Binary File Information: Description
|-
| VersionInfo_Version
| Version Information: Version
|-
| VersionInfo_Product
| Version Information: Product
|-
| VersionInfo_Company
| Version Information: Company
|-
| VersionInfo_Copyright
| Version Information: Copyright
|-
| VersionInfo_Description
| Version Information: Description
|-
| VersionInfo_Comments
| Version Information: Comments
|}

== Editing Meta Tags ==

Editing meta tags is not supported, nor it will ever be. ReNamer is a file renaming tool, not a meta tag editing tool. Editing meta tags involves direct file content modification and requires a complete and thorough understanding and implementation of underlying standards. This is not only a dangerous business with a potential risk of destroying file content, but also requires huge amount of continues work.

ReNamer:Date and Time format

2009-08-29T13:56:14Z

Krtek:

Date-Time format is mostly used by the [[ReNamer:Meta_Tags|meta tags]]. You can define almost any thinkable format for all tags which extract a date-time field from the file. You can change it from within the [[ReNamer:Program settings#Meta tags settings|'''Settings''']] menu. Below is a list of variables which you can use.

{| class="prettytable"
|-
! Variable
! Description
|-
| <center>'''d'''</center>
| Displays the day as a number without a leading zero (1-31).
|-
| <center>'''dd'''</center>
| Displays the day as a number with a leading zero (01-31).
|-
| <center>'''ddd'''</center>
| Displays the day as an abbreviation (Sun-Sat).
|-
| <center>'''dddd'''</center>
| Displays the day as a full name (Sunday-Saturday).
|-
| <center>'''e'''</center>
| Displays the year in the current period/era as a number without a leading zero (Japanese, Korean and Taiwanese locales only).
|-
| <center>'''ee'''</center>
| Displays the year in the current period/era as a number with a leading zero (Japanese, Korean and Taiwanese locales only).
|-
| <center>'''g'''</center>
| Displays the period/era as an abbreviation (Japanese and Taiwanese locales only).
|-
| <center>'''gg'''</center>
| Displays the period/era as a full name. (Japanese and Taiwanese locales only).
|-
| <center>'''m'''</center>
| Displays the month as a number without a leading zero (1-12). If the m specifier immediately follows an h or hh specifier then minute is displayed.
|-
| <center>'''mm'''</center>
| Displays the month as a number with a leading zero (01-12). If the mm specifier immediately follows an h or hh specifier then minute is displayed.
|-
| <center>'''mmm'''</center>
| Displays the month as an abbreviation (Jan-Dec) using the strings given by the ShortMonthNames global variable.
|-
| <center>'''mmmm'''</center>
| Displays the month as a full name (January-December) using the strings given by the LongMonthNames global variable.
|-
| <center>'''yy'''</center>
| Displays the year as a two-digit number (00-99).
|-
| <center>'''yyyy'''</center>
| Displays the year as a four-digit number (0000-9999).
|-
| <center>'''h'''</center>
| Displays the hour without a leading zero (0-23).
|-
| <center>'''hh'''</center>
| Displays the hour with a leading zero (00-23).
|-
| <center>'''n'''</center>
| Displays the minute without a leading zero (0-59).
|-
| <center>'''nn'''</center>
| Displays the minute with a leading zero (00-59).
|-
| <center>'''s'''</center>
| Displays the second without a leading zero (0-59).
|-
| <center>'''ss'''</center>
| Displays the second with a leading zero (00-59).
|-
| <center>'''z'''</center>
| Displays the millisecond without a leading zero (0-999).
|-
| <center>'''zzz'''</center>
| Displays the millisecond with a leading zero (000-999).
|-
| <center>'''am/pm'''</center>
| 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. The am/pm specifier can use lower, upper, or mixed case, and the result is displayed accordingly.
|-
| <center>'''a/p'''</center>
| 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.
|-
| <center>'''"xx"'''</center>
| Characters enclosed in single or double quotes are displayed as-is, and the formatting is not applied to them. The only way to put '''d''', '''m''', '''y''' or any other meaningful letter into your format.
|}

For example, if we assume that the date is 25-th of October 2007 and the time is 16:59:00, then sample formats and their outputs would be:

*'''dd-mm-yyyy hh.nn.ss''' format will produce '''25-10-2007 16.59.00''', which is an easily readable format for the date and time.
*'''"It's" dddd, hh:nn:ss AM/PM''' format will produce '''It's Thursday, 4:59:00 PM''', which is unsuitable for filenames because of ''':''' forbidden character.
*'''yyyymmddhhnnss''' format will produce '''20071025165900''', which is ideal for serializing files because the filename is relatively short, most probably unique, contains only digits, and also makes files automatically sorted in chronological order.

ReNamer:Date and Time format

2009-08-29T13:54:34Z

Krtek:

Date-Time format is mostly used by the [[ReNamer:Meta_Tags|meta tags]]. You can define almost any thinkable format for all tags which extract a date-time field from the file. You can change it from within the [[ReNamer:Program settings#Meta tags settings|'''Settings''']] menu. Below is a list of variables which you can use.

{| class="prettytable"
|-
! Variable
! Description
|-
| <center>'''d'''</center>
| Displays the day as a number without a leading zero (1-31).
|-
| <center>'''dd'''</center>
| Displays the day as a number with a leading zero (01-31).
|-
| <center>'''ddd'''</center>
| Displays the day as an abbreviation (Sun-Sat).
|-
| <center>'''dddd'''</center>
| Displays the day as a full name (Sunday-Saturday).
|-
| <center>'''e'''</center>
| Displays the year in the current period/era as a number without a leading zero (Japanese, Korean and Taiwanese locales only).
|-
| <center>'''ee'''</center>
| Displays the year in the current period/era as a number with a leading zero (Japanese, Korean and Taiwanese locales only).
|-
| <center>'''g'''</center>
| Displays the period/era as an abbreviation (Japanese and Taiwanese locales only).
|-
| <center>'''gg'''</center>
| Displays the period/era as a full name. (Japanese and Taiwanese locales only).
|-
| <center>'''m'''</center>
| Displays the month as a number without a leading zero (1-12). If the m specifier immediately follows an h or hh specifier then minute is displayed.
|-
| <center>'''mm'''</center>
| Displays the month as a number with a leading zero (01-12). If the mm specifier immediately follows an h or hh specifier then minute is displayed.
|-
| <center>'''mmm'''</center>
| Displays the month as an abbreviation (Jan-Dec) using the strings given by the ShortMonthNames global variable.
|-
| <center>'''mmmm'''</center>
| Displays the month as a full name (January-December) using the strings given by the LongMonthNames global variable.
|-
| <center>'''yy'''</center>
| Displays the year as a two-digit number (00-99).
|-
| <center>'''yyyy'''</center>
| Displays the year as a four-digit number (0000-9999).
|-
| <center>'''h'''</center>
| Displays the hour without a leading zero (0-23).
|-
| <center>'''hh'''</center>
| Displays the hour with a leading zero (00-23).
|-
| <center>'''n'''</center>
| Displays the minute without a leading zero (0-59).
|-
| <center>'''nn'''</center>
| Displays the minute with a leading zero (00-59).
|-
| <center>'''s'''</center>
| Displays the second without a leading zero (0-59).
|-
| <center>'''ss'''</center>
| Displays the second with a leading zero (00-59).
|-
| <center>'''z'''</center>
| Displays the millisecond without a leading zero (0-999).
|-
| <center>'''zzz'''</center>
| Displays the millisecond with a leading zero (000-999).
|-
| <center>'''am/pm'''</center>
| 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. The am/pm specifier can use lower, upper, or mixed case, and the result is displayed accordingly.
|-
| <center>'''a/p'''</center>
| 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.
|-
| <center>'''"xx"'''</center>
| Characters enclosed in single or double quotes are displayed as-is, and do not affect formatting.
|}

For example, if we assume that the date is 25-th of October 2007 and the time is 16:59:00, then sample formats and their outputs would be:

*'''dd-mm-yyyy hh.nn.ss''' format will produce '''25-10-2007 16.59.00''', which is an easily readable format for the date and time.
*'''"It's" dddd, hh:nn:ss AM/PM''' format will produce '''It's Thursday, 4:59:00 PM''', which is unsuitable for filenames because of ''':''' forbidden character.
*'''yyyymmddhhnnss''' format will produce '''20071025165900''', which is ideal for serializing files because the filename is relatively short, most probably unique, contains only digits, and also makes files automatically sorted in chronological order.

ReNamer:Menus for the Files pane

2009-08-29T13:24:59Z

Krtek:

ReNamer:Menus for the Files pane

2009-08-29T13:21:27Z

Krtek:

ReNamer has a menu bar between the '''Rules''' and '''Files''' panes [[Image:MenuStrip.png]].

This appendix describes options available from this menu.

=== Files button ===

When you click on the [[Image:FilesButton.png]] button, the following list pops up:
<center>[[Image:FileMenu.png]]</center>
{| class="prettytable" style="width: 619px; height: 218px;"
|-
| Analyze Name
| Opens [[ReNamer:Analyze|analysis window]], and loads the names of the selected files into it.
|-
| Edit New Name '''F2'''
| Starts manual editing of the selected filename.
|-
| [[ReNamer:Menus for the Files pane#Shell submenu|Shell]]
| Options for Windows shell operations.
|-
| [[ReNamer:Menus for the Files pane#Mark submenu|Mark]]
| Options for [[ReNamer:Adding_files_and_folders#Marking_and_Unmarking_the_files|marking]] specific items.
|-
| [[ReNamer:Menus for the Files pane#Clear submenu|Clear]]
| Options for [[ReNamer:Adding_files_and_folders#Marking_and_Unmarking_the_files|removing]] specific items from the '''Files''' pane.
|-
| [[ReNamer:Menus for the Files pane#Select submenu|Select]]
| Options for [[ReNamer:Adding_files_and_folders#Selecting_files|selecting]] specific items.
|-
| [[ReNamer:Menus for the Files pane#Move submenu|Move]]
| Options for moving specific items.
|-
| Remove selected items '''Del'''
| Remove selected items from the ReNamer's '''File''' pane. (This command does not delete the items from the disk.)
|}

This menu provides second-level options, as follows:

==== Shell submenu ====
<center>[[Image:ShellSubMenu.png]]</center>
 

{| class="prettytable"
|-
| Open File'''                Enter'''
| Open the selected file using its default associated application.
|-
| Open with Notepad'''  Shift+Enter'''
| Open the file with notepad. Useful when you want to see the raw data in the file. (When viewed this way, the file will not be displayed in its original formatting. It may not be easily readable.)
|-
| Open operating folder '''Ctrl+Enter'''
| Launch Windows Explorer and open the folder where the selected file is located. Highlight (select) the file in it.
|-
| File properties '''Alt+Enter'''
| Display the properties of the selected file. Typically, file size, dates (created/modified/accessed), comments, author, attributes (hidden, system, etc.)
|-
| Cut Files to clipboard '''Shift+Ctrl+X'''
| Cuts the selected file(s) to clipboard. All files will be moved to one folder, no matter where they were initially located. (Note: If you do not paste the file(s) in a target application, the '''Cut''' operation is automatically canceled.)
|-
| Copy Files to clipboard '''Shift+Ctrl+C'''
| Copies selected file(s) to clipboard. All files will be copied to one folder, no matter where they were initially located.
|-
| Delete files to Recycle Bin
| Deletes the selected file(s) to Recycle Bin. (They can be recovered from the Recycle Bin.)
Note that if the file is too large for the Recycle Bin, Windows will warn you that it will not be put in Recycle Bin, but deleted permanently. If you confirm, the file is deleted permanently.

|}

==== Mark submenu ====
<center>[[Image:MarkSubmenu.png]]</center>
'''Note'''''': '''Marking of files is explained [[ReNamer:Adding files and folders#Marking_and_Unmarking_the_files|here]]. 

{| class="prettytable"
|-
| Mark'''       Shift+M'''
| Mark all selected files. If some files are already marked, they remain marked.
|-
| UnMark'''   Shift+U'''
| Unmark all selected files. If some files are already unmarked, they remain unmarked.
|-
| Invert Marking '''Ins'''
| Marked files become unmarked, and vice versa.
|-
| Mark only changed (Inc. Case)
| [[ReNamer:Adding files and folders#Marking_and_Unmarking_the_files|Mark]] files that have been changed. Files that had just change of case (and nothing else) will also be marked. ("''Change of case''" means some letters are converted capital-to-small and/or small-to-capital)
|-
| Mark only changed (Exc. Case)
| [[ReNamer:Adding files and folders#Marking_and_Unmarking_the_files|Mark]] files that have been changed, but do not consider changes of case. ("''Change of case''" means some letters are converted capital-to-small and/or small-to-capital)
|-
| Mark only selected
| Mark files that are selected. If some unselected files are already marked, they will be unmarked.
|-
| Mark by Mask
| Pops up a Mask window:
[[Image:MarkByMask.png]]

Specify a mask pattern. All files that match this mask will be marked.

You can enter multiple masks (separating them with semicolon). If a file matches any of these masks, it will be marked.

|}

==== Clear submenu ====
<center>[[Image:ClearSubmenu.png]]</center>
'''Note''': The term "''Clear''" means remove from '''Files''' pane of ReNamer. 

{| class="prettytable"
|-
| Clear All
| Clear all files loaded in the pane.
|-
| Clear Renamed
| Clear all files which have been renamed just before this command. Note that even if some files are not affected by the rules, they are still regarded as renamed successfully.
Only files that failed to rename (those with an '''x''' mark) will remain in the pane.

|-
| Clear Failed
| Only files that failed to rename (those with an '''x''' mark) will be cleared.
All other files (including files whose names were not altered by the rules) will remain in the '''Files''' pane.

|-
| Clear Valid
| Clear files that have valid names after Preview (but haven't been renamed yet).
|-
| Clear Invalid
| Clear files that got invalid (causing conflicts, empty or with forbidden characters etc.) names after Preview (but before renaming).
|-
| Clear Marked
| Clear all marked files.
|-
| Clear Not Marked
| Clear all files that are not marked.
|-
| Clear Not Changed '''Ctrl+D'''
| Clear all files that haven't been changed by the Preview. This also includes all files that have their New Name field empty (eg. because they have been successfully renamed or haven't been previewed since last renaming operation).
|}

==== Select submenu ====
<center>[[Image:SelectSubmenu.png]]</center>
Note: Selection of files is explained [[ReNamer:Adding files and folders#Selecting_files|here]]. 

{| class="prettytable"
|-
| Select All'''  Ctrl+A'''
| All files in the pane will be selected.
|-
| Invert Selection'''  Ctrl+I'''
| Selected files become deselected, and vice versa.
|-
| Select by Name Length  '''Ctrl+L'''
| Pops up a window:
[[Image:SelectByFileNameLengthDialog.png]]

Specify the length of file name. Only files that exceed that length will be selected.

The length refers to the whole filename including dot and the extension.

'''Note''': A typical application is to check if the file can be put on a CD/DVD. The maximum length allowed in ISO 9660-compliant file-system is 64 characters. Longer file names are truncated when you burn a CD/DVD. It is difficult to correlate such files with their originals. To avoid such problems, shorten the names ''before'' burning the CD/DVD.

|-
| Select by Extension  '''Ctrl+E'''
| Pops up a window:
[[Image:SelectByExtnDialog.png]]

Specify the extension (without the dot). All files having that extension will be selected.

You can enter multiple extensions (they must be separated by semicolons - not comma).

|-
| Select by Mask'''  Ctrl+M'''
| Pops up this window:
[[Image:SelectByMask.png]]

Specify the [[ReNamer:Masks|mask]]. All files matching that pattern will be selected. You can enter multiple masks (they must be separated by semicolons - not comma).

|}

==== Move submenu ====
<center>[[Image:MoveSubmenu.png]]</center>
 

{| class="prettytable"
|-
| Up'''      Ctrl+Up'''
| Moves the selected file up. This is used to re-arrange files in the list.
It is easier to use the keyboard shortcut '''CTRL+UpArrow'''.

|-
| Down'''  Ctrl+Down'''
| Moves the selected file down. This is used to re-arrange the files list.
It is easier to use the keyboard shortcut '''CTRL+DownArrow'''.

|}

=== Filters menu ===

When you click on the [[Image:FiltersButton.png]] button, the '''Filters''' window pops up. It controls what gets added to the '''Files''' pane when you use the [[Image:AddFoldersButton.png]] button or [[ReNamer:Adding files and folders#Adding files using the Drag-and-drop method|Drag & Drop]] or [[ReNamer:Adding files and folders#Adding files using the copy-and-paste method |Copy & Paste]] methods. 

{| class="prettytable"
|-
| [[Image:FilterSettingsDialog.png]]
| The options work as follows:
{| class="prettytable"
|-
| <center>'''Option'''</center>
| <center>'''Effect'''</center>
|-
| Add files within folders
| If you want to rename only directories, you would need to UNTICK ''Add files within folders'' option, and tick ''Add folders as files'' option. This will stop files being added from scanned folders.
|-
| Add folders as files
| ReNamer treats folder just like a single filename (not as a container that holds files and subfolders). So only the folder is loaded, and not the files in it. Useful for renaming the folder itself.
|-
| Include subfolders
| Loads contents from all subfolders recursively.
|-
| Include hidden items
| To protect hidden items, deselect this option.
|-
| Include system items
| To protect files reserved for system (OS), deselect this option.
|-
| Skip root folders when added as files
| Works when the ''Add folders as files'' and ''Include subfolders'' options are selected. When it's on, ReNamer adds all the subfolders but not the root folder itself.
|-
| Masks
| All added files (or folders as files) must match specified [[ReNamer:Masks|mask(s)]]. For example, if you enter '''*.jpg;*.gif;*.png''' as masks, ReNamer will add only files with these extensions. Everything else will be filtered ''out''(not added to ReNamer).
|-
| Apply only to the file name
| Changes how the masks (see above) are applied.
For example, suppose you have file '''''C:\Folder\File.ext'''''. If ''this'' option is ON, only the filename part ('''''File.ext''''') will be checked against the mask(s). But if ''this'' option is OFF, the entire path ('''''C:\Folder\File.ext''''') will be checked against the mask(s).

|}

Press '''Save''' to save changes.

|}

'''Filters''' menu is also accessible from the '''Add Folder''' window. For details see [[ReNamer:Adding files and folders#Adding items using the 'Add Folders' button |Adding items using the 'Add Folders' button]] section.

=== Export menu ===
When you click on the [[Image:ExportButton.png]] button, the following list pops up:

<center>[[Image:ExportMenu.png]]</center>

{| class="prettytable"
| Export file paths and undo paths
| Exports file paths and undo paths to the .csv (comma separated) or .txt (tab separated) file.

|-
| Export file paths and new names
| Exports file paths and new names to the .csv (comma separated) or .txt (tab separated) file.

|-
| Import file paths and new names
| Imports file paths and new names from the .csv (comma separated) or .txt (tab separated) file.

|-
| Import files from text-list or play-list
| Imports file paths from the .txt/.log file (one file per line) or .m3u/.pls playlist.

'''Note:''' It will load file paths into '''Files''' pane only if the file really exists on your file system.
|-
| Export new names to clipboard
| Export new names to clipboard. One name per line.

|-
| Import new names from clipboard
| Imports new names from clipboard. Every name should be placed in a new line.

If there is less lines in the clipboard text than files in '''Files''' pane last files won't be renamed. 
If there is more lines in the clipboard text than files in '''Files''' pane, then last lines won't be used.
|-
| Export all columns to clipboard
| Exports all columns to clipboard as a tab separated text.
|}

=== Options menu ===

When you click on the [[Image:OptionsButton.png]] button, the following list pops up:
<center>[[Image:OptionsMenu.png]]</center>
{| class="prettytable"
|-
| Autosize columns
| Auto-size all columns, to accommodate the longest entry in each column.
|-
| Validate new names
| Check if the new names are valid.
|-
| Fix conflicting new names
| Add incremental numbers as suffixes to avoid conflicts in names. For example, if a new name for a file is Name1, and if such a file already exists in the target folder, then a suffix (2) is added to the newly renamed file. If more than one files have such name conflicts, ReNamer uses incremental numbers (i.e. (2), (3)...) as suffixes to make sure that each file gets a unique name.
|-
| Highlight changed names
| Usually you load files only because you want to change their names. Yet, sometimes, some files escape all the rules you have loaded and remain unchanged. In such cases, you may want to know why that happened.
ReNamer can highlight files that are going to be changed. Now you can investigate the remaining files.

'''Note:''' ''Highlight changed names'' option works as a switch: it turns highlighting ON and OFF.

'''Tip:''' You can unmark the rules selectively and see the effect on the files. That will tell you which rules are working on which files. Once your analysis is over, you can mark all rules.

|-
| Analyze sample text
| It opens the [[ReNamer:Analyze|Analyze window]].
Thanks to that option you don't have to load files to the '''Files''' pane just to check if your rules work as desired. 
It is extremally useful when you want to help others on the forum.

*Enter any text that looks like your target files, and see whether the rules work as desired on that text.
*Edit the rules if the desired result is not achieved
*Once you are satisfied with the rules, apply them on the real files or post the set of rules on the forum.

'''Note:''' Analyze sample text won't be any help if the rules base on the files properties (and not only on the filename). Analyze tool won't be able eg. to extract Meta tag from the text in its window.

|-
| Apply rules to the clipboard
| When you choose this option your rules will be applied to the text in clipboard instead of files in the '''Files''' pane. This might be useful eg. when working with word processors that don't support RegEx'es.
|-
| Count marked and selected files '''Alt + I'''
| It pops up a window with numbers of selected and marked files.
|}

ReNamer:Menus for the Files pane

2009-08-29T08:12:17Z

Krtek:

ReNamer has a menu bar between the '''Rules''' and '''Files''' panes [[Image:MenuStrip.png]].

This appendix describes options available from this menu.

=== Files button ===

When you click on the [[Image:FilesButton.png]] button, the following list pops up:
<center>[[Image:FileMenu.png]]</center>
{| class="prettytable" style="width: 619px; height: 218px;"
|-
| Analyze Name
| Opens [[ReNamer:Analyze|analysis window]], and loads the names of the selected files into it.
|-
| Edit New Name '''F2'''
| Starts manual editing of the selected filename.
|-
| [[ReNamer:Menus for the Files pane#Shell submenu|Shell]]
| Options for Windows shell operations.
|-
| [[ReNamer:Menus for the Files pane#Mark submenu|Mark]]
| Options for [[ReNamer:Adding_files_and_folders#Marking_and_Unmarking_the_files|marking]] specific items.
|-
| [[ReNamer:Menus for the Files pane#Clear submenu|Clear]]
| Options for [[ReNamer:Adding_files_and_folders#Marking_and_Unmarking_the_files|removing]] specific items from the '''Files''' pane.
|-
| [[ReNamer:Menus for the Files pane#Select submenu|Select]]
| Options for [[ReNamer:Adding_files_and_folders#Selecting_files|selecting]] specific items.
|-
| [[ReNamer:Menus for the Files pane#Move submenu|Move]]
| Options for moving specific items.
|-
| Remove selected items '''Del'''
| Remove selected items from the ReNamer's '''File''' pane. (This command does not delete the items from the disk.)
|}

This menu provides second-level options, as follows:

==== Shell submenu ====
<center>[[Image:ShellSubMenu.png]]</center>
 

{| class="prettytable"
|-
| Open File'''                Enter'''
| Open the selected file using its default associated application.
|-
| Open with Notepad'''  Shift+Enter'''
| Open the file with notepad. Useful when you want to see the raw data in the file. (When viewed this way, the file will not be displayed in its original formatting. It may not be easily readable.)
|-
| Open operating folder '''Ctrl+Enter'''
| Launch Windows Explorer and open the folder where the selected file is located. Highlight (select) the file in it.
|-
| File properties '''Alt+Enter'''
| Display the properties of the selected file. Typically, file size, dates (created/modified/accessed), comments, author, attributes (hidden, system, etc.)
|-
| Cut Files to clipboard '''Shift+Ctrl+X'''
| Cuts the selected file(s) to clipboard. All files will be moved to one folder, no matter where they were initially located. (Note: If you do not paste the file(s) in a target application, the '''Cut''' operation is automatically canceled.)
|-
| Copy Files to clipboard '''Shift+Ctrl+C'''
| Copies selected file(s) to clipboard. All files will be copied to one folder, no matter where they were initially located.
|-
| Delete files to Recycle Bin
| Deletes the selected file(s) to Recycle Bin. (They can be recovered from the Recycle Bin.)
Note that if the file is too large for the Recycle Bin, Windows will warn you that it will not be put in Recycle Bin, but deleted permanently. If you confirm, the file is deleted permanently.

|}

==== Mark submenu ====
<center>[[Image:MarkSubmenu.png]]</center>
'''Note'''''': '''Marking of files is explained [[ReNamer:Adding files and folders#Marking_and_Unmarking_the_files|here]]. 

{| class="prettytable"
|-
| Mark'''       Shift+M'''
| Mark all selected files. If some files are already marked, they remain marked.
|-
| UnMark'''   Shift+U'''
| Unmark all selected files. If some files are already unmarked, they remain unmarked.
|-
| Invert Marking '''Ins'''
| Marked files become unmarked, and vice versa.
|-
| Mark only changed (Inc. Case)
| [[ReNamer:Adding files and folders#Marking_and_Unmarking_the_files|Mark]] files that have been changed. Files that had just change of case (and nothing else) will also be marked. ("''Change of case''" means some letters are converted capital-to-small and/or small-to-capital)
|-
| Mark only changed (Exc. Case)
| [[ReNamer:Adding files and folders#Marking_and_Unmarking_the_files|Mark]] files that have been changed, but do not consider changes of case. ("''Change of case''" means some letters are converted capital-to-small and/or small-to-capital)
|-
| Mark only selected
| Mark files that are selected. If some unselected files are already marked, they will be unmarked.
|-
| Mark by Mask
| Pops up a Mask window:
[[Image:MarkByMask.png]]

Specify a mask pattern. All files that match this mask will be marked.

You can enter multiple masks (separating them with semicolon). If a file matches any of these masks, it will be marked.

|}

==== Clear submenu ====
<center>[[Image:ClearSubmenu.png]]</center>
'''Note''': The term "''Clear''" means remove from '''Files''' pane of ReNamer. 

{| class="prettytable"
|-
| Clear All
| Clear all files loaded in the pane.
|-
| Clear Renamed
| Clear all files which have been renamed just before this command. Note that even if some files are not affected by the rules, they are still regarded as renamed successfully.
Only files that failed to rename (those with an '''x''' mark) will remain in the pane.

|-
| Clear Failed
| Only files that failed to rename (those with an '''x''' mark) will be cleared.
All other files (including files whose names were not altered by the rules) will remain in the '''Files''' pane.

|-
| Clear Valid
| Clear files that have valid names after Preview (but haven't been renamed yet).
|-
| Clear Invalid
| Clear files that got invalid (causing conflicts, empty or with forbidden characters etc.) names after Preview (but before renaming).
|-
| Clear Marked
| Clear all marked files.
|-
| Clear Not Marked
| Clear all files that are not marked.
|-
| Clear Not Changed '''Ctrl+D'''
| Clear all files that haven't been changed by the Preview. This also includes all files that have their New Name field empty (eg. because they have been successfully renamed or haven't been previewed since last renaming operation).
|}

==== Select submenu ====
<center>[[Image:SelectSubmenu.png]]</center>
Note: Selection of files is explained [[ReNamer:Adding files and folders#Selecting_files|here]]. 

{| class="prettytable"
|-
| Select All'''  Ctrl+A'''
| All files in the pane will be selected.
|-
| Invert Selection'''  Ctrl+I'''
| Selected files become deselected, and vice versa.
|-
| Select by Name Length  '''Ctrl+L'''
| Pops up a window:
[[Image:SelectByFileNameLengthDialog.png]]

Specify the length of file name. Only files that exceed that length will be selected.

The length refers to the whole filename including dot and the extension.

'''Note''': A typical application is to check if the file can be put on a CD/DVD. The maximum length allowed in ISO 9660-compliant file-system is 64 characters. Longer file names are truncated when you burn a CD/DVD. It is difficult to correlate such files with their originals. To avoid such problems, shorten the names ''before'' burning the CD/DVD.

|-
| Select by Extension  '''Ctrl+E'''
| Pops up a window:
[[Image:SelectByExtnDialog.png]]

Specify the extension (without the dot). All files having that extension will be selected.

You can enter multiple extensions (they must be separated by semicolons - not comma).

|-
| Select by Mask'''  Ctrl+M'''
| Pops up this window:
[[Image:SelectByMask.png]]

Specify the [[ReNamer:Masks|mask]]. All files matching that pattern will be selected. You can enter multiple masks (they must be separated by semicolons - not comma).

|}

==== Move submenu ====
<center>[[Image:MoveSubmenu.png]]</center>
 

{| class="prettytable"
|-
| Up'''      Ctrl+Up'''
| Moves the selected file up. This is used to re-arrange files in the list.
It is easier to use the keyboard shortcut '''CTRL+UpArrow'''.

|-
| Down'''  Ctrl+Down'''
| Moves the selected file down. This is used to re-arrange the files list.
It is easier to use the keyboard shortcut '''CTRL+DownArrow'''.

|}

=== Filters menu ===

When you click on the [[Image:FiltersButton.png]] button, the '''Filters''' window pops up. It controls what gets added to the '''Files''' pane when you use the [[Image:AddFoldersButton.png]] button or [[ReNamer:Adding files and folders#Adding files using the Drag-and-drop method|Drag & Drop]] or [[ReNamer:Adding files and folders#Adding files using the copy-and-paste method |Copy & Paste]] methods. 

{| class="prettytable"
|-
| [[Image:FilterSettingsDialog.png]]
| The options work as follows:
{| class="prettytable"
|-
| <center>'''Option'''</center>
| <center>'''Effect'''</center>
|-
| Add files within folders
| If you want to rename only directories, you would need to UNTICK ''Add files within folders'' option, and tick ''Add folders as files'' option. This will stop files being added from scanned folders.
|-
| Add folders as files
| ReNamer treats folder just like a single filename (not as a container that holds files and subfolders). So only the folder is loaded, and not the files in it. Useful for renaming the folder itself.
|-
| Include subfolders
| Loads contents from all subfolders recursively.
|-
| Include hidden items
| To protect hidden items, deselect this option.
|-
| Include system items
| To protect files reserved for system (OS), deselect this option.
|-
| Skip root folders when added as files
| Works when the ''Add folders as files'' and ''Include subfolders'' options are selected. When it's on, ReNamer adds all the subfolders but not the root folder itself.
|-
| Masks
| All added files (or folders as files) must match specified [[ReNamer:Masks|mask(s)]]. For example, if you enter '''*.jpg;*.gif;*.png''' as masks, ReNamer will add only files with these extensions. Everything else will be filtered ''out''(not added to ReNamer).
|-
| Apply only to the file name
| Changes how the masks (see above) are applied.
For example, suppose you have file '''''C:\Folder\File.ext'''''. If ''this'' option is ON, only the filename part ('''''File.ext''''') will be checked against the mask(s). But if ''this'' option is OFF, the entire path ('''''C:\Folder\File.ext''''') will be checked against the mask(s).

|}

Press '''Save''' to save changes.

|}

'''Filters''' menu is also accessible from the '''Add Folder''' window. For details see [[ReNamer:Adding files and folders#Adding items using the 'Add Folders' button |Adding items using the 'Add Folders' button]] section.

=== Export menu ===
When you click on the [[Image:ExportButton.png]] button, the following list pops up:

<center>[[Image:ExportMenu.png]]</center>

{| class="prettytable"
| Export the paths and undo paths
|

|-
| Export the paths and new names
|

|-
| Import the paths and new names
|

|-
| Import files from text-list or play-list
|

|-
| Export new names to clipboard
|

|-
| Import new names from clipboard
|

|}

=== Options menu ===

When you click on the [[Image:OptionsButton.png]] button, the following list pops up:
<center>[[Image:OptionsMenu.png]]</center>
{| class="prettytable"
|-
| Autosize columns
| Auto-size all columns, to accommodate the longest entry in each column.
|-
| Validate new names
| Check if the new names are valid.
|-
| Fix conflicting new names
| Add incremental numbers as suffixes to avoid conflicts in names. For example, if a new name for a file is Name1, and if such a file already exists in the target folder, then a suffix (2) is added to the newly renamed file. If more than one files have such name conflicts, ReNamer uses incremental numbers (i.e. (2), (3)...) as suffixes to make sure that each file gets a unique name.
|-
| Highlight changed names
| Usually you load files only because you want to change their names. Yet, sometimes, some files escape all the rules you have loaded and remain unchanged. In such cases, you may want to know why that happened.
ReNamer can highlight files that are going to be changed. Now you can investigate the remaining files.

'''Note:''' ''Highlight changed names'' option works as a switch: it turns highlighting ON and OFF.

'''Tip:''' You can unmark the rules selectively and see the effect on the files. That will tell you which rules are working on which files. Once your analysis is over, you can mark all rules.

|-
| Analyze sample text
| It opens the [[ReNamer:Analyze|Analyze window]].
You don't have to load files to the '''Files''' pane just to check if your rules work as desired. 
It is extremally useful when you won't to help others on the forum.

*Enter any text that looks like your target files, and see whether the rules work as desired on that text.
*Edit the rules if the desired result is not achieved
*Once you are satisfied with the rules, apply them on the real files or post the set of rules on the forum.

'''Note:''' Analyze sample text won't be any help if the rules base on the files properties (and not only on the filename). Analyze tool won't be able eg. to extract Meta tag from the text in its window.

|-
| Apply rules to the clipboard
| When you choose this option your rules will be applied to the text in clipboard instead of files in the '''Files''' pane. This might be useful eg. when working with word processors that don't support RegEx'es.
|-
| Count marked and selected files '''Alt + I'''
| It pops up a window with numbers of selected and marked files.
|}

ReNamer:Menus for the Files pane

2009-08-29T08:02:44Z

Krtek:

ReNamer has a menu bar between the '''Rules''' and '''Files''' panes [[Image:MenuStrip.png]].

This appendix describes options available from this menu.

=== Files button ===

When you click on the [[Image:FilesButton.png]] button, the following list pops up:
<center>[[Image:FileMenu.png]]</center>
{| class="prettytable" style="width: 619px; height: 218px;"
|-
| Analyze Name
| Opens [[ReNamer:Analyze|analysis window]], and loads the names of the selected files into it.
|-
| Edit New Name '''F2'''
| Starts manual editing of the selected filename.
|-
| [[ReNamer:Menus for the Files pane#Shell submenu|Shell]]
| Options for Windows shell operations.
|-
| [[ReNamer:Menus for the Files pane#Mark submenu|Mark]]
| Options for [[ReNamer:Adding_files_and_folders#Marking_and_Unmarking_the_files|marking]] specific items.
|-
| [[ReNamer:Menus for the Files pane#Clear submenu|Clear]]
| Options for [[ReNamer:Adding_files_and_folders#Marking_and_Unmarking_the_files|removing]] specific items from the '''Files''' pane.
|-
| [[ReNamer:Menus for the Files pane#Select submenu|Select]]
| Options for [[ReNamer:Adding_files_and_folders#Selecting_files|selecting]] specific items.
|-
| [[ReNamer:Menus for the Files pane#Move submenu|Move]]
| Options for moving specific items.
|-
| Remove selected items '''Del'''
| Remove selected items from the ReNamer's '''File''' pane. (This command does not delete the items from the disk.)
|}

This menu provides second-level options, as follows:

==== Shell submenu ====
<center>[[Image:ShellSubMenu.png]]</center>
 

{| class="prettytable"
|-
| Open File'''                Enter'''
| Open the selected file using its default associated application.
|-
| Open with Notepad'''  Shift+Enter'''
| Open the file with notepad. Useful when you want to see the raw data in the file. (When viewed this way, the file will not be displayed in its original formatting. It may not be easily readable.)
|-
| Open operating folder '''Ctrl+Enter'''
| Launch Windows Explorer and open the folder where the selected file is located. Highlight (select) the file in it.
|-
| File properties '''Alt+Enter'''
| Display the properties of the selected file. Typically, file size, dates (created/modified/accessed), comments, author, attributes (hidden, system, etc.)
|-
| Cut Files to clipboard '''Shift+Ctrl+X'''
| Cuts the selected file(s) to clipboard. All files will be moved to one folder, no matter where they were initially located. (Note: If you do not paste the file(s) in a target application, the '''Cut''' operation is automatically canceled.)
|-
| Copy Files to clipboard '''Shift+Ctrl+C'''
| Copies selected file(s) to clipboard. All files will be copied to one folder, no matter where they were initially located.
|-
| Delete files to Recycle Bin
| Deletes the selected file(s) to Recycle Bin. (They can be recovered from the Recycle Bin.)
Note that if the file is too large for the Recycle Bin, Windows will warn you that it will not be put in Recycle Bin, but deleted permanently. If you confirm, the file is deleted permanently.

|}

==== Mark submenu ====
<center>[[Image:MarkSubmenu.png]]</center>
'''Note'''''': '''Marking of files is explained [[ReNamer:Adding files and folders#Marking_and_Unmarking_the_files|here]]. 

{| class="prettytable"
|-
| Mark'''       Shift+M'''
| Mark all selected files. If some files are already marked, they remain marked.
|-
| UnMark'''   Shift+U'''
| Unmark all selected files. If some files are already unmarked, they remain unmarked.
|-
| Invert Marking '''Ins'''
| Marked files become unmarked, and vice versa.
|-
| Mark only changed (Inc. Case)
| [[ReNamer:Adding files and folders#Marking_and_Unmarking_the_files|Mark]] files that have been changed. Files that had just change of case (and nothing else) will also be marked. ("''Change of case''" means some letters are converted capital-to-small and/or small-to-capital)
|-
| Mark only changed (Exc. Case)
| [[ReNamer:Adding files and folders#Marking_and_Unmarking_the_files|Mark]] files that have been changed, but do not consider changes of case. ("''Change of case''" means some letters are converted capital-to-small and/or small-to-capital)
|-
| Mark only selected
| Mark files that are selected. If some unselected files are already marked, they will be unmarked.
|-
| Mark by Mask
| Pops up a Mask window:
[[Image:MarkByMask.png]]

Specify a mask pattern. All files that match this mask will be marked.

You can enter multiple masks (separating them with semicolon). If a file matches any of these masks, it will be marked.

|}

==== Clear submenu ====
<center>[[Image:ClearSubmenu.png]]</center>
'''Note''': The term "''Clear''" means remove from '''Files''' pane of ReNamer. 

{| class="prettytable"
|-
| Clear All
| Clear all files loaded in the pane.
|-
| Clear Renamed
| Clear all files which have been renamed just before this command. Note that even if some files are not affected by the rules, they are still regarded as renamed successfully.
Only files that failed to rename (those with an '''x''' mark) will remain in the pane.

|-
| Clear Failed
| Only files that failed to rename (those with an '''x''' mark) will be cleared.
All other files (including files whose names were not altered by the rules) will remain in the '''Files''' pane.

|-
| Clear Valid
| Clear files that have valid names after Preview (but haven't been renamed yet).
|-
| Clear Invalid
| Clear files that got invalid (causing conflicts, empty or with forbidden characters etc.) names after Preview (but before renaming).
|-
| Clear Marked
| Clear all marked files.
|-
| Clear Not Marked
| Clear all files that are not marked.
|-
| Clear Not Changed '''Ctrl+D'''
| Clear all files that haven't been changed by the Preview. This also includes all files that have their New Name field empty (eg. because they have been successfully renamed or haven't been previewed since last renaming operation).
|}

==== Select submenu ====
<center>[[Image:SelectSubmenu.png]]</center>
Note: Selection of files is explained [[ReNamer:Adding files and folders#Selecting_files|here]]. 

{| class="prettytable"
|-
| Select All'''  Ctrl+A'''
| All files in the pane will be selected.
|-
| Invert Selection'''  Ctrl+I'''
| Selected files become deselected, and vice versa.
|-
| Select by Name Length  '''Ctrl+L'''
| Pops up a window:
[[Image:SelectByFileNameLengthDialog.png]]

Specify the length of file name. Only files that exceed that length will be selected.

The length refers to the whole filename including dot and the extension.

'''Note''': A typical application is to check if the file can be put on a CD/DVD. The maximum length allowed in ISO 9660-compliant file-system is 64 characters. Longer file names are truncated when you burn a CD/DVD. It is difficult to correlate such files with their originals. To avoid such problems, shorten the names ''before'' burning the CD/DVD.

|-
| Select by Extension  '''Ctrl+E'''
| Pops up a window:
[[Image:SelectByExtnDialog.png]]

Specify the extension (without the dot). All files having that extension will be selected.

You can enter multiple extensions (they must be separated by semicolons - not comma).

|-
| Select by Mask'''  Ctrl+M'''
| Pops up this window:
[[Image:SelectByMask.png]]

Specify the [[ReNamer:Masks|mask]]. All files matching that pattern will be selected. You can enter multiple masks (they must be separated by semicolons - not comma).

|}

==== Move submenu ====
<center>[[Image:MoveSubmenu.png]]</center>
 

{| class="prettytable"
|-
| Up'''      Ctrl+Up'''
| Moves the selected file up. This is used to re-arrange files in the list.
It is easier to use the keyboard shortcut '''CTRL+UpArrow'''.

|-
| Down'''  Ctrl+Down'''
| Moves the selected file down. This is used to re-arrange the files list.
It is easier to use the keyboard shortcut '''CTRL+DownArrow'''.

|}

=== Filters menu ===

When you click on the [[Image:FiltersButton.png]] button, the '''Filters''' window pops up. It controls what gets added to the '''Files''' pane when you use the [[Image:AddFoldersButton.png]] button or [[ReNamer:Adding files and folders#Adding files using the Drag-and-drop method|Drag & Drop]] or [[ReNamer:Adding files and folders#Adding files using the copy-and-paste method |Copy & Paste]] methods. 

{| class="prettytable"
|-
| [[Image:FilterSettingsDialog.png]]
| The options work as follows:
{| class="prettytable"
|-
| <center>'''Option'''</center>
| <center>'''Effect'''</center>
|-
| Add files within folders
| If you want to rename only directories, you would need to UNTICK ''Add files within folders'' option, and tick ''Add folders as files'' option. This will stop files being added from scanned folders.
|-
| Add folders as files
| ReNamer treats folder just like a single filename (not as a container that holds files and subfolders). So only the folder is loaded, and not the files in it. Useful for renaming the folder itself.
|-
| Include subfolders
| Loads contents from all subfolders recursively.
|-
| Include hidden items
| To protect hidden items, deselect this option.
|-
| Include system items
| To protect files reserved for system (OS), deselect this option.
|-
| Skip root folders when added as files
| Works when the ''Add folders as files'' and ''Include subfolders'' options are selected. When it's on, ReNamer adds all the subfolders but not the root folder itself.
|-
| Masks
| All added files (or folders as files) must match specified [[ReNamer:Masks|mask(s)]]. For example, if you enter '''*.jpg;*.gif;*.png''' as masks, ReNamer will add only files with these extensions. Everything else will be filtered ''out''(not added to ReNamer).
|-
| Apply only to the file name
| Changes how the masks (see above) are applied.
For example, suppose you have file '''''C:\Folder\File.ext'''''. If ''this'' option is ON, only the filename part ('''''File.ext''''') will be checked against the mask(s). But if ''this'' option is OFF, the entire path ('''''C:\Folder\File.ext''''') will be checked against the mask(s).

|}

Press '''Save''' to save changes.

|}

'''Filters''' menu is also accessible from the '''Add Folder''' window. For details see [[ReNamer:Adding files and folders#Adding items using the 'Add Folders' button |Adding items using the 'Add Folders' button]] section.

=== Export menu ===
When you click on the [[Image:ExportButton.png]] button, the following list pops up:

<center>[[Image:ExportMenu.png]]</center>

{| class="prettytable"
| Export the paths and undo paths
|

|-
| Export the paths and new names
|

|-
| Import the paths and new names
|

|-
| Import files from text-list or play-list
|

|-
| Export new names to clipboard
|

|-
| Import new names from clipboard
|

|}

=== Options menu ===

When you click on the [[Image:OptionsButton.png]] button, the following list pops up:
<center>[[Image:OptionsMenu.png]]</center>
{| class="prettytable"
|-
| Autosize columns
| Auto-size all columns, to accommodate the longest entry in each column.
|-
| Validate new names
| Check if the new names are valid.
|-
| Fix conflicting new names
| Add incremental numbers as suffixes to avoid conflicts in names. For example, if a new name for a file is Name1, and if such a file already exists in the target folder, then a suffix (2) is added to the newly renamed file. If more than one files have such name conflicts, ReNamer uses incremental numbers (i.e. (2), (3)...) as suffixes to make sure that each file gets a unique name.
|-
| Highlight changed names
| Usually you load files only because you want to change their names. Yet, sometimes, some files escape all the rules you have loaded and remain unchanged. In such cases, you may want to know why that happened.
ReNamer can highlight files that are going to be changed. Now you can investigate the remaining files.

'''Note:''' ''Highlight changed names'' option works as a switch: it turns highlighting ON and OFF.

'''Tip:''' You can unmark the rules selectively and see the effect on the files. That will tell you which rules are working on which files. Once your analysis is over, you can mark all rules.

|-
| Analyze sample text
| Instead of experimenting with files, it is safer to test the effect of your rules on text.
*Enter any text that looks like your target files, and see whether the rules work as desired on that text.
*Edit the rules if the desired result is not achieved
*Once you are satisfied with the rules, apply them on the real files.

Let us see an example.

I had already added a single [[ReNamer:Rules:Insert|Insert Rule]] in the '''Rules''' pane of ReNamer. It was set to insert "''2''" (without the quotes) at the 3rd position.

When the option is selected, a window like this pops up:

[[Image:AnalyzeDialog.png|center]]

In this window, I have added some arbitrary text to show the effect of the rule. Notice how '''x''' is added at the 3rd character in each line. I can move the cursor to any position. In this example, it is at the 3rd position (see the status line at the bottom of the screenshot).

Now I am reassured that the rule ''does'' insert an '''x''' at position-3. (My renaming will happen as planned.) Now I can close this window and go ahead and [[ReNamer:Renaming_files|rename my files]].

The options in the window are as follows:

{| class="prettytable"
|-
| Line wrap
| Wraps a line if it exceeds the window's width. (note that the window's width can be adjusted by dragging its right border.)
|-
| Automatically apply rules
| You do  not have to press the [[Image:ApplyRulesButton.png]] button.
|-
| Apply rules for each line
| Applies the rule to each line separately.
|}

 

|-
| Apply rules to the clipboard
| When you choose this option your rules will be applied to the text in clipboard instead of files in the '''Files''' pane. This might be useful eg. when working with word processors that don't support RegEx'es.
|-
| Count marked and selected files '''Alt + I'''
| It pops up a window with numbers of selected and marked files.
|}

ReNamer:Masks

2009-08-29T07:09:37Z

Krtek: Created page with '{{template:Expand}}'

ReNamer

2009-08-29T07:08:42Z

Krtek: /* Appendices */

[[Image:ReNamer.png|thumb|250px]]

[[ReNamer]] is a very powerful and flexible file renaming tool, which offers all the standard renaming procedures, including prefixes, suffixes, replacements, case changes, as well as removing contents of brackets, adding number sequences, changing file extensions, etc. For advanced users, there is a [[ReNamer:Rules:PascalScript|PascalScript]] rule, which let users program their very own renaming rule. Program allows you to combine multiple renaming actions as a rule set, applying each action in a logical sequence, which can be saved, loaded, and managed within the program. In addition, it has an ability to rename folders, process regular expressions, Unicode capable, and supports variety of meta tags, such as: [http://en.wikipedia.org/wiki/ID3 ID3v1], [http://en.wikipedia.org/wiki/ID3 ID3v2], [http://en.wikipedia.org/wiki/EXIF EXIF], [http://en.wikipedia.org/wiki/Object_Linking_and_Embedding OLE], [http://msdn.microsoft.com/en-us/library/ms779636.aspx AVI], [http://en.wikipedia.org/wiki/MD5 MD5], [http://en.wikipedia.org/wiki/CRC32 CRC32], [http://en.wikipedia.org/wiki/SHA1 SHA1] and many more.

== User Manual ==

*[[ReNamer:Introduction|Introduction]]
*[[ReNamer:Quick guide|Quick guide]]
*[[ReNamer:Step-by-step|Step-by-step]]
**[[ReNamer:Adding files and folders|Adding files and folders]]
**[[ReNamer:Managing rules|Managing rules]]
**[[ReNamer:Previewing files|Previewing files]]
**[[ReNamer:Renaming files|Renaming files]]
*[[ReNamer:Using the Rules|Using the Rules]]
**[[ReNamer:Rules|Overview]]
**[[ReNamer:Rules:Insert|Insert]]
**[[ReNamer:Rules:Delete|Delete]]
**[[ReNamer:Rules:Remove|Remove]]
**[[ReNamer:Rules:Replace|Replace]]
**[[ReNamer:Rules:Rearrange|Rearrange]]
**[[ReNamer:Rules:Extension|Extension]]
**[[ReNamer:Rules:Strip|Strip]]
**[[ReNamer:Rules:Case|Case]]
**[[ReNamer:Rules:Serialize|Serialize]]
**[[ReNamer:Rules:CleanUp|CleanUp]]
**[[ReNamer:Rules:Translit|Translit]]
**[[ReNamer:Rules:RegEx|RegEx]]
**[[ReNamer:Rules:PascalScript|PascalScript]]
**[[ReNamer:Rules:UserInput|UserInput]]
*[[ReNamer:Using presets|Using presets]]
*[[ReNamer:Analyze|Analyze window]]
*[[ReNamer:Manual editing|Manual editing]]

== Appendices ==

*[[ReNamer:Program settings|Program settings]]
*[[ReNamer:Main Menu and keyboard shortcuts|Main Menu and keyboard shortcuts]]
*[[ReNamer:Menus for the Files pane|Menus for the Files pane]]
*[[ReNamer:Context menus|Context menus]]
*[[ReNamer:Date and Time format|Date and Time format]]
*[[ReNamer:Meta Tags|Meta Tags]]
*[[ReNamer:Regular Expressions|Regular Expressions]]
*[[ReNamer:Pascal Script|Pascal Script]]
**[[ReNamer:Pascal Script:Quick guide|Quick guide]]
**[[ReNamer:Pascal Script:Types|Types]]
**[[ReNamer:Pascal Script:Functions|Functions]]
**[[ReNamer:Pascal_Script#Script cookbook|Script cookbook]]
**[[ReNamer:Scripts|Scripts]]
*[[ReNamer:Command Line use|Command Line use]]
*[[ReNamer:Ordering files|Ordering files]]
*[[ReNamer:Sorting files|Sorting files]]
*[[ReNamer:Masks|Using masks]]

[[Category:ReNamer]]

ReNamer:Menus for the Files pane

2009-08-28T21:27:49Z

Krtek:

ReNamer has a menu bar between the '''Rules''' and '''Files''' panes [[Image:MenuStrip.png]].

This appendix describes options available from this menu.

=== Files button ===

When you click on the [[Image:FilesButton.png]] button, the following list pops up:
<center>[[Image:FileMenu.png]]</center>
{| class="prettytable" style="width: 619px; height: 218px;"
|-
| Analyze Name
| Opens [[ReNamer:Analyze|analysis window]], and loads the names of the selected files into it.
|-
| Edit New Name '''F2'''
| Starts manual editing of the selected filename.
|-
| [[ReNamer:Menus for the Files pane#Shell submenu|Shell]]
| Options for Windows shell operations.
|-
| [[ReNamer:Menus for the Files pane#Mark submenu|Mark]]
| Options for [[ReNamer:Adding_files_and_folders#Marking_and_Unmarking_the_files|marking]] specific items.
|-
| [[ReNamer:Menus for the Files pane#Clear submenu|Clear]]
| Options for [[ReNamer:Adding_files_and_folders#Marking_and_Unmarking_the_files|removing]] specific items from the '''Files''' pane.
|-
| [[ReNamer:Menus for the Files pane#Select submenu|Select]]
| Options for [[ReNamer:Adding_files_and_folders#Selecting_files|selecting]] specific items.
|-
| [[ReNamer:Menus for the Files pane#Move submenu|Move]]
| Options for moving specific items.
|-
| Remove selected items '''Del'''
| Remove selected items from the ReNamer's '''File''' pane. (This command does not delete the items from the disk.)
|}

This menu provides second-level options, as follows:

==== Shell submenu ====
<center>[[Image:ShellSubMenu.png]]</center>
 

{| class="prettytable"
|-
| Open File'''                Enter'''
| Open the selected file using its default associated application.
|-
| Open with Notepad'''  Shift+Enter'''
| Open the file with notepad. Useful when you want to see the raw data in the file. (When viewed this way, the file will not be displayed in its original formatting. It may not be easily readable.)
|-
| Open operating folder '''Ctrl+Enter'''
| Launch Windows Explorer and open the folder where the selected file is located. Highlight (select) the file in it.
|-
| File properties '''Alt+Enter'''
| Display the properties of the selected file. Typically, file size, dates (created/modified/accessed), comments, author, attributes (hidden, system, etc.)
|-
| Cut Files to clipboard '''Shift+Ctrl+X'''
| Cuts the selected file(s) to clipboard. All files will be moved to one folder, no matter where they were initially located. (Note: If you do not paste the file(s) in a target application, the '''Cut''' operation is automatically canceled.)
|-
| Copy Files to clipboard '''Shift+Ctrl+C'''
| Copies selected file(s) to clipboard. All files will be copied to one folder, no matter where they were initially located.
|-
| Delete files to Recycle Bin
| Deletes the selected file(s) to Recycle Bin. (They can be recovered from the Recycle Bin.)
Note that if the file is too large for the Recycle Bin, Windows will warn you that it will not be put in Recycle Bin, but deleted permanently. If you confirm, the file is deleted permanently.

|}

==== Mark submenu ====
<center>[[Image:MarkSubmenu.png]]</center>
'''Note'''''': '''Marking of files is explained [[ReNamer:Adding files and folders#Marking_and_Unmarking_the_files|here]]. 

{| class="prettytable"
|-
| Mark'''       Shift+M'''
| Mark all selected files. If some files are already marked, they remain marked.
|-
| UnMark'''   Shift+U'''
| Unmark all selected files. If some files are already unmarked, they remain unmarked.
|-
| Invert Marking '''Ins'''
| Marked files become unmarked, and vice versa.
|-
| Mark only changed (Inc. Case)
| [[ReNamer:Adding files and folders#Marking_and_Unmarking_the_files|Mark]] files that have been changed. Files that had just change of case (and nothing else) will also be marked. ("''Change of case''" means some letters are converted capital-to-small and/or small-to-capital)
|-
| Mark only changed (Exc. Case)
| [[ReNamer:Adding files and folders#Marking_and_Unmarking_the_files|Mark]] files that have been changed, but do not consider changes of case. ("''Change of case''" means some letters are converted capital-to-small and/or small-to-capital)
|-
| Mark only selected
| Mark files that are selected. If some unselected files are already marked, they will be unmarked.
|-
| Mark by Mask
| Pops up a Mask window:
[[Image:MarkByMask.png]]

Specify a mask pattern. All files that match this mask will be marked.

You can enter multiple masks (separating them with semicolon). If a file matches any of these masks, it will be marked.

|}

==== Clear submenu ====
<center>[[Image:ClearSubmenu.png]]</center>
'''Note''': The term "''Clear''" means remove from '''Files''' pane of ReNamer. 

{| class="prettytable"
|-
| Clear All
| Clear all files loaded in the pane.
|-
| Clear Renamed
| Clear all files which have been renamed just before this command. Note that even if some files are not affected by the rules, they are still regarded as renamed successfully.
Only files that failed to rename (those with an '''x''' mark) will remain in the pane.

|-
| Clear Failed
| Only files that failed to rename (those with an '''x''' mark) will be cleared.
All other files (including files whose names were not altered by the rules) will remain in the '''Files''' pane.

|-
| Clear Valid
| Clear files that have valid names after Preview (but haven't been renamed yet).
|-
| Clear Invalid
| Clear files that got invalid (causing conflicts, empty or with forbidden characters etc.) names after Preview (but before renaming).
|-
| Clear Marked
| Clear all marked files.
|-
| Clear Not Marked
| Clear all files that are not marked.
|-
| Clear Not Changed '''Ctrl+D'''
| Clear all files that haven't been changed by the Preview. This also includes all files that have their New Name field empty (eg. because they haven't been previewed since last renaming operation).
|}

==== Select submenu ====
<center>[[Image:SelectSubmenu.png]]</center>
Note: Selection of files is explained [[ReNamer:Adding files and folders#Selecting_files|here]]. 

{| class="prettytable"
|-
| Select All'''  Ctrl+A'''
| All files in the pane will be selected.
|-
| Invert Selection'''  Ctrl+I'''
| Selected files are unselected, and vice versa.
|-
| Select by Name Length  '''Ctrl+L'''
| Pops up a window:
[[Image:SelectByFileNameLengthDialog.png]]

Specify the length of file name. Only files that exceed that length will be selected.

The length refers to ''base name'' only; not the dot or the extension.

'''Note''': A typical application is to check if the file can be put on a CD/DVD. The maximum length allowed in ISO 9660-compliant file-system is 64 characters. Longer file names are truncated when you cut a CD/DVD. It is difficult to Correlate such files with their originals. To avoid such problems, shorten the names ''before'' cutting the CD/DVD.

|-
| Select by Extension  '''Ctrl+E'''
| Pops up a window:
[[Image:SelectByExtnDialog.png]]

Specify the extension (without the dot). All files having that extension will be selected.

You can enter multiple extensions (They must be separated by semicolons- not comma).

|-
| Select by Mask'''  Ctrl+M'''
| Pops up this window:
[[Image:SelectByMask.png]]

Specify the mask. All files matching that pattern will be selected. You can enter multiple masks (They must be separated by semicolons- not comma).

|}

==== Move submenu ====
<center>[[Image:MoveSubmenu.png]]</center>
 

{| class="prettytable"
|-
| Up'''      Ctrl+Up'''
| Moves the selected file up. This is used to re-arrange the files list.
(It is better to use the keyboard shortcut '''CTRL+UpArrow''').

|-
| Down'''  Ctrl+Down'''
| Moves the selected file down. This is used to re-arrange the files list.
(It is better to use the keyboard shortcut '''CTRL+DownArrow''').

|}

=== Filters menu ===

When you click on the [[Image:FiltersButton.png]] button, the '''Filters''' window pops up. It controls what gets added to the '''Files''' pane when you use the [[Image:AddFoldersButton.png]] button. 

{| class="prettytable"
|-
| [[Image:FilterSettingsDialog.png]]
| The options work as follows:
{| class="prettytable"
|-
| <center>'''Option'''</center>
| <center>'''Effect'''</center>
|-
| Add files within folders
| If you want to rename only directories, you would normally UNTICK Add files within folders option, and tick Add folders as files option. This will stop files being added from scanned folders.
|-
| Add folders as files
| ReNamer treats folder just like a file (not as a container that holds files and subfolders). So only the folder and its subfolders are loaded as files; but not the files in it. Useful for renaming the folder itself.
|-
| Include subfolders
| Loads contents from all subfolders recursively.
|-
| Include hidden items
| To protect hidden items, deselect this option.
|-
| Include system items
| To protect files reserved for system (OS), deselect this option.
|-
| Skip root folders when added as files
| Works when the Add folders as files option is selected. ReNamer adds all the subfolders by default (as files). But if ''this'' option is OFF, the folder itself will also be added to the list (as a file).
|-
| Masks
| All added files (or folders as files) must match specified mask(s). For example, if you enter '''*.jpg;*.gif;*.png'''as masks, ReNamer will add only files with these extensions. Everything else will be filtered ''out ''(not added to ReNamer).
|-
| Apply only to file name
| Changes how the masks (see above) are applied.
For example, suppose you have file '''''C:\Folder\File.ext'''''. If ''this'' option is ON, only the filename part ('''''File.ext''''') will checked against the mask(s). But if ''this'' option is OFF, the entire path ('''''C:\Folder\File.ext''''') will be checked against the mask(s).

|}

Press '''Save''' to save changes and return to the '''Add Folders''' window.

|}

In fact, this menu is also accessible during the '''Add Folder''' process. Hence it is described fully in [[ReNamer:Adding files and folders|Adding items using the 'Add Folders' button]] section.

=== Export menu ===
When you click on the [[Image:ExportButton.png]] button, the following list pops up:

<center>[[Image:ExportMenu.png]]</center>

{| class="prettytable"
| Export the paths and undo paths
|

|-
| Export the paths and new names
|

|-
| Import the paths and new names
|

|-
| Import files from text-list or play-list
|

|-
| Export new names to clipboard
|

|-
| Import new names from clipboard
|

|}

=== Options menu ===

When you click on the [[Image:OptionsButton.png]] button, the following list pops up:
<center>[[Image:OptionsMenu.png]]</center>
{| class="prettytable"
|-
| Autosize columns
| Auto-size all columns, to accommodate the longest file names in each column.
|-
| Validate new names
| Check if the new names are valid
|-
| Fix conflicting new names
| Add incremental numbers as suffixes to avoid conflicts in names. For example, if a new name for a file is Name1, and if it already exists in the target folder, then a suffix (1) is added to the newly renamed file. If more than one files have such name conflicts, ReNamer uses a incremental numbers (i.e., (1), (2), (3)...) as suffix; to make sure that each file gets a different suffix.
|-
| Highlight changed names
| Usually you load files only because you want to change their names. Yet, sometimes, some files escape all the rules you have loaded and remain unchanged. In such cases, you may want to know why that happened.
ReNamer can highlight the files that are going to change. Now you can investigate the remaining files.

'''Tip:''' You can unmark the rules selectively and see the effect on the files. That will tell you which rules are working on which files. Once your analysis is over, you can mark all rules.

|-
| Analyze sample text
| Instead of experimenting with files, it is safer to test the effect of your rules on text.
*Enter any text that looks like your target files, and see whether the rules work as desired on that text.
*Edit the rules if the desired result is not achieved
*Once you are satisfied with the rules, apply them on the real files.

Let us see an example.

I had already added a single [[ReNamer:Rules:Insert|Insert Rule]] in the '''Rules''' pane of ReNamer. It was set to insert "''2''" (without the quotes) at the 3rd position.

When the option is selected, a window like this pops up:

[[Image:AnalyzeDialog.png|center]]

In this window, I have added some arbitrary text to show the effect of the rule. Notice how '''x''' is added at the 3rd character in each line. I can move the cursor to any position. In this example, it is at the 3rd position (see the status line at the bottom of the screenshot).

Now I am reassured that the rule ''does'' insert an '''x''' at position-3. (My renaming will happen as planned.) Now I can close this window and go ahead and [[ReNamer:Renaming_files|rename my files]].

The options in the window are as follows:

{| class="prettytable"
|-
| Line wrap
| Wraps a line if it exceeds the window's width. (note that the window's width can be adjusted by dragging its right border.)
|-
| Automatically apply rules
| You do  not have to press the [[Image:ApplyRulesButton.png]] button.
|-
| Apply rules for each line
| Applies the rule to each line separately.
|}

 

|-
| Apply rules to the clipboard
|
|-
| Count marked and selected files '''Alt + I'''
| Total count of items (selected + marked)
|}

ReNamer:Main menu

2009-08-27T21:41:49Z

Krtek:

In this appendix, all the menus and context menu options are described.

=== File menu ===
{| class="prettytable"
|-
! Menu option
! Keyboard Shortcut
! What it does...
|-
| New Project
| CTRL+N
| Create a new project. Clear all rules and files.
|-
| Undo
| SHFT+CTRL+Z
| If possible, reverses the effect of the last renaming operation.
|-
| Paste
| SHFT+CTRL+V
|
Pastes the selection of files from the clipboard into the '''Files''' pane. (We assume that you have already copied some files into the clipboard)

|-
| Add files
| F3
| Starts a window to select specific file(s) from any folder and add them to the '''Files''' pane.
|-
| Add folders
| F4
| Starts a window to add all files from a chosen folder (behavior depends on [[ReNamer:Menus for the Files pane#Filters_menu|Filter settings]])
|-
| Preview
| F4
| Manual preview (not required if ''auto-preview'' mode is on)
|-
| Rename
| F5
| Renames the file with a name shown in the '''New Name''' ('''New Path''') column in the '''Files''' pane.
|-
| Exit
| ALT+F4
| Closes the application
|}

=== Settings menu ===

{| class="prettytable" style="width: 714px; height: 518px;"
|-
! Menu option
! Keyboard Shortcut
! What it does...
|-
| All Settings
| F8
| See [[ReNamer:Program settings|'''Program settings''']] for details.
|-
| General
| 
| Shows the [[ReNamer:Program settings#General_settings|'''General''']] tab of the '''Settings''' dialog.
|-
| Preview
| 
| Shows the [[ReNamer:Program settings#Preview_settings|'''Preview''']] tab of the '''Settings''' dialog.
|-
| Rename
| 
| Shows the [[ReNamer:Program settings#Rename_settings|'''Rename''']] tab of the '''Settings''' dialog.
|-
| Meta tags
| 
| Shows the [[ReNamer:Program settings#Meta tags settings|'''Meta Tags''']] tab of the '''Settings''' dialog.

|-
| Miscellaneous
| 
| Shows the [[ReNamer:Program settings#Miscellaneous_settings|'''Miscellaneous''']] tab of the '''Settings''' dialog.
|-
| Filters
| ALT+F
| Changes the default behavior when [[ReNamer:Adding files and folders#Adding_items_using_the_.27Add_Folders.27_button|adding folders]].
|}

=== Presets menu ===

'''Note:''' Presets are explained [[ReNamer:Using_presets|here]]

{| class="prettytable"
|-
! Menu option
! Keyboard Shortcut
! What it does...
|-
| Load
| 
|
Opens a submenu with a list of all available presets. Click on a preset to load its rules in the '''Rules''' pane. If the preset was saved with any filter settings, they will also be set.

'''Note:''' Be aware that all current rules will be lost. If you want to add a preset in the end of the current rules stack use [[ReNamer:Using_presets|'''Append preset''']] option from '''Preset Manager'''.

|-
| Save As...
| CTRL+S
| Saves the current preset.
|-
| Manage
| CTRL+M
|
Opens the [[ReNamer:Using_presets|'''Preset Manager''']] dialog.

|-
| Browse...
| 
| Browse to folder where presets are stored (via Windows Explorer).
|-
| Import...
| 
| Select presets from any folder in your file system, which you want to be copied to ReNamer's '''Presets''' folder.
|-
| Create links
| 
| The following window pops up:
[[Image:PresetLinksDialog.png|center]]

Shortcuts will be created for every available ''preset'' and placed in the selected folder. 

*If the '''Load with Preset''' option is selected, links will only open new ReNamer window with the preset loaded into '''Rules''' pane and files that where sent to the link loaded into '''Files''' pane. Now you can edit rules, delete or add some more rules, and finally rename the files. If the preset contained any filter settings, they will be applied to the files that where sent to the link.
*If the '''Rename with Preset''' option is selected, the linked preset will be loaded and all files which were sent to the link will be automatically renamed. 

For more information, please see [[ReNamer:Command Line use|Command Line usage]]. 
WARNING: Be careful with the '''"Rename with Preset'''" option. It will rename files without asking for your confirmation!


|-
| Rescan
| 
| Scans the preset folder for new presets. Useful if you have manually modified the content of the presets folder as you don't have to restart ReNamer to use them.
|}

=== Help menu ===

{| class="prettytable"
|-
! Menu option
! Keyboard Shortcut
! What it does...
|-
| User Manual
| ALT+F1
| Opens User Manual file which is distributed with the application (PDF file).
|-
| Donate
| 
|
Takes you to the donation web page.
 
Although ReNamer is freeware, you could support the project with a small donation.

|-
| What's new
| 
|
Pops up a window like this:

[[Image:AboutWindow.png]]

You can check the latest changes here. 

|-
| About
| F1
| Pops up a window like this:
[[Image:WhatsNewWindow.png]] 

This screen provides you with general information about ReNamer, and contact details in case you are facing any difficulties that are not covered in this manual. 

|}

ReNamer:Program settings

2009-08-27T08:29:08Z

Krtek:

This appendix describes the settings that change ReNamer's behavior in various ways.

=== General settings ===
These settings are applicable to the ReNamer application.
<center>[[Image:GeneralSettingsDialog.png]]</center>
{| class="prettytable"
| Always on top (main window only)
| colspan="2" | Keeps the ReNamer window above the other windows.

This feature is useful when you are using the drag-and-drop method to add files from Windows Explorer. When you are working in Windows Explorer, the ReNamer window does not vanish below the Windows Explorer window.

|-
| Remember last position and size
| colspan="2" | ReNamer will retain the same size and position in the next session. You will not need to resize/re-position the ReNamer window each time you start it.

|-
| Remember sorting options (files table)
| colspan="2" | ReNamer will retain the file sorting order in the next session.

|-
| Save rules configuration on exit, load on start up
| colspan="2" | In the next session, ReNamer retains all rules that are currently loaded in the '''Rules''' pane. Useful if you use the same rules every time.

|-
| Always show non-main forms centered
| colspan="2" | All windows and dialog boxes (except the main window) appear in the center of the ReNamer window. You still may shift the new window, but when you close it and open again it will be opened in the center of ReNamer window. If the option is deselected window would reopen in its old position.

|-
| Use natural order sorting algorithm
| colspan="2" | ReNamer has two different types of sorting algorithms:
{| class="prettytable"
| <center>'''Order'''</center>
| <center>'''Example'''</center>
| <center>'''Remarks'''</center>

|-
| Natural
| <center>Name1.ext</center>

<center>Name2.ext</center>

<center>Name10.ext</center>

<center>Name20.ext</center>
| Numbers are sorted in their natural order.

|-
| Lexicographical
| <center>Name1.ext</center>

<center>Name10.ext</center>

<center>Name2.ext</center>

<center>Name20.ext</center>
| Sorts like in a dictionary. All entries are sorted based on characters' positions, counted from left.
|}
If this option is selected, filenames are sorted in '''Natural''' order; otherwise they are sorted in '''Lexicographical''' order.
|}

=== Preview settings ===
These settings are applicable only to the previewing.
<center>[[Image:PreviewSettingsDialog.png]]</center>

{| class="prettytable"
| Autosize table on change
| Each column resizes automatically to accommodate the longest name in it.

|-
| Auto preview on change of rules configurations
| Whenever a rule is added/deleted/edited, the preview refreshes automatically

|-
| Auto preview when new files are added
| Whenever a file is added, the preview refreshes automatically

|-
| Validate new filenames on preview
| Raises a warning if new filenames are not valid:
* There are duplicates in the ''New path'' column
* ''New path'' contains forbidden characters
* ''New path'' is already taken by an existing file
* ''New path'' exceeds maximum length (256 characters)
|-
| Real-time update of the preview
| If this option is selected, when you click the '''Preview '''button, files will be updated one-by-one and displayed in the table. During the processing, ReNamer continues to accept any user inputs (mouse/keyboard).


WARNING: This option allows you to use mouse/keyboard even when the previous rules are being processed. This may lead to unpredictable behavior and consequences! Use this option with EXTREME CAUTION, only for cases when some heavy processing is done on each file, for example: using HASH functions or other types of content analysis.

If this option is deselected, when you click '''Preview''' button, ReNamer shows nothing till all files are processed; after which all files are displayed at once. During the processing, ReNamer will stop accepting any user inputs (mouse/keyboard). This mode is safe. '''For normal use, deselect this option!'''
|}

=== Rename settings ===
These settings are applicable to the renaming process.
<center>[[Image:RenameSettingsDialog.png]]</center>

ReNamer can boost your productivity by doing certain operations on its own. On the other hand, you may want to have the flexibility of choosing your options each time. So this panel lets you decide how to strike a balance!
{| class="prettytable"

|-
| Display message on successful rename
| colspan="2" | Deselect if you do not want a message each time.

(This setting is not applicable to the pop-up windows that show the error messages. Those windows are ''always'' shown.)

|-
| Close program after successful rename
| colspan="2" | Useful if you use ReNamer sparingly (rename once and close ReNamer.)

In case of problem, ReNamer stays open.

|-
| Clear rules list after rename
| colspan="2" | Useful if you use a different set of rules each time. This option will clear off the '''Rules''' pane automatically.

|-
| Clear files table on rename
| colspan="2" | Useful if you want to load another set of files for each new renaming.

Note that even files that were not renamed in the last round will get cleared off. So, '''deselect''' this option if you tend to rename your loaded files in 2-3 separate renaming operations.

'''NOTE:''' This will make '''Undo''' option unusable.

|-
| Clear renamed files on rename
| colspan="2" | Clears off the files once you have finished renaming them.

Note that the files that were not renamed will remain behind, so that you can apply a new set of rules to them.

Note that the currently ''marked'' set of rules may not change some file names (for example, if you want to insert a string at 10th position, and we have some files with shorter file names.) Even in such cases, the files are considered to be renamed.

'''NOTE:''' This will make '''Undo''' option unusable.

|-
| Overwrite files with new names
| colspan="2" | If there is a naming conflict as a result of renaming, the newly renamed files can overwrite the existing files with the same names automatically.

Note that the name conflict can occur with a file that exists in the same folder, but which is NOT loaded in ReNamer.

Note also that multiple files from the same folder may be renamed in such a way that most of them get overwritten in sequence. In the worst case, only the last file to be renamed will survive!


'''CAUTION:''' '''Your important files can be overwritten without your knowledge'''!

|-
| Must be successfully confirmed by user
| colspan="2" | (Applicable only when '''Overwrite files with new names''' option is selected):

{| class="prettytable"
| Selected
| ReNamer will pop up confirmation dialog for every file that is to be overwritten. The old file will be overwritten only if you confirm. (If the renamed file has no conflicts in its folder, ReNamer will rename it without asking for permission.).

|-
| Deselected
| If a renamed file has the same name as an existing file, ReNamer will overwrite the old file silently.

'''CAUTION:''' '''Your important files can be overwritten without your knowledge'''!
|}
|}

=== Meta tags settings ===

These settings are for meta-tags only.
<center>[[Image:MetaTagsSettingsDialog.png]]</center>
{| class="prettytable"
|-
| Meta tag support
| colspan="2" | Extracting meta-tags from files puts heavy demand on system resources. So if you do not need meta-tags, deselect this option. The system will become more responsive (not only ReNamer, but other applications as well.).
|-
| Date format
| colspan="2" | Sets the date format for ReNamer's use. (The selected date format will be used for naming files.) See [[ReNamer:Date_and_Time_format|Date-time format used in Meta tags]] to see available formats.
|-
| Preview
| colspan="2" | Tests the current date-time format, using current time.
|}

=== Miscellaneous settings ===
A general-purpose tab to provide all miscellaneous settings.
<center>[[Image:MiscSettingsDialog.png]]</center>

{| class="prettytable"
| Register preset extension (*.rnp)
| colspan="2" | Associate the .rnp extension with ReNamer.

|-
| Add to folders context menu
| colspan="2" | in Windows Explorer, a ReNamer option is added to the context menu for folders.

|-
| Add to Send to context menu
| colspan="2" | in Windows Explorer, a ReNamer option is added to the Send to... context menu.

|-
| Change text of "Drag your files here"
| colspan="2" | The lower pane of ReNamer will show your custom text when empty

|-
| Change text of "Click here to add a rule"
| colspan="2" | The upper pane of ReNamer will show your custom text when empty

|}

ReNamer:Rules:UserInput

2009-08-26T19:26:19Z

Krtek:

== UserInput Rule ==
<center>[[Image:UserInputRule.png]]</center>
This rule replaces the original filenames with the names taken from the list. (The ''n''th line in the list serves as the new name for the ''n''th file in the '''Files''' pane.)

Naturally, the list should contain names for all the files loaded in the '''Files''' pane.

*If the list is shorter, then some of the files will not be renamed.
*If the list is longer, some of the names will remain unused (but all files in the '''Files''' pane will be renamed).

There are three ways to create the list:

#Click in the pane, and manually type the list (one name per line).
#Copy the list from any application to your clipboard. Switch to ReNamer. Click in the '''UserInput''' pane and press '''CTRL+V''', right-click and select '''Paste''' or choose the '''Load from clipboard''' from [[Image:UserInputOptionsButton.png]] menu).
#Load a list from the text file (available from [[Image:UserInputOptionsButton.png]] menu).

The optional parameters are as follows:

{| class="prettytable"
|-
| Insert in front of the current name
| Inserts the name before the file name.
|-
| Insert after the current name
| Inserts the name ''after'' the current name. The actual position depends on the '''Skip extention''' option.
|-
| Replace the current name
| Replaces the existing filename with the new name.
The effect on extension depends on the '''''Skip extension''''' option:
|-
| Skip extention
|
*If the option is selected, the extention is ignored and user input strings will affect only the base name of files.
*If the option is deselected, user input strings will replace entire filename, ''including'' the extension, or will be added ''after'' the old extention (if the '''Insert after the current name''' option is selected).
|}

ReNamer:Rules:PascalScript

2009-08-26T19:09:17Z

Krtek:

== PascalScript Rule ==
<center>[[Image:PascalScriptRule.png]]</center>
This rule uses [[ReNamer:Pascal Script|Pascal/Delphi programming]] syntax and conventions. ReNamer comes with some preloaded scripts. We will see how to use them, and how to add a new script.

=== Using a ready script ===

#Click on the [[Image:ScriptsButton.png]] button (located just below the '''Configuration '''pane).
#:A list of scripts appears.
#:[[Image:PascalScriptsMenu.png]]
#All available scripts are listed ''above'' the line. Click on any script to load it into the '''Configuration '''pane.
#Edit the script if required
#Press [[Image:AddRuleButton.png]] button to add the script to the rule stack.
#Repeat steps 1-4 to add more script-based rules.

=== Borrowing scripts from forum ===

Even if you do not know how to write a script, you can easily use scripts written by others.

First, visit the [http://www.den4b.com/forum/ '''User Forum'''] and search for a suitable script. The Forum already has a large number of such scripts. Some of these scripts have embedded comments about how to customize the script. 
'''TIP:''' If you are looking for scripts only, try to use '''begin''' or '''end''' words in your search phrase as these are the words that are present in every single script.

If you cannot find a suitable script, you can ask other users to write the script for you.

Once you find such a script, follow these simple steps:

{| class="prettytable"
|-
! <center>Step</center>
! <center>Details</center>
|-
| <center>1</center>
| '''Copy the script'''
Copy the script from the forum (ensure that nothing is left out)

|-
| <center>2</center>
| '''Clear the ReNamer's Configuration pane'''
Open the Pascal Script Rule in ReNamer. Select the three lines you see in the '''Configuration''' pane, and press DEL or paste the script while these lines are selected. (Those lines are meant to begin a script from scratch).

|-
| <center>3</center>
| '''Paste the script into ReNamer pane'''
Use the '''CTRL+V''' shortcut or right-click and select '''Paste.'''

|-
| <center>4</center>
| '''Compile the script'''
Press the [[Image:TryToCompileButton.png]] button.

*In case some error comes up, you can try and troubleshoot the problematic statement in the script using the [[Image:GotoButton.png]] button.
*:It pops up a window like this:
*:<center>[[Image:GotoLineDialog.png]]</center>
*:Now enter the line number in the window and press '''OK'''. It takes you to the faulty statement.
*If the script compiles successfully, this button is not required at all.

|-
| <center>5</center>
| '''Saving the script and giving it a name:'''
The '''save '''button is hidden under the '''scripts '''menu. So first click on the [[Image:ScriptsButton.png]] button. It pops up a window like this:
<center>[[Image:PascalScriptsMenu.png]]</center>
Note that all the existing scripts are listed here. (Your new script will also be added to this list.)

Select the '''Save script... '''option (at the very bottom of the menu). Another window pops up.
<center>[[Image:SaveScriptDialog.png]]</center>
Enter a name that suggests the function of your script. Press '''OK'''. The new name is added to the list of scripts. Now use it as described [[ReNamer:Rules:PascalScript#Using_a_script|above]].

|}

=== Writing your own scripts ===

To write your own scripts, you must have knowledge of Pascal script.

Learning Pascal script is easy. Refer to the [[ReNamer:Pascal Script|'''Pascal Script section''']]. Here, we will assume that you already know how to write pascal scripts.

The step-by-step procedure is as follows:

#Click in the Configuration pane and enter the script directly. (You can also copy it from anywhere and paste it into the pane by pressing '''CTRL+V'''. Or right-click in the pane and select the '''Paste''' option from the context menu.)
#Compile the script by pressing the [[Image:TryToCompileButton.png]] button located below the Configuration pane.
#*If an error message comes up, troubleshoot the script. The fault message usually includes the line number of the problematic statement in the script. Press the [[Image:GotoButton.png]] button and enter that line number to locate the faulty statement quickly. Then correct the errors and press the [[Image:TryToCompileButton.png]] button again. Repeat this till a '''''Compiled successfully!''''' message pops up.
#Now you can add the script as a rule by pressing [[Image:AddRuleButton.png]] button or save it for later use.
#To save the script press the [[Image:ScriptsButton.png]] button. A list pops up:
#:<center>[[Image:PascalScriptsMenu.png]]</center>
#Click on the '''Save Script...'''(the last option in the list). Now this script is added to the list (it appears above the line in the list).
#:Now you can use that script as described [[ReNamer:Rules:PascalScript#Using_a_script|above]]

ReNamer:Rules:RegEx

2009-08-26T18:52:06Z

Krtek:

== RegEx Rule ==
<center>[[Image:RegExRule.png]]</center>
This rule finds text that matches the specified RegEx pattern, and replaces it with another string. RegEx is short for '''Regular Expressions''', which stands for special syntax for describing search and replace patterns. Regular Expressions are very powerful and they are really worth to learn. The [[ReNamer:Regular Expressions|RegEx syntax]] is explained in the appendix.

(The [http://www.regexpstudio.com/ TRegExpr] RegEx engine used by ReNamer is a little different from the standard [http://perldoc.perl.org/perlre.html PERL RegEx] or [http://msdn.microsoft.com/en-us/library/6wzad2b2(VS.85).aspx Windows RegEx]. You may check the correct syntax in [[ReNamer:Regular Expressions|here]]) 

 The parameters are as follows:

{| class="prettytable"
|-
! Parameter
! Details
|-
| Expression
| RegEx pattern to match or find.
|-
| Replace
| RegEx pattern that replaces the found pattern.
|-
| Skip extension
| If this check box is selected, the extension will be ignored by the rule.
|-
| Case-sensitive
| If this option is selected, ReNamer will search for the text in ''case-sensitive'' manner.
|}

'''Tip:''' ReNamer users have posted many RegEx patterns at the [http://www.den4b.com/forum/index.php User Forum]. You can copy and use them.

ReNamer:Rules:Translit

2009-08-26T18:41:00Z

Krtek:

[[Image:TranslitRule1.png|center]]

This rule transliterates one alphabet into another. Its main goal is to transliterate Non-English characters from different languages into their English/Latin representation. For example, the German character '''ü''' can be transliterated to '''ue''' (the name '''Müller '''can be also written as '''Mueller''').

This rule uses ''transliteration maps'' (explained below).

== Transliteration maps ==

To transliterate, we create a pair of equivalent characters, like this: '''ü=ue'''

(Note that the right side of this equation has ''two'' characters. Any number of characters may be placed on both sides of the equation.)

We need several such ''equivalent character pairs'' to convert one language into another. The entire set is called a ''transliteration map''. (This is really some kind of a find-and-replace rule.)

ReNamer has several such built-in maps. Each map is named after a language (the second language in all maps is English).

Each map can be used in ''both'' directions (e.g. French-to-English or English-to-French.)

When you start up the '''Translit''' Rule, its window does not show any maps. You are free to do any of the following:

#Use any of the built-in maps (and use it in ''forward'' or ''reverse'' direction)
#Create your own map and use it.
#Edit a built-in map first, and then use it.

Let us see how to do this.

== Automatic case conversion ==

Translit rule does automatic case conversion with an algorithm adopted specifically for transliteration. Translit rule discard the case on the input, i.e. "A=B" is same as "a=b". Case is decided upon case of the input fragment. Multiple character fragments are treated as part of words, with their case decided based on the case of letters around them.

The logic for the case conversion is as follows (ReNamer Beta from 23 Aug 2009):
<pre>
set OUTPUT-PART to lower case
if first letter in INPUT-PART is upper case then
if length of OUTPUT-PART bigger than 1 then
if next letter in original name is upper case then
convert whole OUTPUT-PART to upper case
else
convert only first letter in OUTPUT-PART to upper case
else
convert whole OUTPUT-PART to upper case
</pre>

== Using a built-in transliteration map ==

To select any of the built-in maps, press the [[Image:TranslitMapsButton.png]] button. A list of available transliteration maps pops up:
<center>[[Image:TranslitMenu.png]]</center>
Click on the desired transliteration map. As an example, let us click on the French (to English) transliteration map.

The '''Rules''' window changes immediately to show the French characters and their English equivalents.
<center>[[Image:TranslitRule2.png]]</center>
You can edit any of the entry in this list, add new entries, or delete any of the entries.

Note that such editing does not alter the saved version of the map. (The map is edited just for a one-time use. So, if you select the same Translit map again, ReNamer will load the ''original'' version, not the ''edited'' version.) We will see how to edit and save a map [[ReNamer:Rules:Translit#Saving_a_transliteration_map|later]].

Next, select the rule's parameters as shown below:

{| class="prettytable"
|-
! Parameter
! Details
|-
| forward
| This is transliteration from-left-to-right direction, as defined in the map.
|-
| backward
| This is transliteration from-right-to-left direction, as defined in the map.
|-
| skip extension
| If this check box is selected, the extension will be ignored by the rule.
|}

Finally, press the [[Image:AddRuleButton.png]] button to add the rule to the stack.

== Making your own transliteration map ==

Click in the '''Translit Alphabet '''window, and start entering the equivalent characters (one transliteration per line).

For example,

'''ü=ue'''

'''ö=oe'''

'''ß=ss'''

After entering all such transliterations, press the [[Image:AddRuleButton.png]] button to add the rule to the rule-stack.

Note that this rule is not saved yet (it was just composed for a one-time use). The following topic shows how to save a map.

== Saving a transliteration map ==

To save a newly composed Transliteration rule,

#Press the [[Image:TranslitMapsButton.png]] button.
#:A menu pops up.
#:<center>[[Image:TranslitMenu.png]]</center>
#Select the last option ('''Save Translit...''').
#:A window pops up, as shown below:
#:<center>[[Image:SaveTranslitMapDialog.png]]</center>
#Enter a new name for the map and press '''OK'''. The new map is saved.

The process of saving an edited Transliteration map is similar. The only difference is that the '''Save Translit '''window (see above) shows the current map's name. You can press '''OK''' to save the changes you've just made, or enter a new name to create a new translit map for the edited version of the current map.

The new map's name is added to the map list.

From now on, the new map will also be available as "standard".

ReNamer:Rules:Replace

2009-08-26T18:09:50Z

Krtek:

{{Template:Cleanup}}

== Replace Rule ==
<center>[[Image:ReplaceRule.png]]</center>
This rule removes the specified string from the name and replaces it with another string. It has options to replace the first occurrence, the last occurrence, or all the occurrences. You can replace multiple strings at a time. You can create a pattern with wildcards, so that any string that matches the pattern will be removed.

The parameters are as follows:

{| class="prettytable"
|-
! Parameter
! Details
|-
| Find
| Enter the string to be replaced.
*You can enter multiple strings at a time. They will be searched & replaced in the order as they appear. Press the + button (or type vertical bar "<nowiki>|</nowiki>") to separate two strings.
*If the name does not contain the specified string, the rule will not act on it.
*If the name contains more than one of these strings, it will replace them according to the Occurrences parameter.

|-
| [[Image:PlusButton.png]] button
| Press to insert a vertical bar (<nowiki>|</nowiki>) that will separate multiple strings.
This inserts a separator in Replace box also. This means that pairs are replaced (e.g. A -->A', B -->B' etc.) }

|-
| Replace
| Enter strings that will replace the "Find" strings.
*Note that the quantity of strings (separated with "|") in "Find" and "Replace" boxes should be the same. If there is more strings in the "Find" box than in the "Replace" box the spare strings will be removed (replaced with an empty string). If there is more strings in the "Replace" box, the spare strings will be ignored.

|-
| Insert meta tag
[[Image:ReNamer Insert Meta Tag Button.png]]

| Click the button to see a list of [[ReNamer:Meta_Tags|meta-tags]].
|-
| Occurrences
| In case that strings occure more than once in the filename, specify which occurrences should be replaced. (Options are: ''first only'', ''last only'', or ''all'')
|-
| Skip extension
| If this check box is selected, the extension will be ignored by the rule.
|-
| Case sensitive
| Will only remove a specified string from the name if the case matches exactly.
|-
| Interpret symbols as wild cards
| The following wild cards are allowed (compare with RegEx).
{| class="prettytable"
|-
!
! Represents
! Example
|-
| <center>*</center>
| any number of characters (including numbers, space, underscores, etc.).
| '''abc*''' equals '''abc''' followed by 0 or more characters.
|-
| <center>?</center>
| Any single character (including numbers, space, underscores, etc.)
| '''ab?d''' equals '''abcd''', '''ab1d''', '''ab d''', '''ab_d''', etc.
|-
| <center>[]</center>
| Brackets enclose a set of characters, any one of which may match a single character at that position.
| '''foo[ab]ar '''equals '''fooaar''' and '''foobar'''
|-
| <center>-</center>
| (only within a pair of brackets) denotes a range of characters.
| '''foo[a-z]ar '''equals '''fooaar''', '''foobar,''' '''foocar,''' '''foodar,''' etc.
|}

|}

'''Note''': If you enter multiple find and replace strings they will be executed as multiple Replace rules, so first string will go first and only after replacing all (or first, or last) occurences of that string the second string in the Find box will be searched & replaced.

'''Example:'''

''Find:'' A|B 
''Replace:'' B|A

''Name:'' ABBA.mp3 
''New name:'' AAAA.mp3

You may expect the new name to be BAAB.mp3, but it's not. This happens because first all A's are replaced with B's (so we've got BBBB.mp3) and only then all B's are replaced with A's (and the final result is AAAA.mp3).

If you need to replace some characters one with another use [ReNamer:Rules:Translit|Translit] rule.

ReNamer:Rules:CleanUp

2009-08-26T13:41:05Z

Krtek:

== CleanUp Rule ==
<center>[[Image:CleanUpRule.png]]</center>
This rule cleans up the filenames for commonly used naming conventions for internet, peer-to-peer networks and other resources. Multiple problems can be removed at once.

The parameters are as follows:

{| class="prettytable"
|-
| <center>'''Parameter'''</center>
| <center>'''Details'''</center>
|-
| Strip out content of brackets
| A typical use of this option is to strip the needless comments attached to filenames, such as '''(best!!)'''.
*This option removes the brackets also.
*You can select any/all of the various types of brackets.

If you do NOT want to delete the content within the brackets, use the [[ReNamer:Rules:Strip|Strip]] rule instead. 

|-
| Replace these characters with spaces
| These characters occurring in the file names are removed and a space is inserted in their place.
|-
|Fix spaces
|Replace multiple consecutive spaces with a single space.
It also removes spaces from the beginning and the end of the filename:
*If '''skip extention''' is selected it removes spaces from the beginning and end of the ''base name'' (''before'' the extention). 
*If '''skip extention''' is deselected it removes spaces from the beginning and from the end of the ''filename'' (''after'' the extention).

|-
|Insert a space in front of capitalized letters
|Often words in the file name are just joined together, without spaces or underscores to separate them. Each word begins with a capital letter, so that you can read it easily.

This option separates such words in the file name.
:For example, '''SeparateTheseWords.pdf''' becomes '''Separate These Words.pdf'''.

(Note that if there is a capitalized letter at the very beginning of the name, ReNamer does NOT add a space before it.)
|-
| Prepare for SharePoint
| Prepares the file for hosting it on [http://www.microsoft.com/sharepoint/prodinfo/what.mspx Microsoft Sharepoint].
#strips standard forbidden filename characters
#strips consecutive dots
#strips '''#''', '''%''', '''~''', '''&'''
#replaces '''{''' and '''}''' with '''(''' and ''')'''

|-
| Skip extension
| If this check box is selected, the extension will be ignored by the rule.
|}

ReNamer:Rules:Serialize

2009-08-26T12:57:57Z

Krtek:

{{Template:Cleanup}}

== Serialize Rule ==
<center>[[Image:SerializeRule.png]]</center>

This rule works on a set of files, and inserts incremental numeric series or random sequences of digits in the names of those filenames.

When the ''incremental'' option is chosen, the files listed in the pane are numbered in ascending order. Thus, the position of the file in the '''Files''' pane becomes important. Check the order of the files in the list before applying this rule.

Examples:

# You have a bunch of log files, and you want to make them look like "log0001", "log0002", "log0003", etc.
# You want to force specific sorting for files: "01 - Song XYZ", "02 - Song ABC", "03 - Song YYY", etc.

The parameters are as follows:

{| class="prettytable"
! Parameter
! Details

|-
| Incremental
| Inserts serialized numbers in the names of the files placed in the Files pane of ReNamer.

{| class="prettytable"
| Index start
| Starting number. If the folder already has some files with serialized numbers, start with the next number.

|-
| Step
| Usually 1, but you may like to enter a higher number here if files with intermediate numbers are expected later.

|-
| Reset if folder changes
| Since ReNamer can work on files collected from multiple folders, this control allows you to reset the counter for each of those folders. The effect is as if you are repeating the same commend for each of the folders separately.

|}

|-
| Random
| Inserts a random number in the file name.

{| class="prettytable"
| Length
| Specify how many digits your random number should have.

* ReNamer will create random numbers with specified length (number of digits). So a length of 4 means the random digits will be from 0000 to 9999 (inclusive).

* Note that random numbers are padded with leading zeroes by default

|-
| Unique if possible
| Normally, random numbers can repeat themselves. If this option is selected, ReNamer will try to use unique numbers.

|}

|-
| Pad with zeros to reach length
| ReNamer will pad the remaining places with leading zeros. For example 457 becomes 000457 if it is padded to reach 6 digits, and 0457 if padded to 4 digits.

|-
| Insert where
| Specify where to insert the number.

{| class="prettytable"
| Prefix
| Before the original filename

|-
| Suffix
| After the original filename

* If the '''skip extension''' option is selected, the specified text will be inserted ''before'' the extension.

|-
| Position
| Insert the number at the specified position.

|}
Note that if the "''pad with zeros''" option (above) is selected, the ''padded '' number is inserted.

|}

ReNamer:Rules:Case

2009-08-26T12:03:38Z

Krtek:

== Case Rule ==
<center>[[Image:CaseRule.png]]</center>

This rule changes the case of the filename. Options are: capitalize, to lower case, to upper case, invert case, and put only first letter capital (as in a sentence).

There is also an option to force case for specific text-fragments, such as CD, DVD, RF, etc. These fragments would not look natural in any other case (e.g. cd, dvd, rf), so the rule allows you to prevent changing the case of such terms in one stroke.

The parameters are as follows:

{| class="prettytable"
! Parameter
! Details

|-
| Case change
| Several options are offered.

* The case of each option itself illustrates how that option works. For example, '''Capitalise Every Word'''.

*'''Invert case''' will change all capital letters in the filename to lowercased ones, and all lowercased letters to capitalized ones.

* The '''(none of the above)''' option is provided to disable the case conversions listed on the left, so you could independently operate the two options listed on the right side.

|-
| Skip extension
| If this check box is selected, the extension will be ignored by the rule.

|-
| Force case for fragments
| This check box is coupled with the box below it.

* Specify text fragments that must have a specific case. Case for these strings will be set as typed in the box regardless from options selected in '''Case change''' list.
Below you will find few of the common examples of such strings:
CD, DVD, TV, HTML, XML, C++, USA,
Java, India, English, Sunday, Easter,
OpenSUSE, OOo, ReNamer

* Put a comma between different fragments (in versions prior to v5.50 space was used instead of a comma).

|-
| Extension always lower case
| Forces the extension to lowercase.

'''Note:''' This setting overrides any other setting that can alter the extension. For example, consider a case where the ALL UPPER CASE option is selected and the skip extension option is deselected. Logically, the extension should be converted into ALLCAPS. But if the '''Extension always lower case '''option is selected, the case of the extension will be converted to lowercase.This setting will override even the fragments case-conversion.

|}

ReNamer:Rules:Case

2009-08-26T12:01:56Z

Krtek:

== Case Rule ==
<center>[[Image:CaseRule.png]]</center>

This rule changes the case of the filename. Options are: capitalize, to lower case, to upper case, invert case, and put only first letter capital (as in a sentence).

There is also an option to force case for specific text-fragments, such as CD, DVD, RF, etc. These fragments would not look natural in any other case (e.g. cd, dvd, rf), so the rule allows you to prevent changing the case of such terms in one stroke.

The parameters are as follows:

{| class="prettytable"
! Parameter
! Details

|-
| Case change
| Several options are offered.

* The case of each option itself illustrates how that option works. For example, '''Capitalise Every Word'''.

*'''Invert case''' will change all capital letters in the filename to lowercased ones, and all lowercased letters to capitalized ones.

* The '''(none of the above)''' option is provided to disable the case conversions listed on the left, so you could independently operate the two options listed on the right side.

|-
| Skip extension
| If this check box is selected, the extension will be ignored by the rule.

|-
| Force case for fragments
| This check box is coupled with the box below it.

* Specify text fragments that must have a specific case. Case for these strings will be set as typed in the box regardless from options selected in '''Case change''' list.
For example:
CD, DVD, TV, HTML, XML, C++, USA,
Java, India, English, Sunday, Easter,
OpenSUSE, OOo, ReNamer

* Put a comma between different fragments (in versions prior to v5.50 space was used instead of a comma).

|-
| Extension always lower case
| Forces the extension to lowercase.

'''Note:''' This setting overrides any other setting that can alter the extension. For example, consider a case where the ALL UPPER CASE option is selected and the skip extension option is deselected. Logically, the extension should be converted into ALLCAPS. But if the '''Extension always lower case '''option is selected, the case of the extension will be converted to lowercase.This setting will override even the fragments case-conversion.

|}

ReNamer:Rules:Strip

2009-08-26T11:43:51Z

Krtek:

{{Template:Cleanup}}

== Strip Rule ==
<center>[[Image:StripRule.png]]</center>
Strip characters from the filename. The rule has predefined character sets, like digits, symbols and brackets, but you can also define your own character set.

Every occurrence of each of the specified characters will be removed from the filename.

The parameters are as follows:

{| class="prettytable"
|-
! Parameter
! Details
|-
| Digits
| Strips digits
|-
| Symbols
| Strips symbols (all characters that are considered to be symbols are showed in the box on the right)
|-
| Brackets
| Strips brackets (but not the contents of the brackets)
*If you want to delete the content as well, use the [[ReNamer:Rules:CleanUp|CleanUp]] rule instead.

|-
| User-defined
| Define any character that needs to be stripped off.
*Note that this is not a string. All characters in the entry are searched for individually and removed.
|-
| Skip extension
| If this check box is selected, the extension will be ignored by the rule.
|}

ReNamer:Rules:Strip

2009-08-26T11:42:09Z

Krtek:

{{Template:Cleanup}}

== Strip Rule ==
<center>[[Image:StripRule.png]]</center>
Strip characters from the filename. The rule has predefined character sets, like digits, symbols and brackets, but you can also define your own character set.

Every occurrence of each of the specified characters will be removed from the filename.

The parameters are as follows:

{| class="prettytable"
|-
! Parameter
! Details
|-
| Digits
| Strips digits
|-
| Symbols
| Strips symbols
|-
| Brackets
| Strips brackets (but not the contents of the brackets)
*If you want to delete the content as well, use the [[ReNamer:Rules:CleanUp|CleanUp]] rule instead.

|-
| User-defined
| Define any character that needs to be stripped off.
*Note that this is not a string. All characters in the entry are searched for individually and removed.
|-
| Skip extension
| If this check box is selected, the extension will be ignored by the rule.
|}

ReNamer:Rules:Extension

2009-08-26T11:36:45Z

Krtek:

{{Template:Cleanup}}

== Extension Rule ==
<center>[[Image:ExtensionsRule.png]]</center>
This rule allows you to attach a new extension. It is useful when the extension of a file is missing (or if the file has a wrong extension). There is an option to find the correct extension based on the file's structure.

The parameters are as follows:

{| class="prettytable"
|-
! Parameter
! Details
|-
| New extension
| New extention that has to be added to the filename.

|-
| Append to the original filename
| If this option is selected, the new extension will be placed after the old extension.
If it is deselected (default option) the new extention will replace the old one.

|-
| Detect using binary signature
| Sometimes the extension of a file is missing. At other times it is wrong (e.g. some downloaded files get the '''aspx '''extension, although they may ''actually'' be '''zip '''or '''pdf''' files.)
One way to identify the file extension is by trial-and-error: Attach different extensions and try to open the file with its associated application. This is very tedious.

A far more efficient way is to compare the file's ''digital signature'' with the signatures of known file types and identify the file's type. This is done internally within ReNamer, so you do not have to know what a "digital signature" means, or the actual value of the signature for the given file.

Note that different extensions do not have unique signatures. So sometimes the file's signature may match the signature of several different extensions. In such cases, ReNamer shows the New filename with all matching extensions. For example, "fileName.flv|wmv|pdf". ReNamer also pops up an error window (because the combined extension is invalid). Just read the suggested extensions and then try them out one by one. This method is still better compared to making wild guesses, because ReNamer suggests only 2-3 extensions.

For more accurate results, [http://www.den4b.com/forum/viewtopic.php?id=550 use ReNamer with TrID], a specialized utility for identifying the file's real extension. Be aware that even TrID often suggests multiple extensions, and you still have to try them out. 

|}

ReNamer:Rules:Replace

2009-08-25T21:04:32Z

Krtek:

{{Template:Cleanup}}

== Replace Rule ==
<center>[[Image:ReplaceRule.png]]</center>
This rule removes the specified string from the name and replaces it with another string. It has options to replace the first occurrence, the last occurrence, or all the occurrences. You can replace multiple strings at a time. You can create a pattern with wildcards, so that any string that matches the pattern will be removed.

The parameters are as follows:

{| class="prettytable"
|-
! Parameter
! Details
|-
| Find
| Enter the string to be replaced.
*You can enter multiple strings at a time. Press the + button (or type vertical bar "<nowiki>|</nowiki>") to separate two strings.
*If the name does not contain the specified string, the rule will not act on it.
*If the name contains more than one of these strings, it will replace them according to the Occurrences parameter.

|-
| [[Image:PlusButton.png]] button
| Press to insert a vertical bar (<nowiki>|</nowiki>) that will separate multiple strings.
This inserts a separator in Replace box also. This means that pairs are replaced (e.g. A -->A', B -->B' etc.) }

|-
| Replace
| Enter strings that will replace the "Find" strings.
*Note that the quantity of strings (separated with "|") in "Find" and "Replace" boxes should be the same. If there is more strings in the "Find" box than in the "Replace" box the spare strings will be removed (replaced with an empty string). If there is more strings in the "Replace" box, the spare strings will be ignored.

|-
| Insert meta tag
[[Image:ReNamer Insert Meta Tag Button.png]]

| Click the button to see a list of [[ReNamer:Meta_Tags|meta-tags]].
|-
| Occurrences
| In case that strings occure more than once in the filename, specify which occurrences should be replaced. (Options are: ''first only'', ''last only'', or ''all'')
|-
| Skip extension
| If this check box is selected, the extension will be ignored by the rule.
|-
| Case sensitive
| Will only remove a specified string from the name if the case matches exactly.
|-
| Interpret symbols as wild cards
| The following wild cards are allowed (compare with RegEx).
{| class="prettytable"
|-
!
! Represents
! Example
|-
| <center>*</center>
| any number of characters (including numbers, space, underscores, etc.).
| '''abc*''' equals '''abc''' followed by 0 or more characters.
|-
| <center>?</center>
| Any single character (including numbers, space, underscores, etc.)
| '''ab?d''' equals '''abcd''', '''ab1d''', '''ab d''', '''ab_d''', etc.
|-
| <center>[]</center>
| Brackets enclose a set of characters, any one of which may match a single character at that position.
| '''foo[ab]ar '''equals '''fooaar''' and '''foobar'''
|-
| <center>-</center>
| (only within a pair of brackets) denotes a range of characters.
| '''foo[a-z]ar '''equals '''fooaar''', '''foobar,''' '''foocar,''' '''foodar,''' etc.
|}

|}

ReNamer:Rules:Remove

2009-08-25T20:48:00Z

Krtek:

{{Template:Cleanup}}

{{ReNamer Help|align=left}}

== Remove Rule ==
[[Image:RemoveRule.png]]

This rule removes the specified string from the file name. It has options to remove the first occurrence, the last occurrence, or all the occurrences of the specified string. You can enter multiple strings at a time (just separate them with "'''|'''"). If ReNamer finds any of them in the name, they will be removed. You can create a pattern with wildcards, so that any string that matches the pattern will be removed.

The parameters are as follows:

{| class="prettytable"
! Parameter
! Details

|-
| Remove
| Enter the string to be removed.

* You can enter multiple strings at a time. Press the + button to separate two strings
* If the name does not contain the specified string, the rule will not act on it.
* If the name contains more than one of these strings, it will remove all of them.

|-
| [[Image:PlusButton.png]] button
| Press to insert a separator between strings. You can also type a vertical bar ('''<nowiki>|</nowiki>''') from the keyboard.

|-
| Occurrences
| In case the strings occure multiple times in the name, specify which occurrences should be removed. (Options are: ''first only'', ''last only'', or ''all'')

|-
| Skip extension
| If this check box is selected, the rule won't touch the extention.

|-
| Case sensitive
| Will only remove a specified string from the name if the case matches exactly.

|-
| Interpret symbols as wildcards
| The following wildcards are allowed (compare with RegEx).

{| class="prettytable"
!
! Represents
! Example

|-
| <center><nowiki>*</nowiki></center>
| any number of characters (including numbers, space, underscores, etc.).
| '''abc*''' equals '''abc''' followed by 0 or more characters.

|-
| <center>?</center>
| Any single character (including numbers, space, underscores, etc.)
| '''ab?d''' equals '''abcd''', '''ab1d''', '''ab d''', '''ab_d''', etc.

|-
| <center><nowiki>[]</nowiki></center>
| Brackets enclose a set of characters, any one of which may match a single character at that position.
| '''<nowiki>foo[ab]ar </nowiki>'''equals '''fooaar''' and '''foobar'''

|-
| <center>-</center>
| (only within a pair of brackets) denotes a range of characters.
| '''<nowiki>foo[a-z]ar </nowiki>'''equals '''fooaar''', '''foobar,''' '''foocar,''' '''foodar,''' etc.

|}
|}

ReNamer:Rules:Delete

2009-08-25T20:39:02Z

Krtek:

{{ReNamer Help|align=left}}

== Delete Rule ==

[[Image:DeleteRule.png]]

 This rule will delete all characters located between the '''From''' and the '''Until '''points. Optionally, it can delete from the specified position till the end of the name.

The parameters are as follows:

{| class="prettytable"
|-
! Parameter
! Details
|-
| From
| Select either:
*The position (count starts from 1)
*The delimiter string (Note that typically ''', . / ( ) -''' and space are used as delimiters, but you can specify any letter/digit/sign or even couple of signs as delimiter) .

|-
| Until
| Same as above. In addition, you have the '''''till the end''''' option.
*You can use two different delimiters in '''From '''and '''Until''' sections.

|-
| Skip extension
| If this check box is unselected, the extension will be included in the rule.
|-
| right-to-left
| The '''From '''and '''Until''' positions switch places. (The '''From '''point is at the right side and the '''Until''' point is on the left).
*When this option is selected, the "till the end" option in '''Until''' deletes all characters on the left (what we regard as the ''beginning ''of the name)

|-
| Do not remove delimiter
| Will retain the delimiters
*If you have used two different delimiters in '''From '''and '''Until''' sections, ''both'' of them will be retained.

|}

ReNamer

2009-08-24T16:28:43Z

Krtek:

[[Image:ReNamer.png|thumb|250px]]

[[ReNamer]] is a very powerful and flexible file renaming tool, which offers all the standard renaming procedures, including prefixes, suffixes, replacements, case changes, as well as removing contents of brackets, adding number sequences, changing file extensions, etc. For advanced users, there is a [[ReNamer:Rules:PascalScript|PascalScript]] rule, which let users program their very own renaming rule. Program allows you to combine multiple renaming actions as a rule set, applying each action in a logical sequence, which can be saved, loaded, and managed within the program. In addition, it has an ability to rename folders, process regular expressions, Unicode capable, and supports variety of meta tags, such as: [http://en.wikipedia.org/wiki/ID3 ID3v1], [http://en.wikipedia.org/wiki/ID3 ID3v2], [http://en.wikipedia.org/wiki/EXIF EXIF], [http://en.wikipedia.org/wiki/Object_Linking_and_Embedding OLE], [http://msdn.microsoft.com/en-us/library/ms779636.aspx AVI], [http://en.wikipedia.org/wiki/MD5 MD5], [http://en.wikipedia.org/wiki/CRC32 CRC32], [http://en.wikipedia.org/wiki/SHA1 SHA1] and many more.

== User Manual ==

*[[ReNamer:Introduction|Introduction]]
*[[ReNamer:Quick guide|Quick guide]]
*[[ReNamer:Step-by-step|Step-by-step]]
**[[ReNamer:Adding files and folders|Adding files and folders]]
**[[ReNamer:Managing rules|Managing rules]]
**[[ReNamer:Previewing files|Previewing files]]
**[[ReNamer:Renaming files|Renaming files]]
*[[ReNamer:Using the Rules|Using the Rules]]
**[[ReNamer:Rules|Overview]]
**[[ReNamer:Rules:Insert|Insert]]
**[[ReNamer:Rules:Delete|Delete]]
**[[ReNamer:Rules:Remove|Remove]]
**[[ReNamer:Rules:Replace|Replace]]
**[[ReNamer:Rules:Rearrange|Rearrange]]
**[[ReNamer:Rules:Extension|Extension]]
**[[ReNamer:Rules:Strip|Strip]]
**[[ReNamer:Rules:Case|Case]]
**[[ReNamer:Rules:Serialize|Serialize]]
**[[ReNamer:Rules:CleanUp|CleanUp]]
**[[ReNamer:Rules:Translit|Translit]]
**[[ReNamer:Rules:RegEx|RegEx]]
**[[ReNamer:Rules:PascalScript|PascalScript]]
**[[ReNamer:Rules:UserInput|UserInput]]
*[[ReNamer:Using presets|Using presets]]
*[[ReNamer:Analyze|Analyze window]]
*[[ReNamer:Manual editing|Manual editing]]

=== Appendices ===

----
*[[ReNamer:Program settings|Program settings]]
*[[ReNamer:Main Menu and keyboard shortcuts|Main Menu and keyboard shortcuts]]
*[[ReNamer:Menus for the Files pane|Menus for the Files pane]]
*[[ReNamer:Context menus|Context menus]]
*[[ReNamer:Date and Time format|Date and Time format]]
*[[ReNamer:Meta Tags|Meta Tags]]
*[[ReNamer:Regular Expressions|Regular Expressions]]
*[[ReNamer:Pascal Script|Pascal Script]]
**[[ReNamer:Pascal Script:Quick guide|Quick guide]]
**[[ReNamer:Pascal Script:Types|Types]]
**[[ReNamer:Pascal Script:Functions|Functions]]
**[[ReNamer:Pascal_Script#Script cookbook|Script cookbook]]
**[[ReNamer:Scripts|Scripts]]
*[[ReNamer:Command Line use|Command Line use]]
*[[ReNamer:Ordering files|Ordering files]]
*[[ReNamer:Sorting files|Sorting files]]

ReNamer:Menus for the Files pane

2009-08-24T15:10:28Z

Krtek: /* Files button */

ReNamer has a menu bar between the '''Rules''' and '''Files''' panes [[Image:MenuStrip.png]].

This appendix describes the options available from this menu.

=== Files button ===

When you click on the [[Image:FilesButton.png]] button, the following list pops up:

The main menu looks like this:
<center>[[Image:FileMenu.png]]</center>
{| class="prettytable" style="width: 619px; height: 218px;"
|-
| Analyze Name
| Pops up the [[ReNamer:Analyze|analysis window]], and loads the names of the selected files.
|-
| Edit New Name '''F2'''
| Starts manual editing of the selected file.
|-
| Shell
| Options for Windows shell operations
|-
| Mark
| Options for [[ReNamer:Adding_files_and_folders#Marking_and_Unmarking_the_files|marking]] specific items
|-
| Clear
| Options for [[ReNamer:Adding_files_and_folders#Marking_and_Unmarking_the_files|unmarking]] specific items
|-
| Select
| Options for [[ReNamer:Adding_files_and_folders#Selecting_files|selecting]] specific items
|-
| Move
| Options for moving specific items
|-
| Count marked and selected files
| Total count of items (selected + marked)
|-
| Remove selected items '''Del'''
| Remove the selected items from the ReNamer's '''File''' pane. (This command does not delete the items from the disk.)
|}

This menu provides second-level options, as follows:

==== Shell submenu ====
<center>[[Image:ShellSubMenu.png]]</center>
 

{| class="prettytable"
|-
| Open File'''                Enter'''
| Open the selected file using its default associated application.
|-
| Open with Notepad'''  Shift+Enter'''
| Open the file with notepad. Useful when you want to see the raw data in the file. (When viewed this way, the file will not be displayed in it original formatting. It may not be easily readable.)
|-
| Open operating folder '''Ctrl+Enter'''
| Launch Windows Explorer, and open the folder where the selected file is located. Highlight (select) the file in it.
|-
| File properties'''Alt+Enter'''
| Display the properties of the selected file. Typically, file size; dates (Created/modified/accessed); comments; author; attributes (hidden, system, etc.)
|-
| Cut Files to clipboard '''Shift+Ctrl+X'''
| Puts the selected file on the clipboard. (Note: If you do not paste the file in a target application, the '''Cut''' operation is automatically canceled.)
|-
| Copy Files to clipboard'''Shift+Ctrl+C'''
| Puts a copy of the selected file on the clipboard.
|-
| Delete files to Recycle Bin
| Deletes the selected files to Recycle Bin. (They can be recovered from the Recycle Bin.)
Note that if the file is too large for the Recycle Bin, Windows will warn you that it will not be put in Recycle Bin, but deleted permanently. If you confirm, the file is deleted permanently.

|}

==== Mark submenu ====
<center>[[Image:MarkSubmenu.png]]</center>
'''Note'''''': '''Marking of files is explained [[ReNamer:Adding files and folders#Marking_and_Unmarking_the_files|here]]. 

{| class="prettytable"
|-
| Mark'''       Shift+M'''
| Mark all selected files. If some files are already marked, they remain marked.
|-
| UnMark'''   Shift+U'''
| Unmark all selected files. If some files are already unmarked, they remain unmarked.
|-
| Invert MarkingIns
| Marked files become unmarked, and vice versa.
|-
| Mark only changed (Inc. Case)
| [[ReNamer:Adding files and folders#Marking_and_Unmarking_the_files|Mark]] files that are changed. Files that had just change of case (and nothing else) will also be marked. ("''Change of case''" means some letters are converted capital-to-small and/or small-to-capital)
|-
| Mark only changed (Exc. Case)
| Mark files that are changed, but do not consider changes of case. ("''Change of case''" means some letters are converted capital-to-small and/or small-to-capital)
|-
| Mark only selected
| Mark files that are selected. If some unselected files are already marked, they will remain marked.
|-
| Mark by Mask
| Pops up a Mask window:
[[Image:MarkByMask.png]]

Specify a mask pattern. All files that match this mask will be marked.

You can enter multiple masks. If a file matches any of these masks, it will be marked.

|}

==== Clear submenu ====
<center>[[Image:ClearSubmenu.png]]</center>
'''Note''': The term "''Clear''" means remove from '''Files''' pane of ReNamer. 

{| class="prettytable"
|-
| Clear All
| Clear all files loaded in the pane.
|-
| Clear Renamed
| Clear all files which are renamed just before this command. Note that even if some files are not affected by the rules, they are still regarded as renamed successfully.
Only files that failed to rename (those with a '''x''' mark) will remain in the pane.

|-
| Clear Failed
| Only files that failed to rename (those with a '''x''' mark) will be cleared.
All other files (including the files whose names were not altered by the rules) will remain in the '''Files''' pane.

|-
| Clear Valid
| @@@valid means what?
|-
| Clear Invalid
| @@@Invalid means what? Files having name-conflict?
|-
| Clear Marked
| Clear all marked files.
|-
| Clear Not Marked
| Clear all files that are not marked.
|-
| Clear Not ChangedCtrl+D
| Clear all files that did not change.
@@@what does this include?

|}

==== Select submenu ====
<center>[[Image:SelectSubmenu.png]]</center>
Note: Selection of files is explained [[ReNamer:Adding files and folders#Selecting_files|here]]. 

{| class="prettytable"
|-
| Select All'''  Ctrl+A'''
| All files in the pane will be selected.
|-
| Invert Selection'''  Ctrl+I'''
| Selected files are unselected, and vice versa.
|-
| Select by Name Length  '''Ctrl+L'''
| Pops up a window:
[[Image:SelectByFileNameLengthDialog.png]]

Specify the length of file name. Only files that exceed that length will be selected.

The length refers to ''base name'' only; not the dot or the extension.

'''Note''': A typical application is to check if the file can be put on a CD/DVD. The maximum length allowed in ISO 9660-compliant file-system is 64 characters. Longer file names are truncated when you cut a CD/DVD. It is difficult to Correlate such files with their originals. To avoid such problems, shorten the names ''before'' cutting the CD/DVD.

|-
| Select by Extension  '''Ctrl+E'''
| Pops up a window:
[[Image:SelectByExtnDialog.png]]

Specify the extension (without the dot). All files having that extension will be selected.

You can enter multiple extensions (They must be separated by semicolons- not comma).

|-
| Select by Mask'''  Ctrl+M'''
| Pops up this window:
[[Image:SelectByMask.png]]

Specify the mask. All files matching that pattern will be selected. You can enter multiple masks (They must be separated by semicolons- not comma).

|}

==== Move submenu ====
<center>[[Image:MoveSubmenu.png]]</center>
 

{| class="prettytable"
|-
| Up'''      Ctrl+Up'''
| Moves the selected file up. This is used to re-arrange the files list.
(It is better to use the keyboard shortcut '''CTRL+UpArrow''').

|-
| Down'''  Ctrl+Down'''
| Moves the selected file down. This is used to re-arrange the files list.
(It is better to use the keyboard shortcut '''CTRL+DownArrow''').

|}

=== Filters menu ===

When you click on the [[Image:FiltersButton.png]] button, the '''Filters''' window pops up. It controls what gets added to the '''Files''' pane when you use the [[Image:AddFoldersButton.png]] button. 

{| class="prettytable"
|-
| [[Image:FilterSettingsDialog.png]]
| The options work as follows:
{| class="prettytable"
|-
| <center>'''Option'''</center>
| <center>'''Effect'''</center>
|-
| Add files within folders
| If you want to rename only directories, you would normally UNTICK Add files within folders option, and tick Add folders as files option. This will stop files being added from scanned folders.
|-
| Add folders as files
| ReNamer treats folder just like a file (not as a container that holds files and subfolders). So only the folder and its subfolders are loaded as files; but not the files in it. Useful for renaming the folder itself.
|-
| Include subfolders
| Loads contents from all subfolders recursively.
|-
| Include hidden items
| To protect hidden items, deselect this option.
|-
| Include system items
| To protect files reserved for system (OS), deselect this option.
|-
| Skip root folders when added as files
| Works when the Add folders as files option is selected. ReNamer adds all the subfolders by default (as files). But if ''this'' option is OFF, the folder itself will also be added to the list (as a file).
|-
| Masks
| All added files (or folders as files) must match specified mask(s). For example, if you enter '''*.jpg;*.gif;*.png'''as masks, ReNamer will add only files with these extensions. Everything else will be filtered ''out ''(not added to ReNamer).
|-
| Apply only to file name
| Changes how the masks (see above) are applied.
For example, suppose you have file '''''C:\Folder\File.ext'''''. If ''this'' option is ON, only the filename part ('''''File.ext''''') will checked against the mask(s). But if ''this'' option is OFF, the entire path ('''''C:\Folder\File.ext''''') will be checked against the mask(s).

|}

Press '''Save''' to save changes and return to the '''Add Folders''' window.

|}

In fact, this menu is also accessible during the '''Add Folder''' process. Hence it is described fully in [[ReNamer:Adding files and folders|Adding items using the 'Add Folders' button]] section.

=== Export menu ===
When you click on the [[Image:ExportButton.png]] button, the following list pops up:

<center>[[Image:ExportMenu.png]]</center>

{| class="prettytable"
| Export the paths and undo paths
|

|-
| Export the paths and new names
|

|-
| Import the paths and new names
|

|-
| Import files from text-list or play-list
|

|-
| Export new names to clipboard
|

|-
| Import new names from clipboard
|

|}

=== Options menu ===

When you click on the [[Image:OptionsButton.png]] button, the following list pops up:
<center>[[Image:OptionsMenu.png]]</center>
{| class="prettytable"
|-
| Autosize columns
| Auto-size all columns, to accommodate the longest file names in each column.
|-
| Validate new names
| Check if the new names are valid
|-
| Fix conflicting new names
| Add incremental numbers as suffixes to avoid conflicts in names. For example, if a new name for a file is Name1, and if it already exists in the target folder, then a suffix (1) is added to the newly renamed file. If more than one files have such name conflicts, ReNamer uses a incremental numbers (i.e., (1), (2), (3)...) as suffix; to make sure that each file gets a different suffix.
|-
| Highlight changed names
| Usually you load files only because you want to change their names. Yet, sometimes, some files escape all the rules you have loaded and remain unchanged. In such cases, you may want to know why that happened.
ReNamer can highlight the files that are going to change. Now you can investigate the remaining files.

'''Tip:''' You can unmark the rules selectively and see the effect on the files. That will tell you which rules are working on which files. Once your analysis is over, you can mark all rules.

|-
| Analyze sample text
| Instead of experimenting with files, it is safer to test the effect of your rules on text.
*Enter any text that looks like your target files, and see whether the rules work as desired on that text.
*Edit the rules if the desired result is not achieved
*Once you are satisfied with the rules, apply them on the real files.

Let us see an example.

I had already added a single [[ReNamer:Rules:Insert|Insert Rule]] in the '''Rules''' pane of ReNamer. It was set to insert "''2''" (without the quotes) at the 3rd position.

When the option is selected, a window like this pops up:

[[Image:AnalyzeDialog.png|center]]

In this window, I have added some arbitrary text to show the effect of the rule. Notice how '''x''' is added at the 3rd character in each line. I can move the cursor to any position. In this example, it is at the 3rd position (see the status line at the bottom of the screenshot).

Now I am reassured that the rule ''does'' insert an '''x''' at position-3. (My renaming will happen as planned.) Now I can close this window and go ahead and [[ReNamer:Renaming_files|rename my files]].

The options in the window are as follows:

{| class="prettytable"
|-
| Line wrap
| Wraps a line if it exceeds the window's width. (note that the window's width can be adjusted by dragging its right border.)
|-
| Automatically apply rules
| You do  not have to press the [[Image:ApplyRulesButton.png]] button.
|-
| Apply rules for each line
| Applies the rule to each line separately.
|}

 

|-
| Apply rules to the clipboard
|
|}

ReNamer:Rules

2009-08-24T15:08:12Z

Krtek:

== Overview of Rules ==

ReNamer has an extensive set of rules. These rules can be combined together, in a logical sequence, to perform nearly any thinkable operation with the filename. You can also [[ReNamer:Manual editing|manually edit]] the name of any file.

The table below lists all rules, with a brief description of each rule. The subsequent chapters provide more details for each rule (follow the links).

{| class="prettytable"
|-
! Rules
! Description
|-
| [[ReNamer:Rules:Insert|Insert]]
| Insert the specified text into the filename: as prefix, as suffix, at the specified position, before- or after the specified text. There is also an option to insert meta tags into the filename.
|-
| [[ReNamer:Rules:Delete|Delete]]
| Delete a portion of the filename, usually defined by character positions: from the specified position, from the occurrence of the specified delimiter, until the specified number of characters, until occurrence of the specified delimiter or till the end. This rule can be set to process the filename in a right-to-left manner.
|-
| [[ReNamer:Rules:Remove|Remove]]
| Remove the specified text from the filename: first, last or all occurrences. Optionally, wildcards can be used within this rule, to remove masked text fragments.
|-
| [[ReNamer:Rules:Replace|Replace]]
| This rule is very much like the '''Remove '''rule (above). It has similar options, except that instead of removing the text fragments, it will replace them with the specified text.
|-
| [[ReNamer:Rules:Rearrange|Rearrange]]
| This rule allows you to chop up the existing file name by any delimiter or position and reuse any/all of the parts in any order to compose a new name.
|-
| [[ReNamer:Rules:Extension|Extension]]
| Change extension of files to the specified extension, or to the extension automatically detected through the internal database of binary signatures.
|-
| [[ReNamer:Rules:Strip|Strip]]
| Strip all occurrences of the specified characters from the filename. This rule has predefined character sets, like digits, symbols, brackets, but you can also define your own character set.
|-
| [[ReNamer:Rules:Case|Case]]
| Change the case of the filename: capitalize each word, to lower case, to upper case, invert case, or capitalize only the first letter and force the rest to lowercase (as in a sentence). There is also an option to force case for the manually entered fragments, for example: CD, DVD, India, ReNamer, etc.
|-
| [[ReNamer:Rules:Serialize|Serialize]]
| Use numeric incremental or random sequences of digits to put filenames into an order.
|-
| [[ReNamer:Rules:CleanUp|CleanUp]]
| Cleanup filenames for commonly used naming conventions for Internet, peer-to-peer networks, and other resources.
|-
| [[ReNamer:Rules:Translit|Translit]]
| Transliterate Non-English characters from different languages into their English/Latin representation. Useful for preparing files for network storage and transfer. Several transliteration maps are built in, and you can define your own maps.
|-
| [[ReNamer:Rules:RegEx|RegEx]]
|
RegEx (=Regular Expressions) is used for complex pattern/expression matching and replacing operations. Although it may look complex at first, you can learn it quite easily, using the guide provided in this manual!

|-
| [[ReNamer:Rules:PascalScript|PascalScript]]
| Scripting allows programming-aware users to code their own renaming rule using predefined set of functions. This rule uses Pascal/Delphi programming syntax and conventions. Extremely powerful feature in the right hands.
|-
| [[ReNamer:Rules:UserInput|UserInput]]
| Rule that simply sets the new names of the files to the names entered in a list (one name per line).
|}

Each of these rules are explained in the following sections.

ReNamer:Rules:CleanUp

2009-08-24T15:07:26Z

Krtek:

== CleanUp Rule ==
<center>[[Image:CleanUpRule.png]]</center>
This rule cleans up the filenames for commonly used naming conventions for internet, peer-to-peer networks, and other resources. Multiple problems can be removed at once.

The parameters are as follows:

{| class="prettytable"
|-
| <center>'''Parameter'''</center>
| <center>'''Details'''</center>
|-
| Strip out content of brackets
| A typical use of this option is to strip the needless comments attached to file-names, such as '''(best!!)'''.
*This option removes the brackets also.
*You can select any/all of the various types of brackets.

If you do NOT want to delete the content within the brackets, use the [[ReNamer:Rules:Strip|Strip]] rule instead. 

|-
| Replace these characters with spaces
| These characters occurring in the file names are removed and a space is inserted in their place.
|-
|Fix spaces
|Replace multiple consecutive spaces with a single space.
Remove spaces at the beginning and end of the base name.
|-
|Insert a space in front of capitalized letters
|Often words in the file name are just joined together, without spaces or underscores to separate them. Each word begins with a capital letter, so that you can read it easily.

This option separates such words in the file name.
:For example, '''SeparateTheseWords.pdf''' becomes '''Separate These Words.pdf'''.

(Note that if there is a capitalized letter at the very beginning of the name, ReNamer does NOT add a space before it.)
|-
| Prepare for SharePoint
| Prepares the file for hosting it on [http://www.microsoft.com/sharepoint/prodinfo/what.mspx Microsoft Sharepoint].
#strip standard forbidden filename characters
#strip consecutive dots
#strip '#', '%', '~', '&'
#replace { and } with ( and )

|-
| Skip extension
| If this check box is unselected, the extension will be included in the rule.
|}

ReNamer

2009-08-24T15:06:16Z

Krtek: /* Appendices */

[[Image:ReNamer.png|thumb|250px]]

[[ReNamer]] is a very powerful and flexible file renaming tool, which offers all the standard renaming procedures, including prefixes, suffixes, replacements, case changes, as well as removing contents of brackets, adding number sequences, changing file extensions, etc. For advanced users, there is a [[ReNamer:Rules:PascalScript|PascalScript]] rule, which let users program their very own renaming rule. Program allows you to combine multiple renaming actions as a rule set, applying each action in a logical sequence, which can be saved, loaded, and managed within the program. In addition, it has an ability to rename folders, process regular expressions, Unicode capable, and supports variety of meta tags, such as: [http://en.wikipedia.org/wiki/ID3 ID3v1], [http://en.wikipedia.org/wiki/ID3 ID3v2], [http://en.wikipedia.org/wiki/EXIF EXIF], [http://en.wikipedia.org/wiki/Object_Linking_and_Embedding OLE], [http://msdn.microsoft.com/en-us/library/ms779636.aspx AVI], [http://en.wikipedia.org/wiki/MD5 MD5], [http://en.wikipedia.org/wiki/CRC32 CRC32], [http://en.wikipedia.org/wiki/SHA1 SHA1] and many more.

== User Manual ==

*[[ReNamer:Introduction|Introduction]]
*[[ReNamer:Quick guide|Quick guide]]
*[[ReNamer:Step-by-step|Step-by-step]]
**[[ReNamer:Adding files and folders|Adding files and folders]]
**[[ReNamer:Managing rules|Managing rules]]
**[[ReNamer:Previewing files|Previewing files]]
**[[ReNamer:Renaming files|Renaming files]]
*[[ReNamer:Using the Rules|Using the Rules]]
**[[ReNamer:Rules|Overview]]
**[[ReNamer:Rules:Insert|Insert]]
**[[ReNamer:Rules:Delete|Delete]]
**[[ReNamer:Rules:Remove|Remove]]
**[[ReNamer:Rules:Replace|Replace]]
**[[ReNamer:Rules:Rearrange|Rearrange]]
**[[ReNamer:Rules:Extension|Extension]]
**[[ReNamer:Rules:Strip|Strip]]
**[[ReNamer:Rules:Case|Case]]
**[[ReNamer:Rules:Serialize|Serialize]]
**[[ReNamer:Rules:CleanUp|CleanUp]]
**[[ReNamer:Rules:Translit|Translit]]
**[[ReNamer:Rules:RegEx|RegEx]]
**[[ReNamer:Rules:PascalScript|PascalScript]]
**[[ReNamer:Rules:UserInput|UserInput]]
*[[ReNamer:Using presets|Using presets]]
*[[ReNamer:Manual editing|Manual editing]]

=== Appendices ===

----

*[[ReNamer:Main Menu and keyboard shortcuts|Main Menu and keyboard shortcuts]]
*[[ReNamer:Menus for the Files pane|Menus for the Files pane]]
*[[ReNamer:Analyze|Analyze window]]
*[[ReNamer:Context menus|Context menus]]
*[[ReNamer:Meta Tags|Meta Tags]]
*[[ReNamer:Regular Expressions|Regular Expressions]]
*[[ReNamer:Pascal Script|Pascal Script]]
**[[ReNamer:Pascal Script:Quick guide|Quick guide]]
**[[ReNamer:Pascal Script:Types|Types]]
**[[ReNamer:Pascal Script:Functions|Functions]]
**[[ReNamer:Pascal_Script#Script cookbook|Script cookbook]]
**[[ReNamer:Scripts|Scripts]]
*[[ReNamer:Program settings|Program settings]]
*[[ReNamer:Command Line use|Command Line use]]
*[[ReNamer:Date and Time format|Date and Time format]]
*[[ReNamer:Ordering files|Ordering files]]
*[[ReNamer:Sorting files|Sorting files]]

ReNamer:Rules:Insert

2009-08-24T15:05:58Z

Krtek:

{{ReNamer Help|align=left}}

== Insert Rule ==

[[Image:InsertRule.png|center]]

This rule inserts the specified string at the beginning of the name, or end of the name, or at any other specified position. It can also insert the string ''conditionally (''only when the existing name contains a second specified string).

The parameters are as follows:

{| class="prettytable"
|-
! Parameter
! Details
|-
| What
| Enter the string that will be inserted.
|-
| Insert meta tag
[[Image:ReNamer Insert Meta Tag Button.png]]

| Click the button to see a list of [[ReNamer:Meta Tags|meta-tags]].
|-
| Where
| Select any one of the following options:
{| class="prettytable"
|-
| Prefix
| Adds the string before the existing name.
|-
| Suffix
| Adds the string after the existing name.
*If the '''skip extension '''option is not selected, the specified text will be inserted ''after'' the extension.

|-
| Position
| Insert at the set position (the count starts from 1).
*Count spaces and special characters also.

*You can count in the ''right-to-left ''direction

*You may use [[ReNamer:Analyze|Analyze]] window to check the position by pointing to the character with mouse or keyboard instead of counting it by yourself. Just [[ReNamer:Adding files and folders#Selecting files|select]] the file (or files) in the '''Files''' pane and choose the '''Analyze name''' option from the context menu.

|-
| After text
| Inserts the text entered in the "what" box after the text entered in the "after text" box.
*If the "after text" string is not found in the name, the "what" text will not be inserted.

|-
| Before text
| Inserts the text entered in the "what" box before the text entered in the "before text" box.
*If the "before text" string is not found in the name, the "what" text will not be inserted.

|}

|}

ReNamer:Analyze

2009-08-24T15:00:24Z

Krtek:

{{Template:Expand}}
The '''Analyze tool''' allows to apply rules to the text loaded into its window. The text may be a filename (or filenames) loaded from '''Files''' pane or any text manually created by user.
It also allows to check the positions of any character in the text just by pointing to it with keyboard or mouse (very useful eg. when you're using the Insert rule). The appropriate data is being displayed in the status bar of the window.

Let us see an example.

I had already added a single [[ReNamer:Rules:Insert|Insert Rule]] in the '''Rules''' pane of ReNamer. It was set to insert "''2''" (without the quotes) at the 3rd position.

When the option is selected, a window like this pops up:

[[Image:AnalyzeDialog.png|center]]

In this window, I have added some arbitrary text to show the effect of the rule. Notice how '''x''' is added at the 3rd character in each line. I can move the cursor to any position. In this example, it is at the 3rd position (see the status line at the bottom of the screenshot).

Now I am reassured that the rule ''does'' insert an '''x''' at position-3. (My renaming will happen as planned.) Now I can close this window and go ahead and [[ReNamer:Renaming_files|rename my files]].

The options in the window are as follows:

{| class="prettytable"
|-
| Line wrap
| Wraps a line if it exceeds the window's width. (note that the window's width can be adjusted by dragging its right border.)
|-
| Automatically apply rules
| You do  not have to press the [[Image:ApplyRulesButton.png]] button.
|-
| Apply rules for each line
| Applies the rule to each line separately.

ReNamer:Analyze

2009-08-24T14:58:16Z

Krtek: Created page with 'The '''Analyze tool''' allows to apply rules to the text loaded into its window. The text may be a filename (or filenames) loaded from '''Files''' pane or any text manually creat...'

The '''Analyze tool''' allows to apply rules to the text loaded into its window. The text may be a filename (or filenames) loaded from '''Files''' pane or any text manually created by user.
It also allows to check the positions of any character in the text just by pointing to it with keyboard or mouse (very useful eg. when you're using the Insert rule). The appropriate data is being displayed in the status bar of the window.

Let us see an example.

I had already added a single [[ReNamer:Rules:Insert|Insert Rule]] in the '''Rules''' pane of ReNamer. It was set to insert "''2''" (without the quotes) at the 3rd position.

When the option is selected, a window like this pops up:

[[Image:AnalyzeDialog.png|center]]

In this window, I have added some arbitrary text to show the effect of the rule. Notice how '''x''' is added at the 3rd character in each line. I can move the cursor to any position. In this example, it is at the 3rd position (see the status line at the bottom of the screenshot).

Now I am reassured that the rule ''does'' insert an '''x''' at position-3. (My renaming will happen as planned.) Now I can close this window and go ahead and [[ReNamer:Renaming_files|rename my files]].

The options in the window are as follows:

{| class="prettytable"
|-
| Line wrap
| Wraps a line if it exceeds the window's width. (note that the window's width can be adjusted by dragging its right border.)
|-
| Automatically apply rules
| You do  not have to press the [[Image:ApplyRulesButton.png]] button.
|-
| Apply rules for each line
| Applies the rule to each line separately.

ReNamer:Rules

2009-08-24T14:24:42Z

Krtek:

== Overview of Rules ==

ReNamer has an extensive set of rules. These rules can be combined together, in a logical sequence, to perform nearly any thinkable operation with the filename. You can also [[ReNamer:Manual editing|manually edit]] the name of any file.

The table below lists all rules, with a brief description of each rule. The subsequent chapters provide more details for each rule (follow the links).

{| class="prettytable"
|-
! Rules
! Description
|-
| [[ReNamer:Rules:Insert|Insert]]
| Insert the specified text into the filename: as prefix, as suffix, at the specified position, before- or after the specified text. There is also an option to insert meta tags into the filename.
|-
| [[ReNamer:Rules:Delete|Delete]]
| Delete a portion of the filename, usually defined by character positions: from the specified position, from the occurrence of the specified delimiter, until the specified number of characters, until occurrence of the specified delimiter or till the end. This rule can be set to process the filename in a right-to-left manner.
|-
| [[ReNamer:Rules:Remove|Remove]]
| Remove the specified text from the filename: first, last or all occurrences. Optionally, wildcards can be used within this rule, to remove masked text fragments.
|-
| [[ReNamer:Rules:Replace|Replace]]
| This rule is very much like the '''Remove '''rule (above). It has similar options, except that instead of removing the text fragments, it will replace them with the specified text.
|-
| [[ReNamer:Rules:Rearrange|Rearrange]]
| This rule allows you to chop up the existing file name by any delimiter or position and reuse any/all of the parts in any order to compose a new name.
|-
| [[ReNamer:Rules:Extension|Extension]]
| Change extension of files to the specified extension, or to the extension automatically detected through the internal database of binary signatures.
|-
| [[ReNamer:Rules:Strip|Strip]]
| Strip all occurrences of the specified characters from the filename. This rule has predefined character sets, like digits, symbols, brackets, but you can also define your own character set.
|-
| [[ReNamer:Rules:Case|Case]]
| Change the case of the filename: capitalize each word, to lower case, to upper case, invert case, or capitalize only the first letter and force the rest to lowercase (as in a sentence). There is also an option to force case for the manually entered fragments, for example: CD, DVD, India, ReNamer, etc.
|-
| [[ReNamer:Rules:Serialize|Serialize]]
| Use numeric incremental or random sequences of digits to put filenames into an order.
|-
| [[ReNamer:Rules:CleanUp|CleanUp]]
| Cleanup filenames from/for commonly used naming conventions for Internet, peer-to-peer networks, and other resources.
|-
| [[ReNamer:Rules:Translit|Translit]]
| Transliterate Non-English characters from different languages into their English/Latin representation. Useful for preparing files for network storage and transfer. Several transliteration maps are built in, and you can define your own maps.
|-
| [[ReNamer:Rules:RegEx|RegEx]]
|
RegEx (=Regular Expressions) is used for complex pattern/expression matching and replacing operations. Although it may look complex at first, you can learn it quite easily, using the guide provided in this manual!

|-
| [[ReNamer:Rules:PascalScript|PascalScript]]
| Scripting allows programming-aware users to code their own renaming rule using predefined set of functions. This rule uses Pascal/Delphi programming syntax and conventions. Extremely powerful feature in the right hands.
|-
| [[ReNamer:Rules:UserInput|UserInput]]
| Rule that simply sets the new names of the files to the names entered in a list (one name per line).
|}

Each of these rules are explained in the following sections.