Difference between revisions of "ReNamer:Rules:Serialize"

From den4b Wiki
Jump to navigation Jump to search
(→‎Numbering system: Music notes system added)
 
(13 intermediate revisions by 4 users not shown)
Line 1: Line 1:
−
{{Template:Cleanup}}
+
{{Go|up=ReNamer:Rules|prev=ReNamer:Rules:Case|next=ReNamer:Rules:Randomize}}
  
 
== Serialize Rule ==
 
== Serialize Rule ==
−
[[Image:SerializeRule.png]]
 
  
−
This rule works on a set of files, and inserts a incremental numeric series or a random sequences of digits in the names of those file names.  
+
[[Image:SerializeRule.png|center]]
  
−
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 list becomes important. Check the order of the files in the list before applying this rule.
+
This rule works on a set of files, and inserts incremental numeric series of digits in the names of those filenames.
 +
 
 +
The files listed in the pane can be numbered in increasing or decreasing order, with various steps, repeat and reset configuration. The position of each file in the '''Files''' pane becomes important, so check the order of the files in the list before applying this rule.
  
 
Examples:
 
Examples:
Line 15: Line 16:
 
The parameters are as follows:
 
The parameters are as follows:
  
−
{| class="prettytable"
+
{| class="wikitable"
 
! Parameter
 
! Parameter
−
! Details
+
! Description
  
 
|-
 
|-
−
| Incremental
 
−
| Inserts serialized numbers in the names of the files placed in the Files pane of ReNamer.
 
−
 
−
{| class="prettytable"
 
 
| Index start
 
| Index start
−
| Starting number. If the folder already has some files with serialized numbers, start with the next number.
+
| Starting number. For example, if the destination folder already has some files with serialized numbers, you can start with the next number.
  
 
|-
 
|-
 
| Step
 
| Step
−
| Usually 1, but you may like to enter a higher number here if files with intermediate numbers are expected later.  
+
| Increment the index by this value after each processed file. Usually 1, but you may like to enter a higher number here if files with intermediate numbers are expected later. Also, negative numbers can be used to make decremental indexes, e.g. -1, -2, -3, etc.
 +
 
 +
|-
 +
| Repeat
 +
| How many times to repeat (reuse) the same index before incrementing it.
 +
 
 +
|-
 +
| Reset every
 +
| Reset index to the initial value after processing this many files.
  
 
|-
 
|-
 
| Reset if folder changes
 
| Reset if folder changes
−
| Since ReNamer can work on files collected from multiple folders, this control allows you to reset the number for each of those folders. The effect is as if you are repeating the same commend for each of the folders separately.
+
| 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 command for each of the folders separately.
 +
 
 +
|-
 +
| Reset if file name changes
 +
| Reset the counter when the file name changes. This option is especially useful for fixing (serializing) duplicated file names, when the files with the same name are grouped together, which can be achieved by sorting the files by name or path.
 +
 
 +
|-
 +
| Pad with zeros to length
 +
| Pad the inserted number 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 (see below for individual options).
  
 
|}
 
|}
 +
 +
=== Insert location ===
 +
 +
Options for where to insert the number:
 +
 +
{| class="wikitable"
 +
! Option
 +
! Description
  
 
|-
 
|-
−
| Random
+
| Prefix
−
| Inserts a random number in the file name.
+
| Before the original filename
  
−
{| class="prettytable"
+
|-
−
| Length
+
| Suffix
−
| Specify how many digits your random number should have.
+
| After the original filename
  
−
* 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).
+
|-
 +
| Position
 +
| Insert the number at the specified position.
  
−
* Note that the numbers are NOT padded by default
+
|-
 +
| Replace current name
 +
| Inserted number replaces the entire filename.
  
 
|-
 
|-
−
| Unique if possible
+
| Skip extension
−
| Normally, random numbers can repeat themselves. If this option is selected, ReNamer will try to use unique numbers.  
+
| Exclude file extension when calculating the position for insertion.
  
 
|}
 
|}
 +
 +
=== Numbering system ===
 +
 +
