MUSICMOVE

NAME

SYNOPSIS

DESCRIPTION

Allowed options:

--format arg

The file path format string. The syntax is a file path, but certain tokens are replaced with values from each file's metadata. `%a' for artist, `%b' for album, `%c' for comment, `%d' for disc number, `%e' for encoded by, `%g' for genre, `%l' for track total, `%n' for track number (zero-padded to two characters), `%o' for original artist, `%p' for composer, `%r' for copyright, `%t' for title, `%u' for URL, `%x' for disc total, `%y' for year, `%z' for album artist (falling back to artist if not set), or `%%' for a literal percent sign.

--format-script arg

Path to a file that contains ChaiScript code which can be used to move/rename files in different ways. Constant variables are provided for path, parent_dir, filename, and filename_stem. Tags may be accessed via the functions artist(), album(), comment(), disc_number(), encoded_by(), genre(), track_total(), track_number(), original_artist(), composer(), copyright(), title(), url(), disc_total(), year(), and album_artist(). The ChaiScript code must return the new file path to work. If the code returns tokens like `%a' etc, then they will be expanded as usual.

-s [ --simulate ]

Simulate renaming, i.e. don't commit any changes to disk. This is the default.

-f [ --for-real ]

Rename files for real; musicmove is safe by default, so you will need to use this switch to explicitly tell the program that you actually want it to rename files.

--path-conversion arg Approach for converting meta-data characters into

paths. `windows-ascii' converts to 7-bit ASCII and removes any characters not normally permitted on Microsoft Windows machines. `utf-8' uses the full expressivity of UTF-8 Unicode paths, assuming they are supported by your filesystem. `posix' is a restrictive but portable approach that permits only unaccented letters (of either case), numbers, dot, underscore, and hyphen. The default option is `windows-ascii'.

--exit-on-duplicate

Exit if we encounter two files that would be rewritten to the same path on disk (default is to skip any such duplicates).

-v [ --verbose ]

Print additional messages about what's going on.

--version

Display the version number and exit.

-h [ --help ]

Display this help screen.

REPORTING BUGS

musicmove home page: <http://musicmove.xsco.org>

Index

NAME

SYNOPSIS

DESCRIPTION

Allowed options:

REPORTING BUGS