.\" Process this file with
.\" groff -man -Tascii foo.1
.\"
-.TH FAPG 1 "APRIL 2004" Linux "User Manuals"
+.TH FAPG 1 "JANUARY 2007" Linux "User Manuals"
.SH NAME
fapg \- Fast Audio Playlist Generator
.SH DESCRIPTION
.B fapg
is a tool to generate list of audio files (Wav, MP2, MP3, Ogg, etc) in various
-formats (M3U, PLS, HTML, RSS, etc). It is very useful if you have a large amount
+formats (M3U, PLS, XSPF, HTML, RSS, 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
.SH OPTIONS
.IP -b|--backslash
-Replace the '/' with '\' in Unix path.
+Replace the '/' with '\\' in Unix path.
.IP -d|--debug
Display useful messages if the program fails ;)
-.IP -f|--format=m3u|pls|html|rss
+.IP -f|--format=m3u|pls|xspf|html|rss|pla|txx
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).
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).
+.IP -c|--command=<intern|...>
+External binary or script that produces additional fields for RSS feeds (slow).
+.IP -s|--stdin
+Read filenames and/or directories from standard input instead of command line.
.SH EXAMPLES
Generate a PLS playlist for an album:
Generate a podcasting XML file using an external program rss.sh to generate a detailed description:
.B fapg --output=dir.xml -f rss -c /usr/local/bin/rss.sh -r --prefix=http://thisserver/basedir path/to/mp3
+
+Generate a playlist that will work on a Sansa e200 series MP3 player:
+.B fapg -f pla -o /path/to/playlist.pla /path/to/all/music
+
if command starts with
.I intern
the build-in description (Author,Title,Link) is generated.