HERRIE(1) HERRIE(1) 1mNAME0m herrie - interactive music playlist player 1mSYNOPSIS0m 1mherrie 22m[1m-pvx22m] [1m-c 4m22mconfigfile24m] [4mfile24m 4m...24m] 1mDESCRIPTION0m 1mherrie 22mis 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'. 1mherrie 22muses 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: 1m-c 4m22mconfigfile0m By default, 1mherrie 22msearches in 4m~/.herrie/config24m or in the system wide global configuration file 4m/usr/local/etc/herrie.conf24m for options. The 1m-c 22moptions allows you to load additional configura- tion files. 1m-p 22mAutomatically start playback on startup. 1m-v 22mDisplay version information and a list of supported file for- mats. 1m-x 22mThis switch causes 1mherrie 22mto start up in XMMS mode. Files that are passed on the command line will be appended to the playlist. 1mKEYBOARD BINDINGS0m Both the file browser and the playlist share some common keyboard bind- ings: 1mj or down arrow0m Move the selection one entry down. 1mk or up arrow0m Move the selection one entry up. 1m^F, page down or spacebar0m Move the selection one page down. 1m^B or page up0m Move the selection one page up. 1mf 22mShow the full pathname of the selected song. 1mF 22mJump to the selected file in the file browser. 1mg or home0m Move the selection to the top. 1mG or end0m Move the selection to the bottom. 1m/ 22mSearch 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. 1m? 22mSearch the entries for a specified regular expression and select the first matching entry above the current selection. If no match is found, the search will continue at the bottom of the list. As a final attempt, the other window is searched as well. 1mn 22mPerform another search for the last entered search string. 1mN 22mPerform another search for the last entered search string in the opposite direction. There are also some bindings that only apply to the playlist: 1md 22mRemove the currently selected song from the playlist. 1mD 22mRemove all songs from the playlist. 1mR 22mRandomize the playlist. 1m[ 22mMove the currently selected song upward. 1m] 22mMove the currently selected song downward. 1m{ 22mMove the currently selected song to the top of the playlist. 1m} 22mMove the currently selected song to the bottom of the playlist. 1m~ 22mNavigate back to the directory specified in 1mgui.browser.default-0m 1mpath .0m 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: 1ma 22mAdd items after the current selected item in the playlist. 1mA 22mAdd items at the end of the playlist. 1mi 22mAdd items before the current selected item in the playlist. 1mI 22mAdd items at the beginning of the playlist. 1mh or left arrow0m Go one directory up. 1ml or right arrow0m Enter the selected directory. 1mL 22mLocate 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 direc- tory up. 1mC 22mChange the current directory by entering a pathname. This path- name 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: 1m( 22mDecrease the volume. 1m) 22mIncrease the volume. 1m< 22mSeek 5 seconds backward. 1m> 22mSeek 5 seconds forward. 1mb 22mGo to the next song. 1mc 22mPause the current song. When 1mc 22mis pressed again, playback is resumed. 1mJ 22mSeek to a specific position. When the inserted time is prepended with a + or -, the seek is performed relative. 1mP 22mPurge the file system cache, if enabled with 1mvfs.cache .0m 1mq 22mQuit the application. 1mr 22mSwitch 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. 1mv 22mStop playback. 1mw 22mWrite the current playlist to a playlist file. 1mx 22mWhen in XMMS mode, it starts the selected song. In party mode, this key will always start playback of the first song in the list. 1mz 22mGo to the previous song. 1m^L 22mForce the application to redraw itself. 1m^W or tab0m Switch the focus from the playlist to the file browser or vice versa. 1mCONFIGURATION SWITCHES0m 1mherrie 22mmay be configured by storing options in a configuration file. Options must be stored in the following format: 1mkey=value0m Below is a list of switches, including their default values: 1maudio.output.alsa.device=default0m The name of the ALSA device that should be used for audio play- back. 1maudio.output.alsa.mixer=PCM0m The name of the ALSA mixer channel that should be used to adjust the playback volume. 1maudio.output.ao.driver=0m The name of the driver that LibAO should use for audio playback. 1maudio.output.ao.host=0m The hostname that LibAO should use to transmit the sound to (only applicable to Esound). When set to 1menv_ssh 22mthe application will use the IP-address in the 1mSSH_CLIENT 22menvironment variable. 1maudio.output.oss.device=/dev/dsp0m The OSS DSP device, used for audio playback. 1maudio.output.oss.mixer=/dev/mixer0m The OSS mixer device, used to change the volume. 1mgui.browser.defaultpath=0m On startup, the current directory is shown in the file browser. When this option is set, it tries to open that specific direc- tory first. 1mgui.color.bar.bg=blue0m The background color of the bars (the status bar at the top of the screen and the directory name bar in the middle). Valid col- ors are black, red, green, yellow, blue, magenta, cyan, white and default. The latter is the terminal's default color (e.g. black on white). 1mgui.color.bar.fg=white0m The foreground color of the bars. 1mgui.color.block.bg=black0m The background color of the blocks (the playlist, the file browser and the message prompt at the bottom). 1mgui.color.block.fg=white0m The foreground color of the blocks. 1mgui.color.deselect.bg=white0m 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). 1mgui.color.deselect.fg=black0m The foreground color of a selected item of an inactive window. 1mgui.color.enabled=yes0m 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. 1mgui.color.marked.fg=black0m The foreground color of the item that is currenty played. It is not used when in party mode. 1mgui.color.marked.bg=red0m The background color of the item that is currenty played. It is not used when in party mode. 1mgui.color.select.bg=cyan0m The background color of a selected item of an active window. 1mgui.color.select.fg=black0m The foreground color of a selected item of an active window. 1mgui.input.confirm=yes0m When disabled, the user will not be asked for confirmation when issuing commands. 1mgui.input.may_quit=yes0m When disabled, the user of the application may not quit the application using the 1mq 22mbutton. 1mgui.ratio=500m The percentage of the height of the playlist. 1mgui.vfslist.scrollpages=no0m When enabled, the file browser and the playlist will scroll an entire page up or down when the selection goes out of sight. 1mplayq.dumpfile=~/.herrie/autosave.xspf0m 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 4m~/.herrie/0m does not exist. The application will not create this directory by itself. 1mplayq.autoplay=no0m Automatically start playback on startup. 1mplayq.xmms=no0m Always start 1mherrie 22min XMMS mode. 1mscrobbler.dumpfile=~/.herrie/scrobbler.queue0m The file that is used to store tracks that have not been submit- ted to AudioScrobbler yet. When set to empty, this feature is disabled, causing all unsubmitted tracks to be discarded. 1mscrobbler.hostname=post.audioscrobbler.com0m The hostname the AudioScrobbler client uses when authenticating. 1mscrobbler.password=0m 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 4mmust24m contain an MD5 hash. Use the following command to generate such a hash: 1mprintf %s p4ssw0rd | md50m 1mscrobbler.username=0m The username the AudioScrobbler client uses when authenticating. 1mvfs.cache=no0m Cache file system entries to reduce disk I/O. This option mas- sively improves search performance on large directories. It is disabled by default, since it increases memory footprint and requires you to press 1mP 22mto purge the cache manually, in case files are created and deleted in the background. The purging of the cache may cause memory leaks, since the caching could intro- duce cyclic dependencies. 1mvfs.dir.hide_dotfiles=yes0m Hide files in directories with a filename starting with a dot. 1mvfs.lockup.chroot=0m Lock the application's filebrowser in a directory. Please note that 1mherrie 22mmust be launched as 4mroot24m for this switch to work. It is advised to set 1mvfs.lockup.user 22mas well. 1mvfs.lockup.user=0m Change the effective user of the application to the specified user. 1mAUTHORS0m 1mherrie 22mis maintained by Ed Schouten . Please visit 4mhttp://herrie.info/24m for more information, documentation and developer notes. Ed Schouten January 1, 2008 HERRIE(1)