https://github.com/rainaisntbald/waybar_lyrics
A simple waybar lyric module
https://github.com/rainaisntbald/waybar_lyrics
linux lyrics lyrics-fetcher minimalist music playerctl shell simple waybar wayland
Last synced: 2 months ago
JSON representation
A simple waybar lyric module
- Host: GitHub
- URL: https://github.com/rainaisntbald/waybar_lyrics
- Owner: rainaisntbald
- License: unlicense
- Created: 2025-06-04T23:43:19.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-06-07T15:19:53.000Z (about 1 year ago)
- Last Synced: 2025-08-16T12:54:52.747Z (11 months ago)
- Topics: linux, lyrics, lyrics-fetcher, minimalist, music, playerctl, shell, simple, waybar, wayland
- Language: Shell
- Homepage:
- Size: 13.7 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Waybar Lyrics
An extremely simple waybar lyric displayer
## How does it work?
It fetches the lyrics using the API at https://lrclib.net/ for the currently playing song (according to playerctl) and, if they are found, displays them at the correct time using the timestamps available.
## How do I use it?
- Download the lyrics.sh script, place it somewhere safe, and `chmod +x lyrics.sh` it
- Add something along the lines of the following as a waybar module:
```json
"custom/lyrics": {
"exec": "stdbuf -oL /path/to/lyrics.sh",
"format": "{}"
},
```
- Add the module to your waybar's config
- You now have lyrics!
- You can go into the lyrics.sh to adjust the maximum characters it will show if it appears too long on your waybar
## What does it depend on?
It relies on playerctl to fetch the current track being played, jq to parse the json response, and an internet connection to fetch the lyrics.
## It isn't working!
Feel free to make an issue - I can try to provide assistance or improve the script to work more generally!