NAME

       fapg - Fast Audio Playlist Generator

SYNOPSIS

       fapg [ options ] /path/to/mp3/dir1 [ /path/to/mp3/dir2 ... ]

DESCRIPTION

       fapg  is  a  tool to generate list of audio files (Wav, MP2, MP3, Ogg, etc) in various 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.

       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.

OPTIONS

       -b|--backslash
              Replace the '/' with '\' in Unix path.

       -d|--debug
              Display useful messages if the program fails ;)

       -f|--format=m3u|pls|xspf|html|rss|pla|txx
              Choose which format of playlist you want to generate (default is m3u).

       -g|--genre=#:#:...
              Choose which genres (numerical values only) will be included in the generated playlist (default is
              all).

       -n|--nohardlink
              Avoid to parse twice the files because of hardlinks.

       -o|--output=/path/to/file.m3u
              Choose the name of the playlist file to generate (default  behavior  is  to  display  on  standard
              output).

       -p|--prefix=/the/prefix
              Replace the Unix path with another string (useful to give a Samba path for example).

       -r|--recursive
              Recursively read the subdirectories.

       -w|--windows
              Replace all Unix characters with Windows characters.

       -x|--exclude=#:#:...
              Choose which genres (numerical values only) will be excluded in the generated playlist (default is
              none).

       -c|--command=<intern|...>
              External binary or script that produces additional fields for RSS feeds (slow).

       -s|--stdin
              Read filenames and/or directories from standard input instead of command line.

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  \\server\mp3  : cd /samba/mp3 && fapg --backslash --output=/samba/mp3/list.m3u
       --prefix='\\server\mp3\' --recursive --windows ./

       An HTML playlist for an album: 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 fapg --genre=32:105 --genre=106:104:103 /path/to/all/music

       Generate  a podcasting XML file using an external program rss.sh to generate a detailed description: 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:   fapg   -f   pla   -o
       /path/to/playlist.pla /path/to/all/music

       if  command  starts  with  intern the build-in description (Author,Title,Link) is generated.  Please note
       that in all given directories ( and in ...basedir/xml ) files called podcast.jpg  are  referenced.   Many
       header fields are set to defaults using environment variables like LOGNAME or LANG.

AUTHOR

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

Linux                                             JANUARY 2007                                           FAPG(1)