A choice of the '''Numbering system''' dictates which symbols and enumeration technique are used for the serialization.
 +
 +
{| class="wikitable"
 +
! Number system
 +
! Description / Examples
 +
 +
|-
 +
| Decimal digits
 +
| Index starts at 0 with repeat 1 and step 1:<br/>
 +
<tt>0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, …</tt>
 +
 +
|-
 +
| English letters
 +
| Index starts at 1 with repeat 1 and step 1:<br/>
 +
<tt>a, b, c, …, x, y, z, ba, bb, bc, …, bx, by, bz, ca, cb, cc, …, zx, zy, zz, baa, bab, bac, …</tt>
 +
 +
Index starts at 1 with repeat 1 and step 1, pad to length 3:<br/>
 +
<tt>aaa, aab, aac, …, aax, aay, aaz, aba, abb, abc, …, abx, aby, abz, aca, acb, acc, …, azx, azy, azz, baa, bab, bac, …</tt>
  
 
|-
 
|-
−
| Pad with zeros to reach length
+
| Roman numerals
−
| ReNamer will pad the remaining places with leading zeros. For example, a random number 457 becomes 000457 if the padded to 6 digits, and 0457 if padded to 4 digits.
+
| Index starts at 1 with repeat 1 and step 1:<br/>
 +
<tt>I, II, III, IV, V, VI, VII, VIII, IX, X, XI, XII, …</tt>
  
 
|-
 
|-
−
| Insert where
+
| Music notes
−
| Specify where to insert the number.  
+
| Index starts at 1 with repeat 1 and step 1:<br/>
 +
<tt>C0, C#0, D0, D#0, E0, F0, F#0, G0, G#0, A0, A#0, B0, C1, C#1, …</tt><br/>
 +
''Added in ReNamer 7.3.0.2 Beta.''
  
−
{| class="prettytable"
+
|-
−
| Prefix
+
| Simplified Chinese
−
| Before the original file name
+
| Index starts at 1 with repeat 1 and step 1:<br/>
 +
<tt>一, 二, 三, 四, 五, 六, 七, 八, 九, 一十, 一十一, 一十二, 一十三, …</tt>
  
 
|-
 
|-
−
| Suffix
+
| Custom alphabetic
−
| After the original file name (just before the dot)
+
| Index starts at 1 with repeat 1 and step 1, using "ABC" symbols:<br/>
 +
<tt>A, B, C, BA, BB, BC, CA, CB, CC, BAA, BAB, BAC, BBA, …</tt>
  
−
* If the '''skip extension '''option is selected, the specified text will be inserted ''after'' the extension.
+
Index starts at 1 with repeat 1 and step 1, using "01" symbols:<br/>
 +
<tt>0, 1, 10, 11, 100, 101, 110, 111, 1000, 1001, 1010, 1011, 1100, …</tt>
  
 
|-
 
|-
−
| Position
+
| Custom numeric
−
| Insert the ''padded'' number at the specified position.
+
| Index starts at 0 with repeat 1 and step 1, using "ABC" symbols:<br/>
 +
<tt>A, B, C, BA, BB, BC, CA, CB, CC, BAA, BAB, BAC, BBA, …</tt>
 +
 
 +
Index starts at 0 with repeat 1 and step 1, using "01" symbols:<br/>
 +
<tt>0, 1, 10, 11, 100, 101, 110, 111, 1000, 1001, 1010, 1011, 1100, …</tt>
  
 
|}
 
|}
−
Note that if the "''pad with zeros''" option (above) is selected, the ''padded '' number is inserted.
 
  
−
|}
+
[[Category:ReNamer]]

Latest revision as of 03:00, 1 April 2022

Serialize Rule

SerializeRule.png

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

The files listed in the pane can be numbered in increasing or decreasing order, with various steps, repeat and reset configuration. The position of each file in the Files pane becomes important, so check the order of the files in the list before applying this rule.

Examples:

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

The parameters are as follows:

Parameter Description
Index start Starting number. For example, if the destination folder already has some files with serialized numbers, you can start with the next number.
Step Increment the index by this value after each processed file. Usually 1, but you may like to enter a higher number here if files with intermediate numbers are expected later. Also, negative numbers can be used to make decremental indexes, e.g. -1, -2, -3, etc.
Repeat How many times to repeat (reuse) the same index before incrementing it.
Reset every Reset index to the initial value after processing this many files.
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 command for each of the folders separately.
Reset if file name changes Reset the counter when the file name changes. This option is especially useful for fixing (serializing) duplicated file names, when the files with the same name are grouped together, which can be achieved by sorting the files by name or path.
Pad with zeros to length Pad the inserted number 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 (see below for individual options).

Insert location

Options for where to insert the number:

Option Description
Prefix Before the original filename
Suffix After the original filename
Position Insert the number at the specified position.
Replace current name Inserted number replaces the entire filename.
Skip extension Exclude file extension when calculating the position for insertion.

Numbering system

A choice of the Numbering system dictates which symbols and enumeration technique are used for the serialization.

Number system Description / Examples
Decimal digits Index starts at 0 with repeat 1 and step 1:

0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, …

English letters Index starts at 1 with repeat 1 and step 1:

a, b, c, …, x, y, z, ba, bb, bc, …, bx, by, bz, ca, cb, cc, …, zx, zy, zz, baa, bab, bac, …

Index starts at 1 with repeat 1 and step 1, pad to length 3:
aaa, aab, aac, …, aax, aay, aaz, aba, abb, abc, …, abx, aby, abz, aca, acb, acc, …, azx, azy, azz, baa, bab, bac, …

Roman numerals Index starts at 1 with repeat 1 and step 1:

I, II, III, IV, V, VI, VII, VIII, IX, X, XI, XII, …

Music notes Index starts at 1 with repeat 1 and step 1:

C0, C#0, D0, D#0, E0, F0, F#0, G0, G#0, A0, A#0, B0, C1, C#1, …
Added in ReNamer 7.3.0.2 Beta.

Simplified Chinese Index starts at 1 with repeat 1 and step 1:

一, 二, 三, 四, 五, 六, 七, 八, 九, 一十, 一十一, 一十二, 一十三, …

Custom alphabetic Index starts at 1 with repeat 1 and step 1, using "ABC" symbols:

A, B, C, BA, BB, BC, CA, CB, CC, BAA, BAB, BAC, BBA, …

Index starts at 1 with repeat 1 and step 1, using "01" symbols:
0, 1, 10, 11, 100, 101, 110, 111, 1000, 1001, 1010, 1011, 1100, …

Custom numeric Index starts at 0 with repeat 1 and step 1, using "ABC" symbols:

A, B, C, BA, BB, BC, CA, CB, CC, BAA, BAB, BAC, BBA, …

Index starts at 0 with repeat 1 and step 1, using "01" symbols:
0, 1, 10, 11, 100, 101, 110, 111, 1000, 1001, 1010, 1011, 1100, …

Retrieved from "http://www.den4b.com/w/index.php?title=ReNamer:Rules:Serialize&oldid=3481"