GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  FAPG (1)

NAME

fapg - Fast Audio Playlist Generator

CONTENTS

Synopsis
Description
Options
Examples
Author

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 ’#146; 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\#146; --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>.
Search for    or go to Top of page |  Section 1 |  Main Index


Linux FAPG (1) JANUARY 2007

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.