audio_rename 0.9708

audio_rename can rename an audio file via information got via MP3::Tag.

SYNOPSIS

audio_rename -csR -@p "@a/@l/@02n_@t" .

renames all the audio files in this directory and its subdirectories into a 3-level directory structure given by Artist_Name/Album/Filename, with the basename of Filename being the 2-digit track number separated from the title by underscore.

audio_rename -KD *.wav

Reports how it would rename the *.wav files in this directory according to the default -p rule, but without protectiing "funny" characters. Will not do actual renaming.

audio_rename -sc *.mp3

Rename the *.mp3 files in this directory according to the default -p rule, translating cyrillic characters into Latin "equivalents", shortening the names of long components, and protecting "funny" characters.

audio_rename -p %a/%{d0}/%B -G */*.mp3

Assuming one-level subdirectory structure dir/filename.ext, finds files with extension .mp3, and "sorts" them into a two-level subdirectory structure; toplevel directory is based on the "artist" field, the remaing level is preserved.

audio_rename -p %a/%{d0}/%B -R .

Likewise, but does not suppose any particular depth of the current directory structure; only the filename and the most internal directory name are preserved.

audio_rename -p %a/%N -R .

Likewise, but all directory names (inside the current directory) are preserved.

The script takes a list of files (or, with -R option, directories) and renames the given files (or audio files in the directories) according to the rules specified through the command line options. File extensions are preserved (by default).

Some "companion" files (i.e., file with the same basename, and with an extension from a certain list) may be renamed together with audio files. A lot of care is taken to make the resulting file names as portable as possible: e.g., "funny" characters in file names are dumbed down (unless requested otherwise), long filename components may be shortened to certain limits.

A care is taken so that renaming will not overwrite existing files; however, on OSes which allow rename() to overwrite files, race conditions can ruin the best intentions. E.g., do not run several "overlapping" rename procedures simultaneously!