Difference between revisions of "ReNamer:Rules:UserInput"

From den4b Wiki
Jump to: navigation, search
m (Added Examples)
m (little modification on my examples)
Line 44: Line 44:
 
The list of new names must exactly match the list of current files, one-by-one.
 
The list of new names must exactly match the list of current files, one-by-one.
 
{| class="wikitable"
 
{| class="wikitable"
! Current Name
+
! Current Name column
! Name list
+
! your NewName-list
 
|-
 
|-
 
| Old name 1
 
| Old name 1
Line 57: Line 57:
 
|}
 
|}
  
 +
Or in other words: the amount of items in your NewName list should match the current amount of items in the Name column. (see example below for clarifying)
  
Hint: The new name list must only contain the new names! <BR>
+
Hint: Your NewName list must only contain the new names! <BR>
 
Not the old names too, as maybe seen with other renamers like "old|new" or "old=new" or like that.
 
Not the old names too, as maybe seen with other renamers like "old|new" or "old=new" or like that.
  
 +
For example, if you have this three files:<BR>
 +
Old name 1<BR>
 +
Old name 2<BR>
 +
Old name 3<BR>
  
<B>Examples</B><BR>
+
then your NewName list should contain exactly three lines like:<BR>
 +
new name for old name 1<BR>
 +
new name for old name 2<BR>
 +
new name for old name 3<BR>
 +
 
 +
 
 +
 
 +
 
 +
 
 +
<B>Examples for clarifying:</B><BR>
 +
 
 +
Example 1<BR>
 
File list (Current Name) is longer then new name list:
 
File list (Current Name) is longer then new name list:
 
{| class="wikitable"
 
{| class="wikitable"
! Current Name
+
! Name column
! Name list
+
! NewName-list
 
|-
 
|-
 
| One.txt
 
| One.txt
Line 82: Line 98:
  
  
 
+
Example 2<BR>
 
New name list is longer then file list:
 
New name list is longer then file list:
 
{| class="wikitable"
 
{| class="wikitable"
! Current Name
+
! Name column
! Name list
+
! NewName-list
 
|-
 
|-
 
| One.txt
 
| One.txt
Line 102: Line 118:
  
  
 +
Example 3<BR>
 
<B>TAKE CARE!</B><BR>
 
<B>TAKE CARE!</B><BR>
 
Missed item in new name list;<B> your file names will get messed-up:</B>
 
Missed item in new name list;<B> your file names will get messed-up:</B>
 
{| class="wikitable"
 
{| class="wikitable"
! Current Name
+
! Name column
! Name list
+
! NewName-list
 
|-
 
|-
 
| One.txt
 
| One.txt

Revision as of 17:19, 11 October 2011

UserInputRule.png

This rule replaces the original filenames with the names taken from the list. (The nth line in the list serves as the new name for the nth 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:

  1. Click in the pane, and manually type the list (one name per line).
  2. 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 UserInputOptionsButton.png menu).
  3. Load a list from the text file (available from UserInputOptionsButton.png menu).

The optional parameters are as follows:

Parameter Description
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 extension option.
Replace the current name Replaces the existing filename with the new name.

The effect on extension depends on the Skip extension option:

Skip extension
  • If the option is selected, the extension 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 extension (if the Insert after the current name option is selected).


Example and warning

Warning
The list of new names must exactly match the list of current files, one-by-one.

Current Name column your NewName-list
Old name 1 new name for old name 1
Old name 2 new name for old name 2
Old name 3 new name for old name 3

Or in other words: the amount of items in your NewName list should match the current amount of items in the Name column. (see example below for clarifying)

Hint: Your NewName list must only contain the new names!
Not the old names too, as maybe seen with other renamers like "old|new" or "old=new" or like that.

For example, if you have this three files:
Old name 1
Old name 2
Old name 3

then your NewName list should contain exactly three lines like:
new name for old name 1
new name for old name 2
new name for old name 3



Examples for clarifying:

Example 1
File list (Current Name) is longer then new name list:

Name column NewName-list
One.txt First.txt
Two.txt Second.txt
Three.txt Third.txt
Four.txt <will not be renamed>


Example 2
New name list is longer then file list:

Name column NewName-list
One.txt First.txt
Two.txt Second.txt
Three.txt Third.txt
<unused> Fourth.txt


Example 3
TAKE CARE!
Missed item in new name list; your file names will get messed-up:

Name column NewName-list
One.txt First.txt
Two.txt Third.txt
Three.txt Fourth.txt
Four.txt Fifth.txt