NAME

mms-m3umaker - generate MP3 playlists

SYNOPSIS

How to get help: If one of the --help options is specified once a short overview will be printed; if specified twice you will get detailed information about command line options. --man gives you the whole manual.

mms-m3umaker [ -b, --backup ] [ -f, --filename STRING ] [ -r, --recurse ] [ --sweep ] [ -v, --verbose STRING ] [ -x, --extended ] DIRECTORY [...]

mms-m3umaker -?, -h, --help | --man

mms-m3umaker -V, --version

DESCRIPTION

mms-m3umaker is part of the `mp3ManagementSuite' which is a collection of programs that help maintaining music collections.

mms-m3umaker will search for .mp3 files within the given directories and generate a playlist file listing them lexically ordered. Thus you can easily play them with your mp3 player software. This program has helpful options such as creating playlists for each folder of a directory tree. Moreover you can keep your playlists up to date by running this tool whenever you think it's time to refresh after some changes.

OPTIONS

This paragraph describes the possible options that can be used to modify this program's behaviour. If a long option name requires an argument then the short form does so, too. Long names can be abbreviated but must stay unique. Short options can be bundled even if they have arguments; thus `-a12b34c' is equivalent to `-a 12 -b 34 -c'. To avoid ambiguity you can use ` -- ' to seperate the options from the list of directories.

-?, -h, --help

Prints the possible options and exits.

--man

Prints the whole manual and exits.

-b, --backup

Never erase or overwrite a playlist file. If a directory already contains a playlist that has the same name like the one to be created a backup will be made. Playlists with other names are not touched at all. NOTE: This implicitly disables the --sweep option.

-f, --filename STRING

Sets a custom filename for the playlist to be generated. DEFAULT: 00--playlist.m3u

-r, --recurse

Enables recursive processing of subdirectories for each of the given directory arguments.

--sweep

Enables the `sweep mode' which erases already existing playlists, i.e. playlists with other filenames that would not be overwritten and could therefore cause irritation afterwards.

-v, --verbose STRING

Adjusts the level of output verbosity. There are five categories, ordered by severity. This setting means that all messages up to the given severity level will be reported; less severe messages will be suppressed.

STRING defaults to INFO which means that all messages from the categories FATAL, ERROR, WARN and INFO will be reported. Possible values for STRING are:

  FATAL
  ERROR
  WARN
  INFO
  MORE

-V, --version

Prints the program version and exits.

-x, --extended

Enables generation of extended playlist files. Some players will read the extended info (length in seconds, artist, title) from the playlist rather than evaluating the file itself and hereby gain performance.

COPYRIGHT AND LICENCE

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA