1   Name

mkplaylist.py -- creates playlists from directory trees.

2   Synopsis

mkplaylist.py [-h|--help|--version]
mkplaylist.py [options] directory

The directory is the one where the scripts starts to search for media files.

3   Description

The script scans the given directory for media files with known file name extensions and writes the names into a playlist file in M3U format. This very simple format is used or at least understood by the vast majority of media players on different platforms.

Symlinks to directories are not scanned to avoid running into cycles.

4   Requirements

The script requires Python version 2.3 or higher.

5   Commandline Options

--version	show program's version number and exit
-h, --help	show this help message and exit
-oOUTFILE, --output=OUTFILE
	Name of the output file or '-' for stdout

6   Examples

./mkplaylist.py -o playlist.m3u /data/music

Scan the directory /data/music and write all media files into a playlist named playlist.m3u.

7   History

0.1.1 : 2004-10-23

Fixed a minor(?) packaging problem. The archive content is now in an own subdirectory. Much more standard on Unices. :-)

0.1 : 2004-10-20

Initial release. Creates simple playlists in M3U format.

8   ToDo

• Support for meta data like length, title etc.,
• exclude files by name pattern (simple or even regular expressions),
• list known file name extensions in --help output,
• sort the list before writing,
• add a switch for shuffling the list,
• (x)html output,
• use logging module and add switches -v and --verbose,
• and add more playlist formats,
• take more than one directory at the command line and default to the current directory if no directory is given at all.

9   Bugs

None known yet. If you find some please send me a mail.

10   Copyright

Copyright © 2004 Marc 'BlackJack' Rintsch <marc@rintsch.de>

This is free software; see the source for copying conditions. There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.