Difference between revisions of "ReNamer:Rules:Rearrange"

Latest revision as of 01:31, 1 April 2022

ReNamer:Rules

ReNamer:Rules:Replace

ReNamer:Rules:Extension

Rearrange rule

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.
	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.
	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.

Difference between revisions of "ReNamer:Rules:Rearrange"

Latest revision as of 01:31, 1 April 2022

Rearrange rule

Split options explained

Examples

Navigation menu

Search

@@ Line 1: / Line 1: @@
-[[Image:RearrangeRule.png|center]]
+{{Go|up=ReNamer:Rules|prev=ReNamer:Rules:Replace|next=ReNamer:Rules:Extension}}
-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.
+== Rearrange rule  ==
-*You can also add your own text, or use 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:
@@ Line 8: / Line 14: @@
 {| class="wikitable"
 |-
-! Parameter:
+! Parameter
-! How to use:
+! Description
 |-
 | Split using
@@ Line 15: / Line 21: @@
 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.
-{| class="wikitable"
 |-
-! Option:
+| [[Image:PlusButton.png]]
-! 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).
+*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.
-*The delimiter can be a single character or a string.
-*The chopped parts do <u>''not''</u> 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 &#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).
 |-
-| 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 '''n'''-th character and all characters beyond that in a separate piece.
+|-
-*Spaces, numbers and symbols are treated like normal characters.
+| Skip extension
-*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.
-*The chopped parts are numbered from left, as $1, $2, $3, etc.
-|}
 |-
@@ Line 51: / Line 51: @@
 *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.)
-|-
-| [[Image:PlusButton.png]]
-| 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
-|
-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.
-|-
-| [[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.
 |}
-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:
-# '''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.
 {| class="wikitable"
-! From:
-! To:
 |-
-| King, Stephen
+! Option
-| Stephen King
+! Description
 |-
-| Cook, Robin
+| Delimiters
-| Robin Cook
+|
-|-
+Chop the name where the delimiter occurs.
-| Pride and Prejudice, The
-| The Pride and Prejudice
-|}
-'''Settings:'''
+*The delimiter can be a single character or a string.
+*The chopped parts do <u>''not''</u> contain the delimiters (they are omitted totally)
-Delimiter: ", " (without the quotes)
+*Spaces, numbers and symbols are treated like normal characters.
+*Several delimiters can be used at a time. Use the {{pipe}} character to separate them.
-New Order: $2 $1
+*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.
-=== Example 2  ===
+*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.
-'''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"
-! From:
-! To:
 |-
-| Words sample 1234 07-07-07
+| Positions
-| 1234 Words sample 07-07-07
+|
-|}
+Chop the name at the indicated position (the position count begins with 1).
-'''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="wikitable"
-! From:
-! To:
 |-
-| 01 - Afilename.zip
+| Exact pattern of delimiters
-| Afilename.zip
+|
-|-
+Chop the name using the exact pattern (sequence) of the delimiters.
-| 002 - Bfilename.zip
-| Bfilename.zip
-|-
-| 0003 - Cfilename.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="wikitable"
-! From:
-! To:
-|-
-| 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="wikitable"
-! From:
-! To:
-|-
-| Ring ring_ABBA.mp3
-| ABBA - Ring Ring.mp3
-|-
-| Material girl_Madonna.mp3
-| Madonna - Material girl mp3
-|}
-'''Settings:'''
-Delimiter: "_" (without the quotes)
-New Order: $2 - $1
-=== Example 6  ===
-'''Task:''' Move the numbers to the beginning.
-{| class="wikitable"
-! From:
-! To:
-|-
-| DSC_0001-1.jpg
-| 1-DSC_0001.jpg
-|-
-| DSC_0001-2.jpg
-| 2-DSC_0001.jpg
-|-
-| DSC_0001-10.jpg
-| 10-DSC_0001.jpg
-|}
-'''Settings:'''
-Delimiter: "-" (without the quotes)
-New Order: $2-$1
-=== Example 7  ===
-'''Task:''' Insert "sent_" before the last 3 digits.
-{| class="wikitable"
-! From:
-! To:
-|-
-| family_001.jpg
-| family_sent_001.jpg
-|-
-| work_023.jpg
-| work_sent_023.jpg
-|-
-| friend_098.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).
+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.
-{| class="wikitable"
-! From:
-! To:
-|-
-| Sting - All This Time.mp3
-| All This Time.mp3
 |}
-'''Settings:'''
+== Examples ==
-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="wikitable"
-! From:
-! To:
-|-
-| 08. Madonna - Like A Prayer.wma
-|rowspan="3"| Madonna - Like A Prayer.wma
-|-
-| 08.-Madonna - Like A Prayer.wma
-|-
-| 08 Madonna - Like A Prayer.wma
-|}
-'''Settings:'''
-Delimiter: "Madonna" (without the quotes)
-New Order: Madonna$2
-'''Remarks: '''
-We chose the string "Madonna" 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 "Madonna" string from the token $2 because it is the delimiter. Therefore, we have to manually add that missing string "Madonna" to $2, to restore the names.
-=== Example 10 ===
-'''Task:''' Move the number to front, and remove the square brackets.
-{| class="wikitable"
-! From:
-! To:
-|-
-| Name XXX [0001].jpg
-| 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 ===
-'''Task:''' Add composer name and duration to an mp3 file, as prefix and suffix, respectively.
-{| class="wikitable"
-! From:
-! To:
-|-
-| Eine kleine Nachtmusik.mp3
-| Mozart - Eine kleine Nachtmusik (6.37).mp3
-|-
-| Don Giovanni.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
-|}
-<br>
-'''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>
-|}
-<br>
-'''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:
-. '''Replace''' Rule
-Find: "." (without the quotes)
-Replace: "#" (without the quotes)
-(this is a temporary change; which will be eliminated in the second step)
-. '''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]]