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
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)
- Clone GitHub repository
git clone https://github.com/FabBeyond/litt.git
cd litt
- Set up a virtual environment
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
- Run the program
python3 src/litt/main.py
Credits
1 maintainer
Metadata
1 maintainer
Release files for litt 0.3.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| litt-0.3.0.tar.gz | 15.5 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| litt-0.3.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 31.0 MB
Release files / litt-0.3.0.tar.gz
| Download URL | litt-0.3.0.tar.gz |
|---|---|
| Size | 15.5 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
0e4bba48b18daf5c0ec9f69cbc283cf749fa703ebbc13532e9e19903a85ca5ea
|
|
BLAKE2b-256 checksum How to use checksums |
9438efaec2eec099fe8b8891e4296803a78e6f19ca7ef9c72bed10da5162f0b5
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 26, 2026.
Transparency logRelease files / litt-0.3.0-py3-none-any.whl
| Download URL | litt-0.3.0-py3-none-any.whl |
|---|---|
| Size | 15.5 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
f94279ba2b4b156a7d3e36a545886b0aeccb24b4503003d71ac176a0970a52b3
|
|
BLAKE2b-256 checksum How to use checksums |
9bbf3d33ae453e3d6ea4d68d4c5dbf5d15cd5fa12dfa3db3879a599c6e684ad7
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 26, 2026.
Transparency log
