Difference between revisions of "ReNamer:Rules:Rearrange"

From den4b Wiki
Jump to navigation Jump to search
(Clarified the "skip extension" option)
 
(34 intermediate revisions by 3 users not shown)
Line 1: Line 1:
== Rearrange rule<br>  ==
+
{{Go|up=ReNamer:Rules|prev=ReNamer:Rules:Replace|next=ReNamer:Rules:Extension}}
  
[[Image:RearrangeRule.png|center]]This rule allows you to cut the exiting file name anyway you like and reuse the parts to compose a new name.
+
== Rearrange rule ==
  
*You can also add your own text, or use any meta tags while composing the new name.
+
[[Image:RearrangeRule.png|center]]
 +
 
 +
This rule allows you to chop up the existing file name and reuse any/all of the parts in any order to compose a new name.
 +
 
 +
*You can also add your own text, or use meta tags while composing the new name.  
 +
*You can also use the whole original name, and insert literal text (or meta tags) around it.<br>
  
 
The parameters are as follows:  
 
The parameters are as follows:  
  
{| cellspacing="1" cellpadding="1" border="1" style="width: 685px; height: 562px;"
+
{| class="wikitable"
 
|-
 
|-
| align="center" | '''Parameter'''
+
! Parameter
| align="center" | '''How to use-'''
+
! Description
 
|-
 
|-
| split using-
+
| Split using  
 
|  
 
|  
 
Specifies how to split the existing name into parts.  
 
Specifies how to split the existing name into parts.  
  
*You can use only one of the two options at a time (you cannot combine the chopping methods)<br>
+
*You can use only one of the three options at a time (you cannot combine the chopping methods)
 +
 
 +
For detailed explanation of split methods please look below at the [[#Split options explained|split options explained]] section.
  
{| cellspacing="1" cellpadding="1" border="1" style="width: 518px; height: 140px;"
 
 
|-
 
|-
| align="center" | '''Option'''
+
| [[Image:PlusButton.png]]
| align="center" | '''What it does-'''
+
| Add a separator for additional delimiters. The separator is a "{{Pipe}}" (vertical pipe) character, which can also be entered manually.
 
|-
 
|-
| Delimiter
+
| New pattern
 
|  
 
|  
Chop the name where the delimiter occurs.  
+
How to compose the new name from the parts created from the original name (see above).  
  
*The delimiter can be a single character or a string.  
+
*You can add meta tags and literal text wherever you want.  
*The chopped parts do <u>''not''</u> contain the delimiters (they are omitted totally)
+
*$0 refers to the whole original name. This allows you to quickly compose a new name by inserting a string at the beginning and/or end.
*Spaces, numbers and symbols are treated like normal characters.  
 
*Several delimiters can be used at a time. Use the &#124; character to separate them.
 
*The chopped parts are numbered from left, as $1, $2, $3, etc.
 
*If the delimiter occurs at the very beginning of the name, the resultant $1 contains nothing (because thereis nothing on the left side of the delimiter).<br>
 
  
 
|-
 
|-
| Positions
+
| [[Image:ReNamer Insert Meta Tag Button.png]]
|  
+
| Click the button to see a list of [[ReNamer:Meta Tags|meta-tags]]. Select any meta tag to insert it in the new name template.
Chops the name at the indicated position (the count begins with 1).  
 
  
*If you enter position '''''n''''', ReNamer will chop the nth character and all characters beyond that in a separate piece.
+
|-
*Spaces, numbers and symbols are treated like normal characters.
+
| Skip extension
*Contracry to "delimiter" option, no part of the original name is omitted during chopping.  
+
| If checked, the file extension will be excluded from the processing and will remain unaffected.
*You can enter multiple positions. Separate them with the &#124; character.
 
 
 
|}
 
  
 
|-
 
|-
Line 53: Line 51:
 
*The characters of the original names are counted from right (the count begins with 1)  
 
*The characters of the original names are counted from right (the count begins with 1)  
 
*The chopped parts will also be numbered from right ($1, $2, etc.)
 
*The chopped parts will also be numbered from right ($1, $2, etc.)
 
|-
 
|
 
| Adds a &#124; character between two delimiter entries, and separates them. <br>(You can directly type the '''&#124;''' character instead of clicking on this button.).
 
|-
 
| new pattern/order
 
|
 
How to compose the new name from the parts created from the original name (see above).
 
 
*You can add meta tags and literal text wherever you want.
 
 
|-
 
|
 
| Triggers the meta-tag window. Select a Meta Tag to enter it in the new name template.
 
 
|}
 
|}
  
This rule can be used in a many ways. Only a few examples are given below.
+
=== Split options explained ===
  
For simplicity's sake, we have split the uses in two parts:
+
{| class="wikitable"
 
 
#'''Basic uses '''(typical needs of beginners)
 
#'''Advanced uses''' (for the power users)
 
 
 
== Basic uses  ==
 
 
 
=== Example 1  ===
 
 
 
'''Task:''' Switch the words, and remove the comma between them.
 
 
 
{| width="330" height="106" align="center" class="prettytable" style=""
 
 
|-
 
|-
| <center>'''Change from-'''</center>
+
! Option
| <center>'''To-'''</center>
+
! Description
 
|-
 
|-
| King, Stephen
+
| Delimiters
Cook, Robin
+
|
 +
Chop the name where the delimiter occurs.
  
Pride and Prejudice, The  
+
*The delimiter can be a single character or a string.
 
+
*The chopped parts do <u>''not''</u> contain the delimiters (they are omitted totally)
| Stephen King
+
*Spaces, numbers and symbols are treated like normal characters.
Robin Cook
+
*Several delimiters can be used at a time. Use the {{pipe}} character to separate them.
 
+
*The chopped parts are numbered from left, as $1, $2, $3, etc.
The Pride and Prejudice
+
:The same parts can be referred from the end as $-1, $-2, $-3, etc.
 
+
*If the delimiter occurs at the very beginning of the name, the resultant $1 contains nothing (because there is nothing on the left side of the delimiter).
|}
+
:The same is true if an delimiter match at the very end of the name, the resultant $n contains nothing.
 
 
'''Settings:'''  
 
 
 
Delimiter: ", " (without the quotes)
 
 
 
New Order: $2 $1  
 
 
 
=== Example 2  ===
 
 
 
===  ===
 
  
'''Task:''' Move a word to a new position.  
+
<span style="color: red;">'''Warning:'''</span> The number of parts into which the filename is broken down depends solely on the number of delimiters in the filename. If you reference fewer parts in the output pattern that the number of available parts - not referenced parts will be lost! For example, take filename "Artist - Title" and to swap them around one would use " - " as a delimiter and "$2 - $1" as a new pattern which will result in "Title - Artist", but if some filename appears with more dashes like "Artist - Title - Album" the result will also be "Title - Artist" and last part will be lost. To make sure that no parts are lost use '''Exact pattern of delimiters''' option instead.  
  
{| class="prettytable"
 
 
|-
 
|-
| <center>'''Change from-'''</center>
+
| Positions
| <center>'''To-'''</center>
+
|  
|-
+
Chop the name at the indicated position (the position count begins with 1).
| Words sample 1234 07-07-07
 
| 1234 Words sample 07-07-07
 
|}
 
  
'''Settings:'''  
+
*If you enter position '''n''', ReNamer will chop the '''n'''-th character and all characters beyond that in a separate piece.
 
+
*Spaces, numbers and symbols are treated like normal characters.
Delimiter: " " (only a space, without the quotes)
+
*No part of the original name is omitted during chopping.
 
+
*You can enter multiple positions. Separate them with the '''*&#124;*''' sequence.
New Order: $3 $1 $2 $4
+
*The chopped parts are numbered from left, as $1, $2, $3, etc.
 
 
=== Example 3 ===
 
  
'''Task:''' Get rid of the numbers, hyphen and space at the beginning.  
+
:The same parts can be referred from the end as $-1, $-2, $-3, etc.
  
{| class="prettytable"
 
 
|-
 
|-
| <center>'''Change from-'''</center>
+
| Exact pattern of delimiters  
| <center>'''To-'''</center>
+
|  
|-
+
Chop the name using the exact pattern (sequence) of the delimiters.  
| 01 - Afilename.zip
 
002 - Bfilename.zip
 
 
 
0003 - Cfilename.zip
 
 
 
| Afilename.zip
 
Bfilename.zip
 
 
 
Cfilename.zip
 
 
 
|}
 
 
 
'''Settings:'''
 
 
 
Delimiter: "- " (without the quotes)
 
 
 
New Order: $2
 
 
 
'''Remarks:'''
 
 
 
#Note that the delimiter contains a space. If only a hyphen is used as delimiter, then a space would be left out in the beginning of the name, which you would have to trim separately.
 
#The '''Delete''' rule also would work (in ''right-to-left ''mode). But the '''Rearrange''' rule also allows you to add any string to the truncated names.
 
 
 
=== Example 4 ===
 
 
 
'''Task: '''Move the first part to the end.
 
 
 
{| class="prettytable"
 
|-
 
| <center>'''Change from-'''</center>
 
| <center>'''To-'''</center>
 
|-
 
| TEST.aaa.bbb.100.ext
 
| aaa.bbb.100.TEST.ext
 
|}
 
 
 
 
 
 
 
'''Setting:'''
 
 
 
Delimiter: "." (without the quotes)
 
 
 
New Order: $2.$3.$4.$1<br>
 
 
 
=== Example 5 ===
 
 
 
'''Task: '''Move the artist's name from end to the beginning, and change the name format.
 
 
 
{| class="prettytable"
 
|-
 
| <center>'''Change from-'''</center>
 
| <center>'''To-'''</center>
 
|-
 
| Ring ring_ABBA.mp3
 
Material girl_Madonna.mp3
 
 
 
| ABBA - Ring Ring.mp3
 
Madonna - Material girl mp3
 
 
 
|}
 
 
 
 
 
 
 
'''Settings:'''
 
 
 
Delimiter: "_" (without the quotes)
 
 
 
New Order: $2 - $1
 
 
 
=== Example 6  ===
 
 
 
'''Task:''' Move the numbers to the beginning.
 
 
 
{| class="prettytable"
 
|-
 
| <center>'''Change from-'''</center>
 
| <center>'''To-'''</center>
 
|-
 
| DSC_0001-1.jpg
 
DSC_0001-10.jpg
 
 
 
DSC_0001-2.jpg
 
 
 
| 1-DSC_0001.jpg
 
10-DSC_0001.jpg
 
 
 
2-DSC_0001.jpg
 
 
 
|}
 
 
 
 
 
 
 
'''Settings:'''
 
 
 
Delimiter: "-" (without the quotes)
 
 
 
New Order: $2-$1
 
 
 
<br>
 
 
 
=== Example 7  ===
 
 
 
'''Task:''' Insert "sent_" before the last 3 digits.
 
 
 
{| class="prettytable"
 
|-
 
| <center>'''Change from-'''</center>
 
| <center>'''To-'''</center>
 
|-
 
| family_001.jpg
 
work_023.jpg
 
 
 
friend_098.jpg
 
 
 
| family_sent_001.jpg
 
work_sent_023.jpg
 
 
 
friend_sent_098.jpg
 
 
 
|}
 
 
 
 
 
 
 
'''Settings:'''
 
 
 
Delimiter: "_" (without the quotes)
 
 
 
New Order: $1_sent_$2
 
 
 
'''Remarks:'''
 
 
 
The '''Insert''' rule also would work (in ''right-to-left ''mode). But the '''Rearrange''' rule also allows you to add any string to the names.
 
 
 
=== Example 8  ===
 
 
 
'''Task:''' Remove the name of the artist (delete text until hyphen).
 
 
 
{| class="prettytable"
 
|-
 
| <center>'''Change from-'''</center>
 
| <center>'''To-'''</center>
 
|-
 
| Sting - All This Time.mp3
 
| All This Time.mp3
 
|}
 
 
 
 
 
 
 
'''Settings:'''
 
 
 
Delimiter: "- " (without the quotes)
 
 
 
New Order: $2
 
 
 
'''Remarks:'''
 
 
 
#Note the space after the hyphen. If we use just a "-" as delimiter, the second token would be left with a space in front, which we will have to trim separately.
 
#Even the '''Delete''' rule would have worked (in ''right-to-left ''mode). But the '''Rearrange''' rule also allows you to add any string to the new name.
 
 
 
=== Example 9  ===
 
 
 
'''Task:''' Remove the track numbers (and any separator symbol after that) from the beginning of the filenames:
 
 
 
{| class="prettytable"
 
|-
 
| <center>'''Change from-'''</center>
 
| <center>'''To-'''</center>
 
|-
 
| 08. Madonna - Like A Prayer.wma
 
08.-Madonna - Like A Prayer.wma
 
 
 
08 Madonna&nbsp; - Like A Prayer.wma
 
 
 
| Madonna&nbsp; - Like A Prayer.wma
 
|}
 
 
 
 
 
 
 
'''Settings:'''
 
 
 
Delimiter: "Mad" (without the quotes)
 
 
 
New Order: Mad$2
 
 
 
'''Remarks: '''
 
 
 
We chose the string "Mad" as delimiter because it does not occur anywhere else in the names. The unwanted characters on the left are assigned to token $1, which we will not omit in the new name. However, there is an undesired side-effect: ReNamer removes "Mad" string from the token $2 because it is the delimiter. Therefore, we have to manually add that missing string "Mad" to $2, to restore the names.
 
 
 
=== Example 10 ===
 
 
 
'''Task: '''Move the number to front, and remove the square brackets.
 
 
 
{| class="prettytable" style="width: 273px; height: 48px;"
 
|-
 
| <center>'''Change from-'''</center>
 
| <center>'''To-'''</center>
 
|-
 
| Name XXX [0001].jpg<br>
 
| 0001 - Name XXX.jpg
 
|}
 
 
 
 
 
 
 
'''Settings:'''
 
 
 
Delimiter: "[|]" (without the quotes)
 
 
 
New Order: $2 - $1
 
 
 
'''Remarks:'''
 
 
 
#The | character is used to separate the two delimiters.
 
#The second delimiter "|" will not produce a token. It is included only to remove it from the new name.
 
 
 
=== Example 11<br> ===
 
 
 
'''Task: '''Add composer name and duration to an mp3 file,as prefix and suffix, respectively
 
 
 
{| class="prettytable"
 
|-
 
| <center>'''Change from-'''</center>
 
| <center>'''To-'''</center>
 
|-
 
| Eine kleine Nachtmusik.mp3
 
Don Giovanni.mp3
 
 
 
| Mozart - Eine kleine Nachtmusik (6.37).mp3
 
Mozart - Don Giovanni (4.5).mp3
 
 
 
|}
 
 
 
 
 
 
 
'''Settings:'''
 
 
 
Positions: 1
 
 
 
New Order: Mozart - $2 (:AudioDuration:)
 
 
 
'''Remarks:'''
 
 
 
#This can also be done by using the '''Insert''' rule. However, you have to use that rule twice (once for prefix and the second time for the suffix). On the other hand, the '''Rearrange''' rule allows you to add both in a single stroke. Besides, you can see the structure of the new name.
 
#When the original name is sliced at position 1, there is no characters on the left side; so the $1 token is a blank. The ''entire'' name is copied into the $2 token. This is a great trick to compose new name using the ''whole'' original name.
 
 
 
== Advanced uses  ==
 
 
 
=== Example 1<br> ===
 
 
 
'''Task:''' Remove the string&nbsp; from the file name.
 
 
 
{| class="prettytable" style="width: 426px; height: 48px;"
 
|-
 
| <center>'''Change from-'''</center>
 
| <center>'''To-'''</center>
 
|-
 
| Artist - Title [Time 4 02 Cold] [2004].mpg<br>
 
| Artist - Title [2004].mpg<br>
 
|}
 
 
 
 
 
 
 
'''Settings:'''
 
 
 
Delimiter: " [T|d] " (without the quotes)  
 
 
 
New Order: $1 $3
 
 
 
'''Remarks:'''
 
 
 
#The '''|''' character separates the two delimiters.
 
#Notice that we have included spaces in the delimiters, so that they do not end up as part of the tokens.
 
#We have selected two ''different'' delimiters to represent the beginning- and the end of the string we want to remove. Thus '''''whatever''''' lies between the two delimiters is converted into a token. This token is then omitted in the new name. This works just like using wildcards for the string (or a RegEx pattern).
 
 
 
=== Example 2<br> ===
 
 
 
'''Task: '''The file names contain artist name, album name and track name. Sort them into separate folders as follows:
 
 
 
#Create a separate folder for each artist.
 
#For each artist, create a subfolder for each album.
 
#Move each file in the corresponding folder.
 
 
 
{| class="prettytable"
 
|-
 
| <center>'''Change from-'''</center>
 
| <center>'''To-'''</center>
 
|-
 
| Song title1 - Artist1 (Album1).mp3
 
Song title2 - Artist1 (Album1).mp3
 
 
 
Song title1 - Artist1 (Album2).mp3
 
 
 
Song title2 - Artist1 (Album2).mp3
 
 
 
Song title1 - Artist2 (Album1).mp3
 
 
 
Song title1 - Artist2 (Album1).mp3
 
 
 
| D:\Artist1\Album1\Song title1.mp3
 
D:\Artist1\Album1\Song title2.mp3
 
 
 
D:\Artist1\Album2\Song title1.mp3
 
 
 
D:\Artist1\Album2\Song title2.mp3
 
 
 
D:\Artist2\Album1\Song title1.mp3
 
 
 
D:\Artist2\Album1\Song title2.mp3
 
 
 
|}
 
 
 
 
 
 
 
'''Settings:'''
 
 
 
Delimiter: " - | (|)" (without the quotes)
 
 
 
New pattern: D:\$2\$3\$1
 
 
 
'''Remarks:'''
 
 
 
#Note that the delimiters contain spaces and symbols, so that only text remains in the tokens.
 
#The last delimiter ) does not produce a token. It is added just to strip the closing bracket from the last token.
 
#Instead of “D:”, a relative path (such as '''..\..\''') can be added to the front.
 
 
 
=== Example 3<br>  ===
 
 
 
'''Task: '''Sort digital photos in different folders based on the '''Date taken''' for each photo.
 
 
 
{| class="prettytable"
 
|-
 
| <center>'''Change from-'''</center>
 
| <center>'''To-'''</center>
 
|-
 
| DSC_0001.jpg
 
DSC_0002.jpg
 
 
 
DSC_0003.jpg
 
 
 
DSC_0004.jpg
 
<center>'''...'''</center>
 
DSC_0125.jpg
 
 
 
| D:\photos\trip\2009_10_21\DSC_0001.jpg
 
D:\photos\trip\2009_10_21\DSC_0002.jpg
 
 
 
D:\photos\trip\2009_10_21\DSC_0003.jpg
 
 
 
D:\photos\trip\2009_10_22\DSC_0004.jpg
 
<center>'''...'''</center>
 
D:\photos\trip\2009_10_25\DSC_0125.jpg
 
 
 
<br>
 
  
<br>
+
With this option you basically define how many parts you want the filename to be split into and the order in which the delimiters must occur. If you specify 1 delimiter then you end up with exactly 2 parts, if you specify 2 delimiters you'll get 3 parts, and so on.
  
 
|}
 
|}
  
<br>
+
== Examples ==
 
 
'''Settings:'''
 
 
 
Delimiter: "D" (without the quotes)
 
 
 
New pattern: D:\photos\trip\:EXIF_Date:\D$2
 
 
 
'''Remarks:'''
 
 
 
#Note that this EXIF data is contained in the meta tag of each photo, not in the file name.
 
#The meta tag ''':EXIF_Date: '''is replaced by the actual '''date taken''' for each photo. Thus all photos taken on the same date will be moved to the same folder (which is named after that date).
 
#The actual name of the folder would depend upon the current settings for the system date format. (If you want the folders to be named after a different date format, first change the system date format, using the '''Regional and Language Options''' option in the '''Control Panel'''.)
 
 
 
=== Example 4<br> ===
 
 
 
'''Task:''' Delete the last part of the base name (but the extension should remain). Note that the file names have different lengths, so you cannot slice the name at a particular position. The names have a different depths also (number of segments separated by dots).
 
 
 
{| class="prettytable"
 
|-
 
| <center>'''Change from-'''</center>
 
| <center>'''To-'''</center>
 
|-
 
| title.text1.text2.extension
 
title.text1.text2.text3.extension
 
 
 
| title.text1.extension
 
title.text1.text2.extension
 
 
 
|}
 
 
 
 
 
 
 
'''Setting:''' The solution requires a stack of two different rules, as shown below:
 
 
 
1. '''Replace''' Rule
 
 
 
Find: "." (without the quotes)
 
 
 
Replace: "#" (without the quotes)
 
 
 
(this is a temporary change; which will be eliminated in the second step)
 
 
 
2. '''Rearrange''' rule
 
 
 
Delimiter: "#" (without the quotes)
 
 
 
New Order: $1
 
  
'''Remarks: '''
+
This rule is so versatile that it can be used in a huge number of ways.
 +
Therefore its examples have been moved to a separate article [[ReNamer:Rules:Rearrange Examples|Rearrange Examples]].
  
We had to do this indirectly because the '''Rearrange''' rule cannot pick only the last dot as delimiter; and ignore the other dots. So we used a trick: we first changed the last dot into another character (using the '''Replace''' rule), and then use that new character as delimiter in the '''Rearrange''' rule.
+
[[Category:ReNamer]]

Latest revision as of 01:31, 1 April 2022

Rearrange rule

RearrangeRule.png

This rule allows you to chop up the existing file name and reuse any/all of the parts in any order to compose a new name.

  • You can also add your own text, or use meta tags while composing the new name.
  • You can also use the whole original name, and insert literal text (or meta tags) around it.

The parameters are as follows:

Parameter Description
Split using

Specifies how to split the existing name into parts.

  • You can use only one of the three options at a time (you cannot combine the chopping methods)

For detailed explanation of split methods please look below at the split options explained section.

PlusButton.png Add a separator for additional delimiters. The separator is a "|" (vertical pipe) character, which can also be entered manually.
New pattern

How to compose the new name from the parts created from the original name (see above).

  • You can add meta tags and literal text wherever you want.
  • $0 refers to the whole original name. This allows you to quickly compose a new name by inserting a string at the beginning and/or end.
ReNamer Insert Meta Tag Button.png Click the button to see a list of meta-tags. Select any meta tag to insert it in the new name template.
Skip extension If checked, the file extension will be excluded from the processing and will remain unaffected.
Right-to-left

If selected, the numbering starts from right.

  • The characters of the original names are counted from right (the count begins with 1)
  • The chopped parts will also be numbered from right ($1, $2, etc.)

Split options explained

Option Description
Delimiters

Chop the name where the delimiter occurs.

  • The delimiter can be a single character or a string.
  • The chopped parts do not contain the delimiters (they are omitted totally)
  • Spaces, numbers and symbols are treated like normal characters.
  • Several delimiters can be used at a time. Use the | character to separate them.
  • The chopped parts are numbered from left, as $1, $2, $3, etc.
The same parts can be referred from the end as $-1, $-2, $-3, etc.
  • If the delimiter occurs at the very beginning of the name, the resultant $1 contains nothing (because there is nothing on the left side of the delimiter).
The same is true if an delimiter match at the very end of the name, the resultant $n contains nothing.

Warning: The number of parts into which the filename is broken down depends solely on the number of delimiters in the filename. If you reference fewer parts in the output pattern that the number of available parts - not referenced parts will be lost! For example, take filename "Artist - Title" and to swap them around one would use " - " as a delimiter and "$2 - $1" as a new pattern which will result in "Title - Artist", but if some filename appears with more dashes like "Artist - Title - Album" the result will also be "Title - Artist" and last part will be lost. To make sure that no parts are lost use Exact pattern of delimiters option instead.

Positions

Chop the name at the indicated position (the position count begins with 1).

  • If you enter position n, ReNamer will chop the n-th character and all characters beyond that in a separate piece.
  • Spaces, numbers and symbols are treated like normal characters.
  • No part of the original name is omitted during chopping.
  • You can enter multiple positions. Separate them with the *|* sequence.
  • The chopped parts are numbered from left, as $1, $2, $3, etc.
The same parts can be referred from the end as $-1, $-2, $-3, etc.
Exact pattern of delimiters

Chop the name using the exact pattern (sequence) of the delimiters.

With this option you basically define how many parts you want the filename to be split into and the order in which the delimiters must occur. If you specify 1 delimiter then you end up with exactly 2 parts, if you specify 2 delimiters you'll get 3 parts, and so on.

Examples

This rule is so versatile that it can be used in a huge number of ways. Therefore its examples have been moved to a separate article Rearrange Examples.