There exists a newer version of this page and the content below may be outdated. See https://quodlibet.readthedocs.org/en/latest for the latest documentation.
Explanation of the GUI elements¶
When you start up Quod Libet for the first time, and have configured your library, it should look something a little like the screenshot here, which is show with annotations. These are all explained below.
1. Player Controls¶
Provides buttons for seeking, changing volume and changing the currently played song.
By right-clicking, they also provide context menus with advanced options:
- The volume button lets you choose the active replaygain mode (album, track, automatic).
- The seek button can display the remaining instead of the elapsed time and provides the option to add a bookmark for the current song position.
- The context menu of the play button has an option to pause playback after the current song.
2. Current Song Information¶
Displays information about the currently playing song.
Again, the context menu contains more options, like rating and tag editing for the current song.
There is also an entry called Edit Display... which lets you change everything that is shown in that area, like the file format, bitrate, font size etc. The syntax is the same as for renaming files.
3. The Song List & Browser¶
As the name suggests, the song list is a list of matching songs presented by the current browser. The browser consists of a way to filter your library (songs), e.g. a simple search or by a list of albums. In the image above, no browser is active so only the current song list is shown. You can change the active browser by selecting one in the View menu.
4. Playback Order¶
The active playback order affects the selection of the next song or what happens if you manually switch to a new song.
Note that Play Order Plugins add to this list allowing QL new ways of ordering songs, like following your selection or adding songs to the queue instead of playing them immediately.
The Repeat checkbox can be used in conjunction with the playback orders, to repeat the currently selected view of songs after all song have been played or skipped.
It’s important to note that the playback order will not affect the queue, which has its own playback settings.
5. Song Information¶
The area in the bottom-right corner shows information about all songs in the song list or about your song selection if more than one song is selected.
It also shows progress information of background operations like importing music.
The play queue and the song list determine what’s played next. The queue takes precedence whenever it has songs, but after it’s empty, playback will continue in the main song list where it left off.
To add songs to the queue, right-click and Add to Queue, use the shortcut
CTRL+Return or select songs in a different browser window.
Besides the active browser in the main window, you can open as many different browser windows as you want by selecting one under Music > Browse Library or in the tray icon plugin context menu.
In an separate browser, double-clicking a song will result in it being added to the queue rather than played immediately (as per the main browser).
See the Browsers Guide for full details on browsers and the various implementations.
- Manage playlists by dragging songs across browsers (eg Search browser to Playlist browser)
- Edit the tags of some songs while the ones in the main song list get played etc.
- Check out other songs by the artist currently playing without disturbing that list.
If all your music lives in one folder on your computer, adding your entire music collection in Quod Libet is easy.
From the main menu bar, select Music > Add a Folder and browse to the top-most folder containing your music. By default Quod Libet will scan your selected folder recursively, adding all the songs found to your library automatically. Add more folders if you wish.
You may also check the watch this folder for new songs. If you want to change folder settings later, you can in the preferences window.
Depending on the size of your music collection, it may take a few minutes to perform the initial scan.
The image above shows the plugin manager, from where you can enable / disable / configure all available plugins.