fapg

FAPG(1)                          User Manuals                          FAPG(1)



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)