1gmusicbrowser(1)                                              gmusicbrowser(1)
2
3
4

NAME

6       gmusicbrowser - Jukebox for large collections of music files
7
8

SYNOPSIS

10       gmusicbrowser  [-nocheck]  [-noscan]  [-demo]  [-ro]  [-rotags] [-play]
11       [-nodbus]  [-gst0|-nogst]  [-server]  [-port  N]  [-cfg  FILE]   [-fifo
12       FIFO|-nofifo]   [-debug]   [-verbose]  [-layout  NAME]  [-plugin  NAME]
13       [-searchpath FOLDER] [-use-gnome-session]  [-workspace  N]  [-cmd  CMD]
14       [-ifnotrunning MODE] [-dbus-id KEY] FOLDER_OR_FILE ...
15
16       gmusicbrowser -listcmd
17
18       gmusicbrowser -tagedit FOLDER_OR_FILE ...
19
20

DESCRIPTION

22       This manual page explains the gmusicbrowser program.
23
24       gmusicbrowser  can  play and manage your songs, currently supports mp3,
25       ogg, flac, mpc file formats.  see http://gmusicbrowser.sourceforge.net/
26       for more information.
27

OPTIONS

29       -c, -nocheck
30              don't check for updated/deleted songs on startup
31
32       -s, -noscan
33              don't scan folders for songs on startup
34
35       -demo  don't save settings/tags on exit
36
37       -ro    prevent modifying/renaming/deleting song files
38
39       -rotags
40              prevent modifying tags of music files
41
42       -play  start playing on startup
43
44       -nogst do not load any gstreamer librairies
45
46       -gst0  prefer gstreamer-0.10 over gstreamer-1.x if both are available
47
48       -nodbus
49              do not use DBus
50
51       -server
52              send playing song to connected icecast client
53
54       -port N
55              listen for connection on port N in icecast server mode
56
57       -C FILE, -cfg FILE
58              use  FILE  as  configuration file (instead of 'gmbrc' in default
59              folder), if FILE is a folder (or ends with '/'), it will be used
60              as base folder instead of ~/.config/gmusicbrowser/
61
62       -F FIFO, -fifo FIFO
63              use  FIFO  as  named  pipe  to receive commans (instead of 'gmu‐
64              sicbrowser.fifo' in default folder)
65
66       -nofifo
67              do not use/create named pipe
68
69       -dbus-id KEY
70              append .KEY  to  the  DBus  service  id  used  by  gmusicbrowser
71              (org.gmusicbrowser)
72
73       -verbose
74              print some info, like the file being played
75
76       -debug print lots of useless information, implies -verbose
77
78       -backtrace
79              print a backtrace for every warning
80
81       -l NAME, -layout NAME
82              use layout NAME for player window
83
84       -plugin NAME
85              deactivate plugin identified by NAME
86
87       +plugin NAME
88              activate plugin identified by NAME
89
90       -noplugins
91              deactivate all plugins
92
93       -searchpath FOLDER
94              add  FOLDER to the list of folders searched for plugins and lay‐
95              outs
96
97       -use-gnome-session
98              Use gnome libraries to  save  tags/settings  on  session  logout
99              (needs the Gnome2 perl module).
100
101       -workspace N
102              Move  initial window to workspace N (needs the Gnome2::Wnck perl
103              module).
104
105       -cmd CMD
106              add CMD to the  list  of  commands  to  execute.  If  a  running
107              instance  of gmusicbrowser is found, these commands will be sent
108              via the fifo file or via DBus. If there is no  running  instance
109              of gmusicbrowser, the behavior depends on option -ifnotrunning
110
111
112       -ifnotrunning MODE
113              change behavior when no running gmusicbrowser instance is found,
114              MODE can be one of :
115
116              normal (default) launch a new instance and execute commands
117
118              nocmd  launch a new instance but discard commands
119
120              abort  do nothing
121              Running instances of gmusicbrowser are detected via the fifo  or
122              via  DBus.  To run more than one instance, use a unique fifo and
123              a unique DBus-id, or deactivate them.
124
125
126       -listcmd
127              list the available commands and exit
128
129       -listlayout
130              list the available layouts and exit
131
132       -listplugin
133              list the available plugins and exit
134
135       -tagedit FOLDER_OR_FILE ...
136              Load songs in FOLDER_OR_FILE and display a dialog to edit  their
137              tags.
138
139

FILES

141       ~/.gmusicbrowser/tags
142              contains songs tags and program options
143
144       /usr/share/gmusicbrowser/plugins/, ~/.gmusicbrowser/plugins/
145              files  with extension .pm in these folders are loaded as plugins
146              on startup
147
148       /usr/share/gmusicbrowser/layouts/*.layout,        ~/.gmusicbrowser/lay‐
149       outs/*.layout
150              contains layouts definitions
151
152       ~/.gmusicbrowser/gmusicbrowser.fifo
153              can  be  used  to send commands to a running gmusicbrowser, eg :
154              echo CMD >~/.gmusicbrowser/gmusicbrowser.fifo where CMD is  (run
155              "gmusicbrowser -listcmd" for an up-to-date list of commands) :
156
157       NextSong
158              Skip current song
159
160       PrevSong
161              choose previously played song
162
163       PlayPause
164              toggle Play/Pause mode
165
166       Stop   stop playing
167
168       Rewind SEC
169              rewind SEC seconds
170
171       Forward SEC
172              forward SEC seconds
173
174       Browser
175              open browser window
176
177       ShowHide
178              hide/show gmusicbrowser windows
179
180       Quit   quit gmusicbrowser
181
182       Save   immediately save settings/song tags in ~/.gmusicbrowser/tags
183
184       ChangeDisplay DISPLAY
185              migrate the program to display DISPLAY (example : ":1")
186
187

SEE ALSO

189       http://gmusicbrowser.org/,
190
191

AUTHOR

193       Copyright (c) 2005-2015 Quentin Sculo <squentin@free.fr>
194
195
196
197gmusicbrowser                    Oct 08, 2011                 gmusicbrowser(1)