Skip to content
Go to file
This branch is 391 commits ahead, 27 commits behind tigersoldier:master.

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

OSD Lyrics

Show synced lyrics with your favorite media player on Linux.


OSD Lyrics is a desktop application to view lyrics compatible with various media players. It is not a plugin but a standalone program. OSD Lyrics shows lyrics on your desktop, in the style similar to KaraOK. It also provides another displaying style, in which lyrics scroll from bottom to top. OSD Lyrics can download lyrics from the network automatically.

Screenshot in OSD mode


OSD Lyrics is released under GPL v3. See LICENSE for more detail.

How to use

To use OSD Lyrics, just launch your media player, then launch OSD Lyrics. OSD Lyrics will detect and connect to the media player.

How to install

OSD Lyrics is available for Ubuntu in our PPA and for ArchLinux through community repo and through AUR.

Build instructions


On Ubuntu, the following packages need to be installed to compile OSD Lyrics:

  • Python 2.6+/3.4+
  • libdbus-glib-1-dev
  • intltool
  • libappindicator-dev (optional)

Runtime Dependencies

  • Python (either one):
    • Python 2: python (>= 2.6), python-future, python-gi (>= 3.11.1)
    • Python 3: python3 (>= 3.4), python3-future, python3-gi (>= 3.11.1)
  • Supported players:
    • MPRIS2
    • MPRIS
    • MPD: mpd (>= 0.16.0), python-mpd

Cloning repository

You can use git to clone our repository with the latest changes, use the following command:

git clone


After cloning the repository and installing dependencies, issue the following commands at the cloned directory to build and install:

./configure --prefix=/usr PYTHON=/usr/bin/python2
sudo make install

You can read more at Building wiki page.


Check Troubleshooting wiki page for more detailed help.

Contact us

The official source repository is on Github:

If there is any feature request, suggestion, or bug, feel free to report them in issues page.

You can contact the developers for fast support through our discord server.

How to contribute

We adopt GitHub flow for development, this means you can use GitHub issues, projects and pull requests pages to respectively submit bugs/suggestions, take a look at current roadmap/Kanban and submit changes.

You can read more at Contributing wiki page.


Thanks to all the people who have directly or indirectly helped in the development of this project. Special thanks to the original author "Tiger Soldier", first contributors "Sarlmol Apple", "Simply Zhao" and everybody else listed at contributors page.