X-Git-Url: http://royale.zerezo.com/git/?p=FAPG;a=blobdiff_plain;f=fapg.1;h=6b575e7f35dfa437d85827d8e0399a22741323f2;hp=a9af76fa0b9697d0b256bf5fc15527dcb75466b1;hb=HEAD;hpb=ff081934d3f79e659ca14c93b147028b59880ee8 diff --git a/fapg.1 b/fapg.1 index a9af76f..6b575e7 100644 --- a/fapg.1 +++ b/fapg.1 @@ -1,7 +1,7 @@ .\" Process this file with .\" groff -man -Tascii foo.1 .\" -.TH FAPG 1 "APRIL 2004" Linux "User Manuals" +.TH FAPG 1 "JANUARY 2007" Linux "User Manuals" .SH NAME fapg \- Fast Audio Playlist Generator @@ -18,7 +18,7 @@ fapg \- Fast Audio Playlist Generator .SH DESCRIPTION .B fapg is a tool to generate list of audio files (Wav, MP2, MP3, Ogg, etc) in various -formats (M3U, PLS, HTML, etc). It is very useful if you have a large amount +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. .P It is coded in C to be as fast as possible, and does not use any specific @@ -29,10 +29,10 @@ formats. .SH OPTIONS .IP -b|--backslash -Replace the '/' with '\' in Unix path. +Replace the '/' with '\\' in Unix path. .IP -d|--debug Display useful messages if the program fails ;) -.IP -f|--format=m3u|pls|html +.IP -f|--format=m3u|pls|xspf|html|rss|pla|txx Choose which format of playlist you want to generate (default is m3u). .IP -g|--genre=#:#:... Choose which genres (numerical values only) will be included in the generated playlist (default is all). @@ -50,6 +50,10 @@ Recursively read the subdirectories. Replace all Unix characters with Windows characters. .IP -x|--exclude=#:#:... Choose which genres (numerical values only) will be excluded in the generated playlist (default is none). +.IP -c|--command= +External binary or script that produces additional fields for RSS feeds (slow). +.IP -s|--stdin +Read filenames and/or directories from standard input instead of command line. .SH EXAMPLES Generate a PLS playlist for an album: @@ -62,7 +66,7 @@ on the server containing the files is and is visible on the Windows network as .I \\\\\\\\server\\\\mp3 : -.B fapg --backslash --output=/samba/mp3/list.m3u --prefix='\\\\\\\\server\\\\mp3\\\\' --recursive --windows /samba/mp3 +.B cd /samba/mp3 && fapg --backslash --output=/samba/mp3/list.m3u --prefix='\\\\\\\\server\\\\mp3\\\\' --recursive --windows ./ An HTML playlist for an album: .B fapg --output=fapg.html ~/path/to/album @@ -70,6 +74,18 @@ An HTML playlist for an album: A playlist that contains all your classical tracks may receive the genres to include (or exclude) in one or multiple portions .B 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: +.B 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: +.B fapg -f pla -o /path/to/playlist.pla /path/to/all/music + +if command starts with +.I 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. + .SH AUTHOR Antoine Jacquet , http://royale.zerezo.com/fapg/.