File: COMMANDS

package info (click to toggle)
irmp3 0.4.3pre6-2
  • links: PTS
  • area: main
  • in suites: woody
  • size: 584 kB
  • ctags: 374
  • sloc: ansic: 3,955; makefile: 212; pascal: 39
file content (180 lines) | stat: -rw-r--r-- 4,934 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180

This is a list of all supported commands. Commands does control what IRMP3
should do, e.g. playing a song or increasing 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 "plpos","volume","bass","treble",
				"title","artist","album","year,"comment"
				or "genre"

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.
				The playlist is an ascii file with
				one filename each line (a typical
				m3u file).

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 clear			Clears the current playlist.

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.


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.


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