Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
FAPG(1)				 User Manuals			       FAPG(1)

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  spe-
       cific  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	behav-
	      ior 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	--out-
       put=~/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	--out-
       put=/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 gen-
       res  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 gen-
       erate a detailed	description: fapg --output=dir.xml -f rss -c  /usr/lo-
       cal/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,Ti-
       tle,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 LOG-
       NAME or LANG.

AUTHOR
       Antoine	Jacquet	 <royale@zerezo.com>,  http://royale.zerezo.com/fapg/.
       Manpage by Thomas Kappler <thomas.kappler@stud.uni-karlsruhe.de>.

Linux				 JANUARY 2007			       FAPG(1)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | EXAMPLES | AUTHOR

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=fapg&sektion=1&manpath=FreeBSD+12.1-RELEASE+and+Ports>

home | help