LITT

LITT (Lyrics in the Terminal) is, as the name suggests, a way to display lyrics of the currently playing song in the terminal. Note that this tool currently only supports linux as it uses playerctl but it may be expanded to multiple operating systems in the future.

Requirements

• Linux
• playerctl
• A non Firefox source
  • Firefox does not work correctly at the moment. May be fixed in the future

Install playerctl with our distros package manager:

# Debian / Debian-based
sudo apt install playerctl

# Fedora / Fedora-based
sudo dnf install playerctl

# Arch / Arch-based
sudo pacman -S playerctl

Installation

The following commands will automatically install uv and LITT

curl -LsSf https://astral.sh/uv/install.sh | sh
uv tool install litt

Usage

To use LITT start any song (Spotify/YouTube) and run litt LITT will then list currently playing sources and you can choose one.

To access the settings run litt --settings The setings include:

• Font Size
• Custom Font
• Text Style

Keybinds

The following keybinds can be used:

, - Decrease Lyrics Size
. - Increase Lyrics Size
r - Re-Display Lyrics
R - Re-Fetch Lyrics
q - Quit

Building from source

Prerequisites

• python (with pip)
• git/(gh)

1. Clone GitHub repository

git clone https://github.com/FabBeyond/litt.git
cd litt

2. Set up a virtual environment

python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

3. Run the program

python3 src/litt/main.py

Credits

• syncedlyrics
• Noto-CJK