Awesome Open Source
Awesome Open Source

MPRISLyrics ko-fi

Small command-line utility that displays lyrics in sync with the currently playing song in a MPRIS2 capable player.

Preview of the project

This screenshot is courtesy of @SantX27

Before you download

Please note: I am only challenging myself here, and I wanted a lyrics visualizer that can run on a terminal.

Don't spam for ETAs (eg. for a certain lyrics provider) or update requests.

If you like the idea you can always contribute to it (pull requests are VERY welcome), fork it and maintain it, rewrite it in another language.

And finally, please note that when my interest in this project will be over, it will be over. There's no way around it, sadly.


This project relies on Playerctl, a CLI tool that can remotely control MPRIS-capable players. You can get it here.

You will also need PHP (>= 7.1) and cURL extension for PHP (php-curl)

Using the project

Before using MPRISLyrics, please check if your music player is listed and supported: click here

If you don't find your music player you can still test if it works and then make a PR to include it in the compatibility sheet.

Using a packaged build (recommended)

mkdir MPRISLyrics && cd MPRISLyrics
wget -o MPRISLyrics.phar
wget -o
chmod +x # if you encounter problems running the start script

From source

git clone
cd MPRISLyrics
chmod +x # if you encounter problems running the start script

Apache 2.0 License

Copyright 2018 Anthony Calabretta

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
See the License for the specific language governing permissions and
limitations under the License.

Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
php (15,091
cli (1,466
command-line (448
tool (327
music-player (141
lyrics (37
command-line-app (23

Find Open Source By Browsing 7,000 Topics Across 59 Categories