.\" Process this file with
.\" groff -man -Tascii foo.1
.\"
.TH FAPG 1 "APRIL 2004" Linux "User Manuals"

.SH NAME
fapg \- Fast Audio Playlist Generator

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

.SH DESCRIPTION
.B fapg
is a tool to generate list of audio files (Wav, MP2, MP3, Ogg, etc) in various 
formats (M3U, PLS, HTML, etc).  It is very useful if you have a large amount 
of audio files and you want to quickly and frequently build a playlist.
.P
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.
On the other hand, this tool is not (yet) compatible with all the known 
formats.

.SH OPTIONS
.IP -b|--backslash
Replace the '/' with '\' in Unix path. 
.IP -d|--debug
Display useful messages if the program fails ;) 
.IP -f|--format=m3u|pls|html
Choose which format of playlist you want to generate (default is m3u). 
.IP -g|--genre=#:#:...
Choose which genres (numerical values only) will be included in the generated playlist (default is all). 
.IP -o|--output=/path/to/file.m3u
Choose the name of the playlist file to generate (default behavior is 
to display on standard output). 
.IP -p|--prefix=/the/prefix
Replace the Unix path with another string (useful to give a Samba path 
for example). 
.IP -r|--recursive
Recursively read the subdirectories. 
.IP -w|--windows
Replace all Unix characters with Windows characters. 
.IP -x|--exclude=#:#:...
Choose which genres (numerical values only) will be excluded in the generated playlist (default is none). 

.SH EXAMPLES
Generate a PLS playlist for an album:
.B 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 
.I /samba/mp3 
and is visible on the Windows network as 
.I \\\\\\\\server\\\\mp3
:
.B fapg --backslash --output=/samba/mp3/list.m3u --prefix='\\\\\\\\server\\\\mp3\\\\' --recursive --windows /samba/mp3
 
An HTML playlist for an album:
.B fapg --output=fapg.html ~/path/to/album

A playlist that contains all your classical tracks may receive the genres to include (or exclude) in one or multiple portions
.B fapg --genre=32:105 --genre=106:104:103 /path/to/all/music


.SH AUTHOR
Antoine Jacquet <royale@zerezo.com>, http://royale.zerezo.com/fapg/. 
Manpage by Thomas Kappler <thomas.kappler@stud.uni-karlsruhe.de>.