1FAPG(1)                          User Manuals                          FAPG(1)
2
3
4

NAME

6       fapg - Fast Audio Playlist Generator
7
8

SYNOPSIS

10       fapg [ options ] /path/to/mp3/dir1 [ /path/to/mp3/dir2 ... ]
11
12

DESCRIPTION

14       fapg  is  a  tool  to generate list of audio files (Wav, MP2, MP3, Ogg,
15       etc) in various formats (M3U, PLS, XSPF, HTML, RSS, etc).  It  is  very
16       useful  if  you  have  a  large  amount  of audio files and you want to
17       quickly and frequently build a playlist.
18
19       It is coded in C to be as fast as possible, and does not use  any  spe‐
20       cific  audio library (like ID3Lib).  This allow you to deploy it faster
21       and easier, and to have better performances since the less informations
22       are  loaded.  On the other hand, this tool is not (yet) compatible with
23       all the known formats.
24
25

OPTIONS

27       -b|--backslash
28              Replace the '/' with '\' in Unix path.
29
30       -d|--debug
31              Display useful messages if the program fails ;)
32
33       -f|--format=m3u|pls|xspf|html|rss|pla|txx
34              Choose which format of playlist you want to generate (default is
35              m3u).
36
37       -g|--genre=#:#:...
38              Choose  which genres (numerical values only) will be included in
39              the generated playlist (default is all).
40
41       -n|--nohardlink
42              Avoid to parse twice the files because of hardlinks.
43
44       -o|--output=/path/to/file.m3u
45              Choose the name of the playlist file to generate (default behav‐
46              ior is to display on standard output).
47
48       -p|--prefix=/the/prefix
49              Replace  the  Unix  path  with  another string (useful to give a
50              Samba path for example).
51
52       -r|--recursive
53              Recursively read the subdirectories.
54
55       -w|--windows
56              Replace all Unix characters with Windows characters.
57
58       -x|--exclude=#:#:...
59              Choose which genres (numerical values only) will be excluded  in
60              the generated playlist (default is none).
61
62       -c|--command=<intern|...>
63              External  binary  or  script that produces additional fields for
64              RSS feeds (slow).
65
66       -s|--stdin
67              Read filenames and/or directories from standard input instead of
68              command line.
69
70

EXAMPLES

72       Generate  a  PLS  playlist  for  an  album:  fapg  --format=pls  --out‐
73       put=~/path/to/album/list.pls ~/path/to/album
74
75       You have a file server using Samba which shares a large amount of audio
76       files  for Windows powered computers using Winamp. The directory on the
77       server containing the files is /samba/mp3 and is visible on the Windows
78       network  as  \\server\mp3  :  cd  /samba/mp3 && fapg --backslash --out‐
79       put=/samba/mp3/list.m3u --prefix='\\server\mp3\' --recursive  --windows
80       ./
81
82       An HTML playlist for an album: fapg --output=fapg.html ~/path/to/album
83
84       A playlist that contains all your classical tracks may receive the gen‐
85       res  to  include  (or  exclude)  in  one  or  multiple  portions   fapg
86       --genre=32:105 --genre=106:104:103 /path/to/all/music
87
88       Generate a podcasting XML file using an external program rss.sh to gen‐
89       erate  a  detailed  description:  fapg  --output=dir.xml  -f   rss   -c
90       /usr/local/bin/rss.sh -r --prefix=http://thisserver/basedir path/to/mp3
91
92       Generate  a  playlist that will work on a Sansa e200 series MP3 player:
93       fapg -f pla -o /path/to/playlist.pla /path/to/all/music
94
95       if   command   starts   with   intern    the    build-in    description
96       (Author,Title,Link) is generated.  Please note that in all given direc‐
97       tories ( and in ...basedir/xml ) files called  podcast.jpg  are  refer‐
98       enced.   Many header fields are set to defaults using environment vari‐
99       ables like LOGNAME or LANG.
100
101
102

AUTHOR

104       Antoine  Jacquet  <royale@zerezo.com>,  http://royale.zerezo.com/fapg/.
105       Manpage by Thomas Kappler <thomas.kappler@stud.uni-karlsruhe.de>.
106
107
108
109Linux                            JANUARY 2007                          FAPG(1)
Impressum