Home
Using the -f option, a filename format can be specified.
The -x option is an equivalent for the extension.
Use the --no-ext option to simply remove the extension.
To specify the number of dots in the extension (2 for .tar.gz) use the --dots N option.
In the format, several characters have a special meaning.
'$' the original case '&' uppercase '%' lowercase '*' camelcase absrenamer -f"*" heLLo_WorlD.TxT #=> Hello_World.TxT absrenamer -x"%" heLLo_WorlD.TxT #=> heLLo_WorlD.txt absrenamer -f"*" -x"%" heLLo_WorlD.TxT #=> Hello_World.txt /!\ Be careful to use simple quotes when using the $ symbol /!\ absrenamer -f'$_Yeah' heLLo_WorlD.TxT #=> heLLo_WorlD_Yeah.TxT
Exept for the basic onces, any formatter is of the form [<modifier>...].
The modifier is one of the basics which is used to format the value of the formatter. Of course, it’s optional.
absrenamer -f'[1;5]' hello_word.txt #=> hello.txt absrenamer -f'[&1;5]' hello_word.txt #=> HELLO.txt
It is possible to use only a part of the original filename or extension.
[2] the second character of the original filename [1;2] two characters starting at position 1 (first character) of the original filename [1-2] characters from position 1 to position 2 of the original filename [2-] all characteres of the original filename starting at position 2 absrenamer -f"[2]" hello_world.txt #=> e.txt absrenamer -f"[2;4]" hello_world.txt #=> ello.txt absrenamer -f"[2-4]" hello_world.txt #=> ell.txt absrenamer -f"[4-]" hello_world.txt #=> lo_world.txt absrenamer -f"[1;4].[7-]" hello_world.txt #=> hell.world.txt
Using #, counters can be added in the file name.
The amount of figures depends on the amount of # used.
absrenamer -f"photo_#" img123456.jpg img123465.jpg img123477.jpg img123478.jpg ... #=> photo_1.jpg, photo_2.jpg, photo_3.jpg, ..., photo_10.jpg, ..., photo_100.jpg absrenamer -f"photo_##" img123456.jpg img123465.jpg img123477.jpg img123478.jpg ... #=> photo_01.jpg, photo_02.jpg, photo_03.jpg, ..., photo_10.jpg, ..., photo_100.jpg
A start number and a step can be specified with {start;step}.
absrenamer -f"photo_#{5}" img123456.jpg img123465.jpg img123477.jpg img123478.jpg ...
#=> photo_5.jpg, photo_6.jpg, photo_7.jpg, ..., photo_10.jpg, ..., photo_100.jpg
absrenamer -f"photo_##{5;2}" img123456.jpg img123465.jpg img123477.jpg img123478.jpg ...
#=> photo_05.jpg, photo_07.jpg, photo_09.jpg, photo_11.jpg, ..., photo_101.jpg
The -l option will simulate the modifications and simply print them. No file will be modified.
- The configuration files
- Modules and Plugins development