Quodlibet-3.1
Total Page:16
File Type:pdf, Size:1020Kb
Ex Falso / Quod Libet Release 3.1.2 June 20, 2014 Contents 1 Table of Contents 3 1.1 Screenshots................................................3 1.2 Downloads................................................3 1.3 Requirements...............................................8 1.4 Features..................................................9 1.5 Changelog................................................ 11 1.6 User Guide................................................ 45 1.7 Development Guide........................................... 78 1.8 Command Manuals............................................ 96 1.9 License & Contributors......................................... 105 1.10 Contact.................................................. 106 i ii Ex Falso / Quod Libet, Release 3.1.2 Note: 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. Quod Libet is a GTK+-based audio player written in Python, using the Mutagen tagging library. It’s designed around the idea that you know how to organize your music better than we do. It lets you make playlists based on regular expressions (don’t worry, regular searches work too). It lets you display and edit any tags you want in the file, for all the file formats it supports. Unlike some, Quod Libet will scale to libraries with tens of thousands of songs. It also supports most of the features you’d expect from a modern media player: Unicode support, advanced tag editing, Replay Gain, podcasts & internet radio, album art support and all major audio formats - see the screenshots. Ex Falso is a program that uses the same tag editing back-end as Quod Libet, but isn’t connected to an audio player. If you’re perfectly happy with your favorite player and just want something that can handle tagging, Ex Falso is for you. Contents 1 Ex Falso / Quod Libet, Release 3.1.2 2 Contents CHAPTER 1 Table of Contents Note: 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. 1.1 Screenshots Figure 1.1: The paned browser, providing a customizable hierarchy of filters for finding your music Note: 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. 1.2 Downloads 1.2.1 Source Quod Libet uses Mercurial for source control and is hosted on Google Code as well as Bitbucket: • https://code.google.com/p/quodlibet 3 Ex Falso / Quod Libet, Release 3.1.2 Figure 1.2: The album browser, giving a visual anchor for a large library Figure 1.3: Quod Libet’s queue in action, and its handling of multiple browser windows Figure 1.4: The powerful and feature-rich tag editor interface, shared by Quod Libet and Ex Falso, that gives you the freedom to tag your music how you see fit 4 Chapter 1. Table of Contents Ex Falso / Quod Libet, Release 3.1.2 Figure 1.5: Quod Libet and Ex Falso also share a powerful file-renaming system Figure 1.6: Ex Falso, the standalone tagging application Figure 1.7: Quod Libet and Ex Falso are highly extensible through many included plugins 1.2. Downloads 5 Ex Falso / Quod Libet, Release 3.1.2 • https://bitbucket.org/lazka/quodlibet To clone the repository: hg clone https://code.google.com/p/quodlibet hg clone https://bitbucket.org/lazka/quodlibet 1.2.2 Release Tarballs Release Filename Quod Libet 3.1.1 quodlibet-3.1.1.tar.gz Quod Libet Plugins 3.1.1 quodlibet-plugins-3.1.1.tar.gz Quod Libet 3.0.2 quodlibet-3.0.2.tar.gz Quod Libet Plugins 3.0.2 quodlibet-plugins-3.0.2.tar.gz Quod Libet 2.6.3 quodlibet-2.6.3.tar.gz Quod Libet Plugins 2.6.3 quodlibet-plugins-2.6.3.tar.gz For old releases see the full file listing. 1.2.3 Ubuntu Stable PPA: $ sudo add-apt-repository ppa:lazka/ppa Unstable PPA: $ sudo add-apt-repository ppa:lazka/dumpingplace Note: Quod Libet 3.x supports Ubuntu 12.04, but needs some updated dependencies that you’ll need to install separately: • The GStreamer Developer PPA for GStreamer 1.0. • (optional) Ubuntu 12.10 packages of both gir1.2-keybinder-3.0 and libkeybinder-3.0-0 for multimedia key sup- port under non GNOME environments. 1.2.4 Debian Unstable Repo: deb http://www.student.tugraz.at/christoph.reiter/debian/ quodlibet-unstable/ Repo key: $ sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys 0C693B8F 1.2.5 Fedora Stable Repo: • Fedora 19 • Fedora 20 6 Chapter 1. Table of Contents Ex Falso / Quod Libet, Release 3.1.2 Unstable Repo: • Fedora 19 • Fedora 20 1.2.6 openSUSE Stable Repo: • openSUSE 12.3 • openSUSE 13.1 • openSUSE Tumbleweed Unstable Repo: • openSUSE 12.3 • openSUSE 13.1 • openSUSE Tumbleweed 1.2.7 Windows Release Filename Quod Libet 3.1.1 quodlibet-3.1.1-installer.exe Quod Libet 3.1.1 (portable) quodlibet-3.1.1-portable.exe Quod Libet 2.6.3 quodlibet-2.6.3-installer.exe Quod Libet 2.6.3 (portable) quodlibet-2.6.3-portable.exe For old releases see the full file listing. 1.2.8 Arch Linux Stable: $ pacman -S quodlibet Unstable: See quodlibet-hg in the AUR. 1.2.9 Running from Source Install mercurial and check out the source: $ hg clone https://code.google.com/p/quodlibet/ $ cd quodlibet QL/EF expects the plugins to be in “~/.quodlibet/plugins” so create a symlink: $ mkdir ~/.quodlibet $ ln -s $(readlink -f plugins) ~/.quodlibet/plugins Now switch to the real QL folder: 1.2. Downloads 7 Ex Falso / Quod Libet, Release 3.1.2 $ cd quodlibet If you want translations, you have to create the gettext translation files: $ ./setup.py build_mo Run Quod Libet or Ex Falso: $ ./quodlibet.py $ ./exfalso.py To update to the latest version, switch to the QL dir and run: $ hg pull --update $ ./setup.py build_mo # (only if you need translations) 1.2.10 Mac OS X sudo port install quodlibet Note: 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. 1.3 Requirements 1.3.1 Core Dependencies Quod Libet depends on the Python runtime and associated libraries. • Python (>= 2.6) • PyGObject (>= 3.2) • GStreamer (>= 1.0) or xine-lib (>= 1.1): • Mutagen (>= 1.14): Particular audio formats depend on various GStreamer decoding elements, as well as other Python modules. GStreamer splits their downlads into ‘’good’‘, ‘’bad’‘, ‘’ugly’‘, and ‘’ffmpeg’‘ packages, each of which contains elements; you probably want them all. 1.3.2 Additional Features Audio Feed support depends on HTTP support and Universal Feed Parser. Many parts of Quod Libet benefit from D-Bus and its Python bindings. iPod support depends on libgpod. Device support depends on UDisks 1. 8 Chapter 1. Table of Contents Ex Falso / Quod Libet, Release 3.1.2 1.3.3 Plugins Part of Quod Libet’s strength is in its rich array of plugins to extend the base functionality and interface with other systems. Some of these depend on libraries of their own. If you don’t have these, the plugin manager will catch these errors and disable the plugin to avoid errors in QL itself, and present them in the plugins error section. Once you’ve installed the libraries, the plugins should work as expected. Some notable examples: • The auto library update plugin depends on pynotify • Zeitgeist plugin depends on the python zeitgeist bindings Note: 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. 1.4 Features 1.4.1 Audio Playback • Multiple audio back-ends (GStreamer, xine-lib) • Replay Gain support • Auto-selects between ‘track’ and ‘album’ mode based on current view and play order • Applies clipping prevention whenever available • Configurable default (fallback) and pre-amp values to suit any audio setup • Multimedia key support • Real shuffle mode, that plays the whole playlist before repeating • Weighted (by rating) random playback • Proper ‘Previous’ support in shuffle mode • A play queue • Bookmarks within files (or playlists, with a plugin) 1.4.2 Editing Tags • Full Unicode support • Make changes to many files at once • Make changes across all supported file formats • Tag files based on their filenames with configurable formats • Rename files based on their tags • No ugly %a, %t patterns - more readable <artist>, <title> instead • Fast track renumbering • See full instructions at Editing Tags 1.4. Features 9 Ex Falso / Quod Libet, Release 3.1.2 1.4.3 Audio Library • Watch directories and automatically add/remove new music • Hide songs on removable devices that may not always be there • Save song ratings and play counts • Lyrics downloading and saving • Internet Radio (“Shoutcast”) support • Audio Feeds (“Podcast”) support 1.4.4 User Interface • Simple user interface to Just Play Music if you want • Useful as a small window or maximized, no feeling cramped or wasted space • Album cover display • Full player control from a tray icon • Recognize and display many uncommon tags, as well as any others you want. Especially useful for classical music. 1.4.5 Library Browsing • Simple or regular-expression based search • Constructed playlists • iTunes/Rhythmbox-like paned browser, but with any tags you want (Genre, Date, etc) • Album list with cover art • By directory, including songs not in your library 1.4.6 Python-based plugins • Automatic tagging via MusicBrainz and CDDB • On-screen display popups • Last.fm/AudioScrobbler submission • Tag character encoding conversion • Intelligent title-casing of tags • Find (and examine / remove) near-duplicate songs across your entire collection • Audio fingerprinting of music • Control Logitech Squeezebox devices.