Fast Audio Playlist Generator

Download the last version of FAPG : fapg-0.44.tar.gz

New features : see the changes

FAPG means Fast Audio Playlist Generator.

It is a tool to generate list of audio files (Wav, MP3, Ogg, etc) in various formats (M3U, PLS, HTML, etc).
It is very usefull if you have a large amount of audio files and you want to quickly and frequently build a playlist.

It is coded in C to be as fast as possible, and does not use any specific audio library (like ID3Lib).
This allow you to deploy it faster and easier, and to have better performances since the less informations are loaded.
In the other hand, this tool is not (yet) compatible with all the known formats.

Todo and wishlist : Wiki
Forum : phpBB

Usage :

fapg [-b|--backslash] [-d|--debug] [-f|--format=m3u|pls|html] [-n|--nohardlink] [-o|--output=/path/to/file.m3u] [-p|--prefix=/the/prefix] [-r|--recursive] [-w|--windows] [-g|--genre=#:#:...|-x|--exclude=#:#:...] /path/to/mp3/dir1 [/path/to/mp3/dir2 ...]

• backslash : replace the '/' with '\' in Unix path.
• debug : display useful messages if the program fails ;)
• format : choose which format of playlist you want to generate (default is m3u).
• output : choose the name of the playlist file to generate (default behavior is to display on standart output).
• prefix : replace the Unix path with another string (useful to give a Samba path for example).
• recursive : recursively read the subdirectories.
• windows : replace all Unix characters with Windows characters...
• nohardlink : avoid to parse and add files that are hardlinked...
• genre : choose which genres (numerical values only) will be included (default is all)...
• exclude : choose which genres (numerical values only) will be excluded (default is none)...

Examples :

• Generate a PLS playlist for an album :
  fapg --format=pls --output=~/path/to/album/list.pls ~/path/to/album
  
  
• You have a file server using Samba which shares a large amount of audio files for Windows powered computers using Winamp.
  The directory on the server containing the files is "/samba/mp3" and is visible on the Windows network as "\\serveur\mp3" :
  fapg --backslash --output=/samba/mp3/list.m3u --prefix='\\server\mp3\' --recursive --windows /samba/mp3
  
  
• An HTML playlist for an album :
  fapg --output=fapg.html ~/path/to/album
  Here is the result : fapg.html

Other sites :

• YAAPG : a Perl tool to generate playlists.
• id3lib : an ID3v1 & ID3v2 parsing library.
• MP3 header & ID3 documentations.
• Ogg documentations.