lyse

Terminal synced lyrics viewer for your currently playing music.

Install

Requirements: python, playerctl

AUR install

yay -S lyse 
paru -S lyse # for paru users

Manual install

Install playerctl

sudo pacman -S playerctl  # Arch
sudo apt install playerctl  # Debian/Ubuntu

Run lyse

git clone https://github.com/snoowfall/lyse.git --depth 1
cd lyse
chmod +x lyse.py
./lyse.py

Tip

Run lyse -h to see additional arguments.

Keys

• q - quit
• j/k - adjust sync offset
• u - toggle UI
• b - toggle bold active
• c - toggle centered
• d - toggle dynamic colors
• i - toggle dim inactive
• </> - seek 5 seconds
• shift+u - toggle uppercase
  

Miscellanous

Settings auto-save to ~/.config/lyse/settings.json
Reset all settings: lyse --reset

© 2026 snoowfall |This documentation is licensed under CC BY-NC 4.0. Do not reuse without permission.