1 .\" Process this file with
2 .\" groff -man -Tascii foo.1
4 .TH FAPG 1 "APRIL 2004" Linux "User Manuals"
7 fapg \- Fast Audio Playlist Generator
20 is a tool to generate list of audio files (Wav, MP2, MP3, Ogg, etc) in various
21 formats (M3U, PLS, HTML, etc). It is very useful if you have a large amount
22 of audio files and you want to quickly and frequently build a playlist.
24 It is coded in C to be as fast as possible, and does not use any specific
25 audio library (like ID3Lib). This allow you to deploy it faster and easier,
26 and to have better performances since the less informations are loaded.
27 On the other hand, this tool is not (yet) compatible with all the known
32 Replace the '/' with '\' in Unix path.
34 Display useful messages if the program fails ;)
35 .IP -f|--format=m3u|pls|html
36 Choose which format of playlist you want to generate (default is m3u).
37 .IP -g|--genre=#:#:...
38 Choose which genres (numerical values only) will be included in the generated playlist (default is all).
40 Avoid to parse twice the files because of hardlinks.
41 .IP -o|--output=/path/to/file.m3u
42 Choose the name of the playlist file to generate (default behavior is
43 to display on standard output).
44 .IP -p|--prefix=/the/prefix
45 Replace the Unix path with another string (useful to give a Samba path
48 Recursively read the subdirectories.
50 Replace all Unix characters with Windows characters.
51 .IP -x|--exclude=#:#:...
52 Choose which genres (numerical values only) will be excluded in the generated playlist (default is none).
55 Generate a PLS playlist for an album:
56 .B fapg --format=pls --output=~/path/to/album/list.pls ~/path/to/album
58 You have a file server using Samba which shares a large amount of
59 audio files for Windows powered computers using Winamp. The directory
60 on the server containing the files is
62 and is visible on the Windows network as
63 .I \\\\\\\\server\\\\mp3
65 .B fapg --backslash --output=/samba/mp3/list.m3u --prefix='\\\\\\\\server\\\\mp3\\\\' --recursive --windows /samba/mp3
67 An HTML playlist for an album:
68 .B fapg --output=fapg.html ~/path/to/album
70 A playlist that contains all your classical tracks may receive the genres to include (or exclude) in one or multiple portions
71 .B fapg --genre=32:105 --genre=106:104:103 /path/to/all/music
75 Antoine Jacquet <royale@zerezo.com>, http://royale.zerezo.com/fapg/.
76 Manpage by Thomas Kappler <thomas.kappler@stud.uni-karlsruhe.de>.