.. image:: https://img.shields.io/github/actions/workflow/status/quodlibet/quodlibet/main.yml?branch=main
    :target: https://github.com/quodlibet/quodlibet/actions

.. image:: https://readthedocs.org/projects/quodlibet/badge/?version=latest
    :target: https://quodlibet.readthedocs.io

.. image:: https://img.shields.io/codecov/c/github/quodlibet/quodlibet
    :target: https://app.codecov.io/gh/quodlibet/quodlibet

.. image:: https://img.shields.io/github/v/release/quodlibet/quodlibet
    :target: https://github.com/quodlibet/quodlibet/releases

.. image:: https://img.shields.io/github/contributors/quodlibet/quodlibet
    :target: https://github.com/quodlibet/quodlibet/graphs/contributors

.. image:: https://hosted.weblate.org/widgets/quodlibet/-/quodlibet/svg-badge.svg
    :alt: Translation status
    :target: https://hosted.weblate.org/engage/quodlibet/



Quod Libet: an audio library, manager & player
==============================================

.. image:: ./quodlibet/images/hicolor/scalable/apps/io.github.quodlibet.QuodLibet.svg
   :width: 128px
   :alt: Quod Libet logo
   :align: left

`Quod Libet <https://quodlibet.readthedocs.io>`_
is a cross-platform audio / music management program.
It provides many ways to view your local libraries,
and supports streaming audio and podcast feeds.
It has extremely flexible metadata editing and searching capabilities.

With over 90 plugins included, you can extend and integrate with almost anything,
or `write your own <https://quodlibet.readthedocs.io/en/latest/development/plugins.html>`_ in Python!

Quod Libet in action
--------------------

.. figure:: https://github.com/quodlibet/quodlibet/raw/main/docs/images/album-list-2017-08.png
    :align: center

See more `screenshots in the user guide <https://quodlibet.readthedocs.io/en/latest/screenshots.html>`_.

Ex Falso: just the tag editor
-----------------------------

Ex Falso is a bare-bones tag editor with the same editing interface as Quod Libet.


Getting Started
---------------

For information on how to build, install or test Quod Libet (and Ex Falso),
check out the
`development documentation <https://quodlibet.readthedocs.org/en/latest/development/overview.html>`_.

For how to use the apps, consult the `user guide <https://quodlibet.readthedocs.io/en/latest/guide/>`_.


Contact
-------

.. image:: https://img.shields.io/mastodon/follow/109620111805015448?domain=https%3A%2F%2Ffosstodon.org&style=social
    :target: https://fosstodon.org/@quodlibet

.. image:: https://img.shields.io/badge/discord-chat-blue?style=social&logo=discord
    :target: https://discord.gg/9A4RKFEm3c
