Quodlibet-2.6
Total Page:16
File Type:pdf, Size:1020Kb
Ex Falso / Quod Libet Release 2.6.3 November 25, 2015 Contents 1 Table of Contents 3 1.1 Screenshots................................................3 1.2 Downloads................................................3 1.3 Requirements...............................................9 1.4 Features..................................................9 1.5 Changelog................................................ 11 1.6 User Guide................................................ 43 1.7 Development Guide........................................... 75 1.8 Command Manuals............................................ 92 1.9 License & Contributors......................................... 100 1.10 Contact.................................................. 101 i ii Ex Falso / Quod Libet, Release 2.6.3 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 2.6.3 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 Fig. 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 2.6.3 Fig. 1.2: The album browser, giving a visual anchor for a large library Fig. 1.3: Quod Libet’s queue in action, and its handling of multiple browser windows Fig. 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 2.6.3 Fig. 1.5: Quod Libet and Ex Falso also share a powerful file-renaming system Fig. 1.6: Ex Falso, the standalone tagging application Fig. 1.7: Quod Libet and Ex Falso are highly extensible through many included plugins 1.2. Downloads 5 Ex Falso / Quod Libet, Release 2.6.3 • 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.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 Quod Libet 2.5.1 quodlibet-2.5.1.tar.gz Quod Libet Plugins 2.5.1 quodlibet-plugins-2.5.1.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 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 Repos: • Fedora 17 • Fedora 18 • Fedora 19 Unstable Repo: • Fedora 17 • Fedora 18 • Fedora 19 6 Chapter 1. Table of Contents Ex Falso / Quod Libet, Release 2.6.3 1.2.6 openSUSE Stable Repos: • openSUSE 12.1 • openSUSE 12.2 • openSUSE 12.3 • openSUSE Tumbleweed Unstable Repo: • openSUSE 12.1 • openSUSE 12.2 • openSUSE 12.3 • openSUSE Tumbleweed 1.2.7 Windows Release Filename Quod Libet 2.6.3 quodlibet-2.6.3-installer.exe Quod Libet 2.5.1 quodlibet-2.5.1-installer.exe Quod Libet 2.4.1 quodlibet-2.4.1-installer.exe For old releases see the full file listing. 1.2.8 Arch Linux $ pacman -S quodlibet 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: $ cd quodlibet If you want translations, you have to create the gettext translation files: $ ./setup.py build_mo Run Quod Libet or Ex Falso: 1.2. Downloads 7 Ex Falso / Quod Libet, Release 2.6.3 $ ./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 Simple way (using macports) sudo port install quodlibet Hard way (using jhbuild) There is no real Mac port available at the moment but it is possible to get Quod Libet running under Mac OS X using jhbuild. The following steps show roughly what is needed. • Get OS X running. It is possible to run it in VirtualBox. • If you’re using VBox install the sound driver. • Install XCode (check the OS X requirements.. you might need an older version) • Install git. • Get jhbuild running. • Add ~/.local/bin to PATH • jhbuild bootstrap • jhbuild build meta-gtk-osx-bootstrap • jhbuild build meta-gtk-osx-core • jhbuild build pygtk • Build/install mutagen. • There is currently no pygst available in jhbuild, but you can patch in the experimental NSSound backend. • Change QL config to macbe backend. • jhbuild shell • python quodlibet.py • The quartz theme is not really usable, so you might want to: * jhbuild build meta-gtk-osx-themes * copy clealooks gtkrc to .gtkrc-2.0 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. 8 Chapter 1. Table of Contents Ex Falso / Quod Libet, Release 2.6.3 1.3 Requirements 1.3.1 Core Dependencies Quod Libet depends on the Python runtime and associated libraries. • Python (>= 2.6): http://www.python.org • PyGTK (>= 2.16): http://www.pygtk.org • PyGSt (>= 0.10.1): http://gstreamer.freedesktop.org/ or xine-lib (>= 1.1): http://www.xine-project.org/ • Mutagen (>= 1.14): https://mutagen.readthedocs.org/ 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 and its Python bindings. Device support depends on UDisks 1. 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 1.3. Requirements 9 Ex Falso / Quod Libet, Release 2.6.3 • 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.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.