1FAPG(1) User Manuals FAPG(1)
2
6 fapg - Fast Audio Playlist Generator
7
10 fapg [ options ] /path/to/mp3/dir1 [ /path/to/mp3/dir2 ... ]
11
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 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
27 -b|--backslash
28 Replace the '/' with '\' in Unix path.
29 -d|--debug
31 Display useful messages if the program fails ;)
32 -f|--format=m3u|pls|xspf|html|rss|pla|txx
34 Choose which format of playlist you want to generate (default is
35 m3u).
36 -g|--genre=#:#:...
38 Choose which genres (numerical values only) will be included in
39 the generated playlist (default is all).
40 -n|--nohardlink
42 Avoid to parse twice the files because of hardlinks.
43 -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 -p|--prefix=/the/prefix
49 Replace the Unix path with another string (useful to give a
50 Samba path for example).
51 -r|--recursive
53 Recursively read the subdirectories.
54 -w|--windows
56 Replace all Unix characters with Windows characters.
57 -x|--exclude=#:#:...
59 Choose which genres (numerical values only) will be excluded in
60 the generated playlist (default is none).
61 -c|--command=<intern|...>
63 External binary or script that produces additional fields for
64 RSS feeds (slow).
65 -s|--stdin
67 Read filenames and/or directories from standard input instead of
68 command line.
69
72 Generate a PLS playlist for an album: fapg --format=pls --out‐
73 put=~/path/to/album/list.pls ~/path/to/album
74 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 An HTML playlist for an album: fapg --output=fapg.html ~/path/to/album
83 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 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 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 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
104 Antoine Jacquet <royale@zerezo.com>, http://royale.zerezo.com/fapg/.
105 Manpage by Thomas Kappler <thomas.kappler@stud.uni-karlsruhe.de>.
106Linux JANUARY 2007 FAPG(1)