Man Linux: Main Page and Category List

NAME

       herrie - interactive music playlist player

SYNOPSIS

       herrie [-pvx] [-c configfile] [file ...]

DESCRIPTION

       herrie  is a command line music player. It supports multiple audio file
       formats (including MP3 and Ogg Vorbis) and  has  the  ability  to  send
       playback  statistics  to AudioScrobbler. The word `herrie' is Dutch for
       `clamour'.

       herrie uses a split-screen user interface: a playlist at the top and  a
       filebrowser  at the bottom. The application has two modes of operation,
       called `party mode' and `XMMS mode'. When the application is started in
       party  mode,  the first song in the playlist gets started. It will also
       be removed from the playlist as well. When the application  is  started
       in  XMMS mode, any song can be started and will not be removed from the
       playlist.  The default mode is party mode.

       The following command line options are available:

       -c configfile
              By default, herrie searches in ~/.herrie/config or in the system
              wide global configuration file /etc/herrie.conf for options. The
              -c options allows you to load additional configuration files.

       -p     Automatically start playback on startup.

       -v     Display  version  information  and  a  list  of  supported  file
              formats.

       -x     This switch causes herrie to start up in XMMS mode.

       Files  that  are  passed  on  the  command line will be appended to the
       playlist.

KEYBOARD BINDINGS

       Both the file browser and  the  playlist  share  some  common  keyboard
       bindings:

       j or down arrow
              Move the selection one entry down.

       k or up arrow
              Move the selection one entry up.

       ^F, page down or spacebar
              Move the selection one page down.

       ^B or page up
              Move the selection one page up.

       f      Show the full pathname of the selected song.

       F      Jump to the selected file in the file browser.

       g or home
              Move the selection to the top.

       G or end
              Move the selection to the bottom.

       /      Search the entries for a specified regular expression and select
              the first matching entry below  the  current  selection.  If  no
              match is found, the search will continue at the top of the list.
              As a final attempt, the other window is searched as well.

       n      Perform another search for the last entered search string.

       There are also some bindings that only apply to the playlist:

       d      Remove the currently selected song from the playlist.

       D      Remove all songs from the playlist.

       R      Randomize the playlist.

       [      Move the currently selected song upward.

       ]      Move the currently selected song downward.

       {      Move the currently selected song to the top of the playlist.

       }      Move the currently selected song to the bottom of the  playlist.

       The  file browser also has some bindings that allow you to traverse the
       file system or add files, directories or playlists (M3U and PLS) to the
       playlist:

       a      Add items after the current selected item in the playlist.

       A      Add items at the end of the playlist.

       i      Add items before the current selected item in the playlist.

       I      Add items at the beginning of the playlist.

       h or left arrow
              Go one directory up.

       l or right arrow
              Enter the selected directory.

       L      Locate  all  files  in  the  current  and underlying directories
              matching a search string. When finished, all matching files will
              be  showed  in  a  list.  To  remove  an existing filter, go one
              directory up.

       C      Change the  current  directory  by  entering  a  pathname.  This
              pathname  may  be  relative  to  the current directory. When the
              address refers to a file or web location, it will  be  displayed
              as well.

       And last but not least, there are also some general keyboard bindings:

       <      Seek 5 seconds backward.

       >      Seek 5 seconds forward.

       b      Go  to  the  next  song.  Sending  the  signal  SIGUSR2  to  the
              application will do the same.

       c      Pause the current song. When c is  pressed  again,  playback  is
              resumed.  Sending  the signal SIGUSR1 to the application will do
              the same.

       J      Seek to a specific position. When the inserted time is prepended
              with a + or -, the seek is performed relative.

       q      Quit the application.

       r      Switch  repeat  on  and  off. When this option is enabled, songs
              that have been successfully opened will be added to the  end  of
              the playlist, causing the playlist to repeat.

       v      Stop playback.

       w      Write the current playlist to a playlist file.

       x      When  in  XMMS mode, it starts the selected song. In party mode,
              this key will always start playback of the  first  song  in  the
              list.

       z      Go to the previous song.

       ^L     Force the application to redraw itself.

       ^W or tab
              Switch  the  focus from the playlist to the file browser or vice
              versa.

