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