File: gmusicbrowser.man

package info (click to toggle)
gmusicbrowser 1.1.9-2
  • links: PTS, VCS
  • area: main
  • in suites: wheezy
  • size: 6,908 kB
  • sloc: perl: 33,804; makefile: 91; sh: 3
file content (207 lines) | stat: -rw-r--r-- 4,847 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
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
.TH "gmusicbrowser" "1" "Oct 08, 2011" "gmusicbrowser" ""
.SH "NAME"
gmusicbrowser \- Jukebox for large collections of music files

.SH "SYNOPSIS"
.B gmusicbrowser
.RI
[\-nocheck]
[\-noscan]
[\-demo]
[\-ro]
[\-rotags]
[\-play]
[\-nodbus]
[\-gst|\-nogst]
[\-server]
[\-port N]
[\-cfg FILE]
[\-fifo FIFO|\-nofifo]
[\-debug]
[\-layout NAME]
[\-plugin NAME]
[\-searchpath FOLDER]
[\-use\-gnome\-session]
[\-workspace N]
[\-cmd CMD]
[\-ifnotrunning MODE]
[\-dbus\-id KEY]
FOLDER_OR_FILE ...
.br

.B gmusicbrowser
.RI
\-listcmd

.B gmusicbrowser
.RI
\-tagedit FOLDER_OR_FILE ...

.SH "DESCRIPTION"
This manual page explains the
.B gmusicbrowser
program.
.PP
\fBgmusicbrowser\fP can play and manage your songs, currently supports mp3, ogg, flac, mpc file formats.
see http://gmusicbrowser.sourceforge.net/ for more information.
.SH "OPTIONS"
.B
.TP
\fB\-c\fR, \fB\-nocheck\fR
don't check for updated/deleted songs on startup
.TP
\fB\-s\fR, \fB\-noscan\fR
don't scan folders for songs on startup
.TP
\fB\-demo\fR
don't save settings/tags on exit
.TP
\fB\-ro\fR
prevent modifying/renaming/deleting song files
.TP
\fB\-rotags\fR
prevent modifying tags of music files
.TP
\fB\-play\fR
start playing on startup
.TP
\fB\-gst\fR
use gstreamer
.TP
\fB\-nogst\fR
do not use gstreamer
.TP
\fB\-nodbus\fR
do not use DBus
.TP
\fB\-server\fR
send playing song to connected icecast client
.TP
\fB\-port N\fR
listen for connection on port N in icecast server mode
.TP
\fB\-C FILE\fR, \fB\-cfg FILE\fR
use FILE as configuration file (instead of 'gmbrc' in default folder),
if FILE is a folder (or ends with '/'), it will be used as base folder instead of ~/.config/gmusicbrowser/
.TP
\fB\-F FIFO\fR, \fB\-fifo FIFO\fR
use FIFO as named pipe to receive commans (instead of 'gmusicbrowser.fifo' in default folder)
.TP
\fB\-nofifo\fR
do not use/create named pipe
.TP
\fB\-dbus\-id KEY\fR
append .KEY to the DBus service id used by gmusicbrowser (org.gmusicbrowser)
.TP
\fB\-debug\fR
print lots of useless information
.TP
\fB\-backtrace\fR
print a backtrace for every warning
.TP
\fB\-l NAME\fR, \fB\-layout NAME\fR
use layout NAME for player window
.TP
\fB\-plugin NAME\fR
deactivate plugin identified by NAME
.TP
\fB\+plugin NAME\fR
activate plugin identified by NAME
.TP
\fB\-noplugins\fR
deactivate all plugins
.TP
\fB\-searchpath FOLDER\fR
add FOLDER to the list of folders searched for plugins and layouts
.TP
\fB\-use\-gnome\-session\fR
Use gnome libraries to save tags/settings on session logout (needs the Gnome2 perl module).
.TP
\fB\-workspace N\fR
Move initial window to workspace N (needs the Gnome2::Wnck perl module).
.TP
\fB\-cmd CMD\fR
add CMD to the list of commands to execute. If a running instance of gmusicbrowser is found, these commands will be sent via the fifo file or via DBus. If there is no running instance of gmusicbrowser, the behavior depends on option \-ifnotrunning
.TP

\fB\-ifnotrunning MODE\fR
change behavior when no running gmusicbrowser instance is found, MODE can be one of :
.RS
.IP \fInormal\fR
(default) launch a new instance and execute commands
.IP \fInocmd\fR
launch a new instance but discard commands
.IP \fIabort\fR
do nothing
.RE
.RS
Running instances of gmusicbrowser are detected via the fifo or via DBus.
To run more than one instance, use a unique fifo and a unique DBus\-id, or deactivate them.
.RE

.TP
\fB\-listcmd\fR
list the available commands and exit
.TP
\fB\-listlayout\fR
list the available layouts and exit
.TP
\fB\-listplugin\fR
list the available plugins and exit
.TP
\fB\-tagedit FOLDER_OR_FILE ...\fR
Load songs in FOLDER_OR_FILE and display a dialog to edit their tags.

.SH FILES
.TP
\fI~/.gmusicbrowser/tags\fP
contains songs tags and program options
.TP
\fI/usr/share/gmusicbrowser/plugins/\fP, \fI~/.gmusicbrowser/plugins/\fP
files with extension .pm in these folders are loaded as plugins on startup
.TP
\fI/usr/share/gmusicbrowser/layouts/*.layout\fP, \fI~/.gmusicbrowser/layouts/*.layout\fP
contains layouts definitions
.TP
\fI~/.gmusicbrowser/gmusicbrowser.fifo\fP
can be used to send commands to a running gmusicbrowser,
eg : echo CMD >~/.gmusicbrowser/gmusicbrowser.fifo where CMD is (run "gmusicbrowser \-listcmd" for an up-to-date list of commands) :
.TP
\fBNextSong\fR
Skip current song
.TP
\fBPrevSong\fR
choose previously played song
.TP
\fBPlayPause\fR
toggle Play/Pause mode
.TP
\fBStop\fR
stop playing
.TP
\fBRewind\fR SEC
rewind SEC seconds
.TP
\fBForward\fR SEC
forward SEC seconds
.TP
\fBBrowser\fR
open browser window
.TP
\fBShowHide\fR
hide/show gmusicbrowser windows
.TP
\fBQuit\fR
quit gmusicbrowser
.TP
\fBSave\fR
immediately save settings/song tags in ~/.gmusicbrowser/tags
.TP
\fBChangeDisplay\fR DISPLAY
migrate the program to display DISPLAY (example : ":1")

.SH "SEE ALSO"
http://gmusicbrowser.org/,

.SH "AUTHOR"
Copyright (c) 2005-2011 Quentin Sculo <squentin@free.fr>