This is the COMMANDS file copied directly from irmp3 0.4.4.
You can enter these directly by typing `l' or `:' in irmp3-ncurses
followed by the command itself.  Many of these already have
equivalents in the UI.  See irmp3-ncurses README for details.
This file is for irmp3 0.4.4 only, 0.5.x users should see 
`man 7 irmp3d' instead.

Text of COMMANDS follows:



This is a list of all supported commands. Commands control what IRMP3
should do, e.g. play a song or increase the volume.


GENERAL COMMANDS
----------------

reload				Reloads all config files (like
				sending a SIGHUP to IRMP3)


INTERFACE COMMANDS
------------------

environment <name>		Issues a group of commands
				as defined in irmp3.conf

beep [enable|disable]		Enables/disables beeps when
				certain commands are entered.
				(currently only sleep & shuffle)

beep on <string>		Instructs IRMP3 to make an "on"
				beeping noise when this command
				is encountered.

beep off <string>		Instructs IRMP3 to make an "off"
				beeping noise when this command
				is encountered.
				

network filter <regex>		(supported only by mod_netctl and
				when connected via a network)
				Filters messages sent to your
				network socket.  Matching messages
				will not be sent.

displaymode [0|1]		Sets the LCD display to display
				elapsed time in song or remaining
				time in song.

query <item>			Retrieve information about the state of 
				IRMP3 and the currently playing song, 
				where item is "status", "volume", "bass",
				"treble", "mute","shuffle", "repeat",
				"title", "artist", "album", "year",
				"comment", "genre", "mp3file", "time",
				"playlist", "plpos", "plfiles" or "pldirs".


PLAYER COMMANDS
---------------

stop				Stop playing

play <song>			Load and play the specified song.
				<song> may be:
				any valid mpg3 file/stream (mpg123)

pause				Pause / unpause the current song

seek [+|-]<offset>		Seeks to the specified absolute or
				relative offset (given as a value
				of seconds). This may be a little
				inaccurate if playing compressed
				streams like mp3.
				Use "jump +2" to skip forward a little.
				Use "jump -2" to rewind a little.
				Use "jump 0" to seek to the beginning.

cd load 			Load a CD and create playlist for it.
                                CD may be an audio cd or data cd
				
cd eject			Try to eject cd. If it fails, stop playing
                                and try again.

cd eject2                       Try to eject cd.								



PLAYLIST COMMANDS
-----------------

playlist load <file>		Load and play the specified playlist.
				Clears previously loaded playlist.
				The playlist is an ascii file with
				one filename each line (a typical
				m3u file).

playlist loadplus <file>	As for load but without clearing playlist.

playlist loaddir <pattern>	Loads all files matching <pattern> as
				a new playlist. Directories will be
				searched recursively and standard
				wildcards are allowed. E.g:
					/var/mp3/*.mp3
					/var/mp3/CD2/*.mp3
				Even this is possible:
					/var/mp3/*/Pop/*.mp3
					/var/mp3/*/Metal/*.mp3

playlist loaddirplus <pattern>	As for loaddir but without clearing playlist.

playlist clear			Clears the current playlist.

playlist clearnostop		Clears the current playlist without stopping 
                                current song.

playlist done			Playlist editing finished. Sort (if 
                                necessary) and play first entry.

playlist add <file>		Adds the specified file to the playlist.
				The file should be a playable file (e.g. 
                                mp3 file). No playing is initiated.

playlist addplus <file>		As for add, but starts playing and sends
                                a notification message to the display.

playlist jump [+|-]<offset>	Seeks to the specified absolute or
				relative song.
				Use "playlist jump +1" to skip to
				the next song.
				Use "playlist jump -1" to skip to
				the previous song.
				Use "playlist jump 0" to jump to
				the first song.

playlist jumpdir [+|-]<offset>	Seeks to the specified absolute or
				relative next directory in a playlist.

playlist shuffle [0|1]		Sets random playorder of playlist. Modes are:
				0 = shuffle off
				1 = shuffle on
				If you don't specify a mode, the current
				mode is toggled.

playlist repeat [0|1|2]		Sets repeat mode. Modes are:
				0 = repeat off
				1 = repeat current
				2 = repeat all
				If you don't specify a mode, the current
				mode is toggled.

playlist sort			Sorts the playlist by song (and directory) name.
				Automatic sorting can be defined in irmp3.conf


PLAYLISTLIST COMMANDS
---------------------

playlistlist load <file>	Load and play the specified playlistlist file.
				A playlistlist file is a list of playlists. It's
				an ascii file with one filename of a
				playlist each line.

playlistlist clear		Clears the current playlistlist.

playlistlist jump [+|-]<offset>	
				Seeks to the specified absolute or
				relative playlist.
				

BROWSER COMMANDS
----------------

browser cursor [+|-][step]	Scroll within a directory.
				Use +<step> to scroll down (+1 norm, +10 pgdown)
				Use -<step> to scroll up   (-1 norm, -10 pageup)
				Use <step> for absolute cursor position
				Use + or - only to skip to next letter

browser back			Change to parent directory (like cd ..)

browser into			Change into selected directory (like cd subdir)

browser add			Add selected directory/mp3/m3u to current
				playlist and start playing if playlist was empty
				   or
				Execute selected *.sh shell script if script
                                execution is enabled in irmp3.conf and shell
                                script is located below path 'browser_exec'

browser play			Clear existing playlist, add selected
	                        directory/mp3/m3u to playlist and start playing

browser clear			Clear playlist (like 'playlist clear') with
                                additional LCD output
				
browser setpwd <directory>	Set parent directory to <directory>. This may be
                                an absolute path or relative to 'browser_root'
				Both, the absolute and relative statement must
				result in a path located below 'browser_root'

browser show			Show parent directory and cursor without any
                                further action (eg for entering browser mode)

browser exec <shell script>	Shell script (absolute path) to be executed.
				This script does NOT need to be located below
				'browser_exec' - every file is accepted!
				No user specific command line parameters 
				are allowed.
				1st internal parameter passed to this script
				is a temporary file where the script can leave
				a message that will be displayed after
				execution. If no message is desired the script
				has to clear or delete this file. See 
				scripts/README for details.
				2nd internal parameter passed to this script
				is the current browser directory.
				3rd internal parameter passed to this script
				is the current browser cursor.
				4th internal parameter passed to this script
				is the current cursor's file type:
				    dir         = directory
				    audio	= audio/mp3 file
				    list	= playlist
				    listlist	= playlist-list
				    exec	= executable shell script
				    other	= any other file
				

MIXER COMMANDS
--------------

mixer volume [+|-]<value>	Sets the master volume to <value>. You
				may give absolute or relative (with +|-)
				values. <value> may be within 0..100.

mixer balance [+|-]<value>	Sets the balance. Range is -50..50,
				where -50 is left and 50 ist right.
				Only available on stereo soundcards.

mixer bass [+|-]<value>
mixer treble [+|-]<value>	Sets bass/treble value. Range is 0..100.
				Not available with every soundcard.

mixer default			Reset mixer settings to defaults
				specified in configuration file.

mixer mute [0|1]		Mutes sound until disabled.  If no
				parameter is specified, the mute status
				will toggle.  Adjusting the volume will
				send an implicit "mixer mute 0"
			


TIMER COMMANDS
--------------

sleep <time> [<fadetime>]	Activates the sleep timer. This will stop the
				player in <time> minutes. A value of 0
				disables the sleep timer.
				If you specify <fadetime>, the volume will
				be decreased while the last <xtime> minutes
				of <time>.

ALARM COMMANDS
--------------
alarm [enable|disable]		Enables/disables the use of alarms.  Alarms
				are sent to IRMP3 via SIGUSR1 and SIGUSR2
				and require the user to configure
				environment_alarm1 and/or environment_alarm2
				in irmp3.conf
