▶ Python · Terminal · Open Source

LYRICLI

Letras sincronizadas de cualquier canción,
directamente en tu terminal. Automático.

Compatible con Windows · Linux

lyricli — python

$ python lyrics.py

✓ Detectando reproductor...

✓ Artista: Radiohead — Creep

✓ Letras sincronizadas obtenidas. 47 líneas


♪ I don't care if it hurts

♪ I want to have control

♪ I want a perfect body

♪ I want a perfect soul

♪ I want you to notice


─────────────────── 2:14 / 3:58

Karaoke en tu
terminal.

LyriCLI detecta automáticamente la canción que estás escuchando, busca las letras en lrclib.net y las muestra sincronizadas en tiempo real directamente en tu terminal. Sin interfaces. Sin configuración extra. Solo Python.

Auto-detección

Compatible con Windows Media Session y MPRIS en Linux. Detecta lo que suena sin que hagas nada.

🎵

Letras sincronizadas

Usa el formato LRC con timestamps precisos. Cada línea aparece exactamente cuando toca.

🖥️

100% terminal

Renderizado con Rich. Tipografía grande, colores neón y efecto glitch al cambiar de línea.

🔄

Cambia de canción

Detecta el cambio automáticamente y carga las nuevas letras sin reiniciar nada.

Instálalo en
minutos.

Solo necesitas Python 3.8+ y un reproductor de música corriendo.

01

Instala Python

Descarga Python desde python.org y durante la instalación activa la casilla Add Python to PATH. Luego verifica en PowerShell:

python --version
pip --version
02

Descarga el proyecto

Con Git:

git clone https://github.com/Gmsus4/lyricli.git
cd lyricli

Sin Git, descarga el ZIP desde GitHub: Code → Download ZIP, extrae la carpeta y abre PowerShell dentro de ella.

03

Instala las dependencias

pip install requests rich pyfiglet
pip install winrt-Windows.Media.Control
pip install winrt-Windows.Foundation winrt-Windows.Foundation.Collections
04

Ejecuta LyriCLI

Abre Spotify o cualquier reproductor y corre:

python lyrics.py

python no se reconoce como comando

Python no está en el PATH. Reinstala marcando Add Python to PATH, o prueba con py lyrics.py.

No detecta Spotify o la canción actual

Verifica que instalaste los paquetes winrt-*. Intenta pausar y reproducir de nuevo, o cambiar de canción.

No encuentra la letra

La canción puede no estar en lrclib.net. Prueba en modo manual con --artist y --title.

La terminal se ve rara

Usa Windows Terminal en pantalla completa. Las consolas antiguas no renderizan bien colores ni caracteres grandes.