rhythmbox
Play and manage music files
SYNOPSIS
rhythmbox [OPTION...] [FILE...]
Launches the Rhythmbox music player application, optionally opening specific files or performing immediate actions.
PARAMETERS
--help, -h
Displays the command's help message, listing available options.
--help-all
Shows all help options, including GTK+ specific ones.
--help-gtk
Shows GTK+ Toolkit options specific to graphical applications.
--debug, -d
Enables detailed debugging output in the terminal, useful for troubleshooting.
--no-daemon
Prevents Rhythmbox from running in daemon mode (background service), causing it to exit when the window is closed.
--no-present
Prevents the Rhythmbox window from automatically being raised to the front upon launch or action.
--play
Starts playback of the current song or resumes paused playback. If Rhythmbox is not running, it will launch and then play.
--pause
Pauses the currently playing song. If Rhythmbox is not running, it will launch paused.
--next
Skips to the next song in the current playlist or queue.
--previous
Skips to the previous song in the current playlist or queue.
--stop
Stops the current playback.
--toggle-play
Toggles between play and pause states.
--volume-up
Increases the playback volume.
--volume-down
Decreases the playback volume.
--set-volume=VOLUME
Sets the playback volume to a specific level, where VOLUME is a value between 0 and 10.
--quit
Quits the running Rhythmbox application.
--minimize
Minimizes the Rhythmbox application window to the taskbar or dock.
--hide
Hides the Rhythmbox application window, making it invisible but still running.
--show
Shows a hidden or minimized Rhythmbox application window.
--open-location=LOCATION
Opens and plays media from a specified URI (e.g., a web radio stream or local file path).
--enqueue=FILE
Adds a specified media FILE to the current play queue without immediately starting playback.
--clear-queue
Clears all songs from the current play queue.
--version, -v
Displays the installed version of Rhythmbox.
--display=DISPLAY
Specifies the X display to use for the application, useful in multi-display or remote X environments.
[FILE...]
One or more media files specified by their paths. Rhythmbox will open and enqueue these files upon launch.
DESCRIPTION
Rhythmbox is a free and open-source audio player designed for the GNOME desktop environment. Modeled after Apple's iTunes, it aims to provide an easy-to-use application for managing and playing digital music. It supports a wide array of audio formats through GStreamer, including MP3, Ogg Vorbis, FLAC, and WAV. Rhythmbox excels at managing large music libraries, allowing users to organize music by artist, album, genre, and more. Key features include playlist creation, internet radio streaming, podcast subscriptions, and audio CD playback/ripping. It also supports integration with various portable music devices and comes with a robust plugin architecture, extending its functionality to include features like Last.fm scrobbling, MPRIS D-Bus integration, and web remote control.
CAVEATS
While the rhythmbox command itself accepts playback control options (--play, --next, --quit, etc.), using rhythmbox-client is generally recommended for controlling an already running instance of Rhythmbox, as it directly communicates with the running daemon without launching a new GUI instance.
<I>CLIENT-SERVER MODEL AND D-BUS INTEGRATION</I>
Rhythmbox operates primarily as a daemon (background service) that can be controlled via its graphical interface or command-line tools. This is facilitated by D-Bus, an inter-process communication system, which allows rhythmbox-client and other applications to interact with a running Rhythmbox instance. This client-server model ensures efficient control and integration within the desktop environment.
<I>PLUGIN ARCHITECTURE</I>
A significant strength of Rhythmbox is its extensive plugin system. This allows third-party developers to extend its functionality, adding support for new features like lyrics display, remote control via a web browser, MPRIS support for media keys, integration with online music services, and more.
HISTORY
Rhythmbox was first released in 2003, making it a long-standing component of the GNOME desktop. It was developed to integrate deeply with the GNOME environment and its multimedia frameworks like GStreamer. Over the years, it has evolved significantly, adding support for various online services, portable devices, and extensive plugin capabilities, becoming a staple music player for many Linux distributions.