Provided by:
shell-fm_0.4+svn20071125.r282-1_i386 
NAME
shell-fm-config - Shell-fm configuration files
SYNOPSIS
~/.shell-fm/shell-fm.rc
DESCRIPTION
shell-fm config files are composed by a set of typical key=value
entries.
KEYS
username = theUsername
Your Last.FM username.
password = thePassword
Your Last.FM password.
np-file = /path/to/np-file
If defined, Shell.FM will write information about the currently
played track to this file, every time a new track starts.
np-file-format = formatString
This defines the format of your np-file. See below for a list of
available format flags.
np-cmd = command
If defined, Shell.FM will execute this command every time a new
track is played. Accepts the same format flags as
np-file-format.
default-radio = lastfm://...
If defined, Shell.FM will start playing this stream on startup.
key0x?? = command
(Where ?? is the uppercase hexadecimal ASCII code of a key.)
This makes Shell.FM execute the command whenever you press the
defined key. The command string may contain the same format
flags as np-file-format. Useful for running scripts, e.g. lyric
fetchers.
?-color = color-code
Use this for colored output, where ? may be one of the format
flags characters supported (without leading %). Shell.FM will
then color the strings (if your terminal supports it). The
color-code may be any console color code (escape sequence, but
without escape). See below for a list of available color codes.
bind = ip|host
Binds a socket to the given host so you can send simple commands
to Shell.FM over a network to control it. For now, only the most
common commands are supported: "skip", "love", "ban", "quit",
"play" and "info". "play" takes a radio station URI as
paramater. "info" takes a format string as parameter (same as
for np-file-format) and returns the string (formatted).
port = thePort
If defined, the socket interface will be bound to this port
instead of the default, 54311.
extern = command
On some platforms, Shell.FM is still unable to play streams
properly. This option enables you to use Shell.FM for stream
control, but use another player for the playback. The stream
will be written to STDIN of the external player.
extern-restart = anything
If defined (no matter what value), Shell.FM will stop and
restart the external player whenever the track changes.
proxy = http://proxy-server
Use proxy server for HTTP requests.
expiry = time
TTL of cached files in seconds.
FORMAT STRINGS
%a Artist.
%t Track.
%A Album.
%d Track duration.
%s Station name.
%u Station URL.
%U Artist URL.
%X Album URL.
%T Track URL.
%R Remaining seconds of the played track.
COLOR CODES
0;30 black (not very useful).
1;30 dark gray.
0;31 red.
1;31 light red.
0;32 green.
1;32 light green.
0;33 dark yellow/brown.
1;33 yellow.
0;34 blue.
1;34 light blue.
0;35 violet.
1;35 pink.
0;36 turquoise.
1;36 cyan.
0;37 gray.
1;37 white.
FILES
~/.shell-fm/shell-fm.rc
This is the per-user configuration file.
AUTHOR
Manpage written by Nacho Barrientos Arias <nacho@debian.org> for the
Debian GNU/Linux system (but may be used by others).
BUGS
Report bugs to Debian BTS at http://bugs.debian.org
COPYRIGHT
Copyright © 2006-2007, Jonas Kramer and others. Licensed under GPLv2
license.
http://nex.scrapping.cc/shell-fm/
SEE ALSO
shell-fm(1)