CONFIGURATION SWITCHES

       herrie may be configured by storing options in  a  configuration  file.
       Options must be stored in the following format:

       key=value

       Below is a list of switches, including their default values:

       gui.browser.defaultpath=
              On  startup, the current directory is shown in the file browser.
              When this  option  is  set,  it  tries  to  open  that  specific
              directory first.

       gui.color.bar.bg=blue
              The  background  color of the bars (the status bar at the top of
              the screen and the directory name  bar  in  the  middle).  Valid
              colors are black, red, green, yellow, blue, magenta, cyan, white
              and default. The latter is the terminal's  default  color  (e.g.
              black on white).

       gui.color.bar.fg=white
              The foreground color of the bars.

       gui.color.block.bg=black
              The  background  color  of  the  blocks  (the playlist, the file
              browser and the message prompt at the bottom).

       gui.color.block.fg=white
              The foreground color of the blocks.

       gui.color.deselect.bg=white
              The background color of a selected item of  an  inactive  window
              (the  background  color  of a selection in the file browser when
              the playlist is selected, for example).

       gui.color.deselect.fg=black
              The foreground color of a selected item of an inactive window.

       gui.color.enabled=yes
              Draw the application using colors when the terminal supports it.
              When disabled, the application is forced to draw itself as if it
              were used with a monochrome terminal.

       gui.color.marked.fg=black
              The foreground color of the item that is currenty played. It  is
              not used when in party mode.

       gui.color.marked.bg=red
              The  background color of the item that is currenty played. It is
              not used when in party mode.

       gui.color.select.bg=cyan
              The background color of a selected item of an active window.

       gui.color.select.fg=black
              The foreground color of a selected item of an active window.

       gui.input.confirm=yes
              When disabled, the user will not be asked for confirmation  when
              issuing commands.

       gui.input.may_quit=yes
              When  disabled,  the  user  of  the application may not quit the
              application using the q button.

       gui.vfslist.scrollpages=no
              When enabled, the file browser and the playlist will  scroll  an
              entire page up or down when the selection goes out of sight.

       playq.dumpfile=~/.herrie/autosave.xspf
              The filename used to automatically save the playlist at shutdown
              and load at startup. When empty, this feature will be  disabled.
              This feature will also be disabled when the directory ~/.herrie/
              does not exist. The application will not create  this  directory
              by itself.

       playq.autoplay=no
              Automatically start playback on startup.

       playq.xmms=no
              Always start herrie in XMMS mode.

       scrobbler.dumpfile=~/.herrie/scrobbler.queue
              The  file  that  is  used  to  store  tracks  that have not been
              submitted to AudioScrobbler yet. When set to empty, this feature
              is disabled, causing all unsubmitted tracks to be discarded.

       scrobbler.password=
              The password the Audioscrobbler client uses when authenticating.
              Make sure your configuration  file  isn't  world  readable  when
              specifying  this  switch in your configuration file. Please note
              that this switch must contain an MD5  hash.  Use  the  following
              command to generate such a hash: printf %s p4ssw0rd | md5

       scrobbler.username=
              The username the AudioScrobbler client uses when authenticating.

       vfs.dir.hide_dotfiles=yes
              Hide files in directories with a filename starting with a dot.

       vfs.lockup.chroot=
              Lock the application's filebrowser in a directory.  Please  note
              that herrie must be launched as root for this switch to work. It
              is advised to set vfs.lockup.user as well.

       vfs.lockup.user=
              Change the effective user of the application  to  the  specified
              user.

AUTHORS

       herrie  is  maintained  by  Ed  Schouten  <ed@80386.nl>.  Please  visit
       http://herrie.info/ for more information, documentation  and  developer
       notes.