gmusicbrowser(1)														  gmusicbrowser(1)

NAME

       gmusicbrowser - Jukebox for large collections of music files

SYNOPSIS

       gmusicbrowser  [-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 ...

       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.source-
       forge.net/ for more information.

OPTIONS

       -c, -nocheck
	      don't check for updated/deleted songs on startup

       -s, -noscan
	      don't scan folders for songs on startup

       -demo  don't save settings/tags on exit

       -ro    prevent modifying/renaming/deleting song files

       -rotags
	      prevent modifying tags of music files

       -play  start playing on startup

       -gst   use gstreamer

       -nogst do not use gstreamer

       -nodbus
	      do not use DBus

       -server
	      send playing song to connected icecast client

       -port N
	      listen for connection on port N in icecast server mode

       -C FILE, -cfg FILE
	      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/

       -F FIFO, -fifo FIFO
	      use FIFO as named pipe to receive commans (instead of 'gmusicbrowser.fifo' in default folder)

       -nofifo
	      do not use/create named pipe

       -dbus-id KEY
	      append .KEY to the DBus service id used by gmusicbrowser (org.gmusicbrowser)

       -debug print lots of useless information

       -backtrace
	      print a backtrace for every warning

       -l NAME, -layout NAME
	      use layout NAME for player window

       -plugin NAME
	      deactivate plugin identified by NAME

       +plugin NAME
	      activate plugin identified by NAME

       -noplugins
	      deactivate all plugins

       -searchpath FOLDER
	      add FOLDER to the list of folders searched for plugins and layouts

       -use-gnome-session
	      Use gnome libraries to save tags/settings on session logout (needs the Gnome2 perl module).

       -workspace N
	      Move initial window to workspace N (needs the Gnome2::Wnck perl module).

       -cmd CMD
	      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

       -ifnotrunning MODE
	      change behavior when no running gmusicbrowser instance is found, MODE can be one of :

	      normal (default) launch a new instance and execute commands

	      nocmd  launch a new instance but discard commands

	      abort  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.

       -listcmd
	      list the available commands and exit

       -listlayout
	      list the available layouts and exit

       -listplugin
	      list the available plugins and exit

       -tagedit FOLDER_OR_FILE ...
	      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 "gmu-
	      sicbrowser -listcmd" for an up-to-date list of commands) :

       NextSong
	      Skip current song

       PrevSong
	      choose previously played song

       PlayPause
	      toggle Play/Pause mode

       Stop   stop playing

       Rewind SEC
	      rewind SEC seconds

       Forward SEC
	      forward SEC seconds

       Browser
	      open browser window

       ShowHide
	      hide/show gmusicbrowser windows

       Quit   quit gmusicbrowser

       Save   immediately save settings/song tags in ~/.gmusicbrowser/tags

       ChangeDisplay DISPLAY
	      migrate the program to display DISPLAY (example : ":1")

SEE ALSO

       http://gmusicbrowser.org/,

AUTHOR

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

gmusicbrowser							   Oct 08, 2011 						  gmusicbrowser(1)