Scroll to navigation

gmusicbrowser(1) gmusicbrowser(1)

NAME

gmusicbrowser - Jukebox for large collections of music files

SYNOPSIS

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

gmusicbrowser -listcmd

gmusicbrowser -tagedit FOLDER_OR_FILE ...

DESCRIPTION

This manual page explains the gmusicbrowser program.

gmusicbrowser can play and manage your songs, currently supports mp3, ogg, flac, mpc file formats. see http://gmusicbrowser.sourceforge.net/ for more information.

OPTIONS

don't check for updated/deleted songs on startup
don't scan folders for songs on startup
don't save settings/tags on exit
prevent modifying/renaming/deleting song files
prevent modifying tags of music files
start playing on startup
do not load any gstreamer librairies
prefer gstreamer-0.10 over gstreamer-1.x if both are available
do not use DBus
send playing song to connected icecast client
listen for connection on port N in icecast server mode
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/
use FIFO as named pipe to receive commans (instead of 'gmusicbrowser.fifo' in default folder)
do not use/create named pipe
append .KEY to the DBus service id used by gmusicbrowser (org.gmusicbrowser)
print some info, like the file being played
print lots of useless information, implies -verbose
print a backtrace for every warning
use layout NAME for player window
deactivate plugin identified by NAME
+plugin NAME
activate plugin identified by NAME
deactivate all plugins
add FOLDER to the list of folders searched for plugins and layouts
Use gnome libraries to save tags/settings on session logout (needs the Gnome2 perl module).
Move initial window to workspace N (needs the Gnome2::Wnck perl module).
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
change behavior when no running gmusicbrowser instance is found, MODE can be one of :
(default) launch a new instance and execute commands
launch a new instance but discard commands
do nothing
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.

list the available commands and exit
list the available layouts and exit
list the available plugins and exit
Load songs in FOLDER_OR_FILE and display a dialog to edit their tags.

FILES

~/.gmusicbrowser/tags
contains songs tags and program options
/usr/share/gmusicbrowser/plugins/, ~/.gmusicbrowser/plugins/
files with extension .pm in these folders are loaded as plugins on startup
/usr/share/gmusicbrowser/layouts/*.layout, ~/.gmusicbrowser/layouts/*.layout
contains layouts definitions
~/.gmusicbrowser/gmusicbrowser.fifo
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) :
Skip current song
choose previously played song
toggle Play/Pause mode
stop playing
rewind SEC seconds
forward SEC seconds
open browser window
hide/show gmusicbrowser windows
quit gmusicbrowser
immediately save settings/song tags in ~/.gmusicbrowser/tags
migrate the program to display DISPLAY (example : ":1")

SEE ALSO

http://gmusicbrowser.org/,

AUTHOR

Copyright (c) 2005-2015 Quentin Sculo <squentin@free.fr>

October 8, 2011 gmusicbrowser