Man Linux: Main Page and Category List

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>.