There exists a newer version of this page and the content below may be outdated. See for the latest documentation.


hg-logo Source

Quod Libet uses Mercurial for source control and is hosted on Google Code as well as Bitbucket:

To clone the repository:

hg clone
hg clone

source-logo 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.

ubuntu-logo Ubuntu

Stable PPA:

$ sudo add-apt-repository ppa:lazka/ppa

Unstable PPA:

$ sudo add-apt-repository ppa:lazka/dumpingplace

debian-logo Debian

Unstable Repo:

deb quodlibet-unstable/

Repo key:

$ sudo apt-key adv --keyserver --recv-keys 0C693B8F

fedora-logo Fedora

Stable Repos:

Unstable Repo:

windows-logo 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.

arch-logo Arch Linux

$ pacman -S quodlibet

source-logo Running from Source

Install mercurial and check out the source:

$ hg clone
$ 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:

$ ./ build_mo

Run Quod Libet or Ex Falso:

$ ./
$ ./

To update to the latest version, switch to the QL dir and run:

$ hg pull --update
$ ./ build_mo # (only if you need translations)

macosx-logo 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
  • 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