-
Notifications
You must be signed in to change notification settings - Fork 1
/
Copy pathmocp.1
246 lines (194 loc) · 4.92 KB
/
mocp.1
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
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
.TH MOC 1 "25 December 2005" "Version 2.4.0" "music on console"
.SH NAME
MOC \- console audio player
.SH SYNOPSIS
.B mocp
[OPTIONS] [FILE ...]
.SH DESRIPTION
MOC is a console audio player with simple ncurses interface. It supports OGG,
wave, and MP3 formats. Just run mocp, go to some directory using menu and
press enter to start playing file, program will be playing automaticaly rest
of the files in the directory.
With no options and no file arguments the program begins in current directory or
in MusicDir if StartInMusicDir option is set. If you give a directory on the
command line, MOC will try to go there. With files or multiple directories,
everything will be added to the playlist recursively.
.SH OPTIONS
If an option can be also set in the configuration file, the command line
overrides it.
.TP
.I -D --debug
Run in debug mode. Client and server logs much information to debug files.
Don't use this, the server log is large.
This is only available if MOC was compiled without --disable-debug.
.TP
.I -S --server
Run only the server and exit.
.TP
.I -F --foreground
Implies -S. Run the server in foreground and log everything to stdout.
.TP
.I -R --sound-driver NAME
Use the specified sound driver. This can be OSS, ALSA, or null (for debugging).
Some of the drivers could not be compiled in. This option is called SoundDriver
in configuration file.
.TP
.I -m --music-dir
Start in MusicDir (set in configuration file). This can be also set in
configuration file as StartInMusicDir.
.TP
.I -a --append
Append files, directories (recursively) and playlists given after options to
the playlist. Don't start the interface.
.TP
.I -c --clear
Clear the playlist.
.TP
.I -p --play
Start playing from the first item on the playlist.
.TP
.I -f --next
Request playing the next song from the server's playlist.
.TP
.I -r --previous
Request playing the previous song from the server's playlist.
.TP
.I -s --stop
Request stop playing from the server.
.TP
.I -x --exit
Bring down the server.
.TP
.I -P --pause
Request pause from the server.
.TP
.I -U --unpause
Request unpause from the server.
.TP
.I -G --toggle-pause
Toggle between play/pause.
.TP
.I -k --seek N
Seek by N seconds (can be negative).
.TP
.I -T --theme theme
Use a theme file. If the path is not absolute, the file will be searched in
/usr/share/moc/themes/ (depends on installation prefix), ~/.moc/themes/ and in
the current directory.
.TP
.I -C --config FILE
Use the specified config file instead of the default.
.TP
.I -M --moc-dir DIR
Use the specified MOC directory instead of the default. This also causes to use
the config file from that directory. This can be also specified in the config
file using the MOCDir option.
.TP
.I -y --sync
This copy of the interface will be synchronizing the playlist with other
clients. This option is calles SyncPlaylist in the configuration file.
.TP
.I -n --nosync
This copy of the interface will not be synchronizing its playlist with other
clients (see above).
.TP
.I -A --ascii
Use ASCII characters to draw lines (helps on some terminals).
.TP
.I -i --info
Print the information about the currently played file.
.TP
.I -Q --format FORMAT_STRING
Print information about the currently played file using a format string.
Replace string sequences with proper information:
.TP
State
%state
.TP
File
%file
.TP
Title
%title
.TP
Artist
%artist
.TP
SongTitle
%song
.TP
Album
%album
.TP
TotalTime
%tt
.TP
TimeLeft
%tl
.TP
TotalSec
%ts
.TP
CurrentTime
%ct
.TP
CurrentSec
%cs
.TP
Bitrate
%b
.TP
Rate
%r
.TP
\\n
\\n
It is also possible to use variables from the FormatString configuration
option.
.TP
.I -e --recursively
Alias for -a for backward compatybility.
.TP
.I -h --help
Print list of options with short description and exit.
.TP
.I -V --version
Print program version and exit.
.TP
.I -v --volume
Adjust the mixer volume. You can set (-v 50), or adjust (-v +10), (-v -10).
.TP
.I -t --toggle
.TP
.I -o --on
.TP
.I -u --off
Followed by a list of identifiers, these will control MOC's playlist options.
Valid identifiers: shuffle, repeat, and autonext. Can be shortened to
s, r, and n respectively.
Example: -t shuffle,r,n would toggle shuffle repeat and autonext all at once.
.TP
.I -j --jump N
Jump to some positions in the current file. N is number of seconds followed by 's'
or percent of total file time followed by '%'. Examples: -j 10s, -j 50%
.SH FILES
.TP
.I ~/.moc
MOC directory for configuration file, socket, pid file, and other data.
.TP
.I ~/.moc/config
Configuration file of MOC. Format is very simple, to see how to use it,
look into example configuration file (config.example) distributed with the
program.
.TP
.I ~/.moc/themes
.I /usr/share/moc/themes
Default directories for theme files.
.SH BUGS
Command line options that affects the server bahaviour (like --sound-driver) are
ignored if the server is already running at the time of executing mocp. The user
is not warned about this.
.SH HOMEPAGE
http://moc.daper.net
.SH AUTHOR
Damian Pietras <[email protected]>