8000 GitHub - BrianB3/legato: Reproductor de música de escritorio para Linux en Rust (GTK4/Libadwaita + rodio) · GitHub
[go: up one dir, main page]

Skip to content
BrianB3Public

About

Reproductor de música de escritorio para Linux en Rust (GTK4/Libadwaita + rodio)

Resources

Stars

1 star

Watchers

0 watching

Forks

Latest commit

 

History

10 Commits

Folders and files

Repository files navigation

Legato

Reproductor de música de escritorio para Linux, escrito en Rust con GTK 4 y Libadwaita (vía Relm4). La idea es simple: le apuntás una carpeta y suena. Sin base de datos, sin cuentas, sin sincronización — tus archivos, los tags que ya tienen, y nada más.

Lo armé porque quería algo chico para mi colección local que se viera bien integrado a GNOME y no pesara medio GB en RAM.

Legato

Qué hace

  • Escaneo recursivo de la carpeta que elijas (mp3, flac, ogg, m4a y wav). Recuerda la última carpeta abierta.
  • Vista principal con carátula grande y crossfade, y un acento de color dinámico que sale de la propia tapa.
  • Carátulas: primero la embebida en los tags; si no hay, un cover.jpg/folder.jpg del directorio; y si tampoco, la busca en MusicBrainz + Cover Art Archive (respetando su rate limit, con caché en disco).
  • Letras sincronizadas vía LRCLIB, cacheadas en disco. Si hay LRC, se resalta línea a línea tipo karaoke y un click salta a ese momento.
  • Shuffle y repeat de la cola. El shuffle no corta lo que está sonando.
  • Los archivos multicanal (5.1, 7.1) suenan completos: downmix a estéreo con la matriz estándar ITU, sin perderse el canal central.
  • Integración MPRIS: teclas multimedia, controles de GNOME, carátula y progreso en el reproductor del sistema.
  • Atajos: Espacio play/pausa, Ctrl+F buscar en la cola.

Requisitos

  • Toolchain de Rust reciente (el proyecto usa edition 2024).
  • Dependencias de sistema de GTK 4 y Libadwaita:
# Fedora
sudo dnf install gtk4-devel libadwaita-devel

# Debian/Ubuntu
sudo apt install libgtk-4-dev libadwaita-1-dev

Uso

cargo run --release

Para ver logs:

RUST_LOG=legato=debug cargo run --release

Instalación

Para tenerlo en el menú de aplicaciones con su ícono:

./install.sh

Compila en release y copia el binario a ~/.local/bin/legato, el ícono a ~/.local/share/icons/ y el .desktop a ~/.local/share/applications/.

La caché de carátulas y letras vive en ~/.cache/legato/. Se puede borrar tranquilo, se regenera.

Estructura

src/
├── audio/      motor con rodio en un hilo dedicado; comandos y
│               eventos por canales, nada de estado compartido
├── library/    escaneo de carpetas y lectura de tags (walkdir + lofty)
├── services/   letras, carátulas online, color dominante, MPRIS, caché
├── models/     tipos de dominio puros (Track, PlayQueue)
├── ui/         Relm4: App + NowPlaying + QueuePanel + TrackRow
└── config.rs   última carpeta abierta, en texto plano (XDG config)

La regla de la casa: audio, library, services y models no saben que GTK existe. La UI habla con el motor únicamente por canales, así que nada de lo pesado (decodificar, leer tags, pegarle a una API) toca el hilo de la interfaz.

Tests

cargo test

La lógica que se puede testear sin GTK (cola, shuffle, parser LRC, color dominante, máquina de estados del seek, downmix, cachés) tiene tests al lado del código.

Licencia

MIT. Ver LICENSE.

About

Reproductor de música de escritorio para Linux en Rust (GTK4/Libadwaita + rodio)

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages

0