- TypeScript 38.3%
- Rust 34.3%
- HTML 20.1%
- SCSS 6.2%
- Python 0.9%
- Other 0.2%
| Filename | Latest commit message | Latest commit date |
|---|---|---|
| .agents/skills | ||
| .forgejo/workflows | ||
| .vscode | ||
| design | ||
| docs | ||
| e2e | ||
| odd/tasks | ||
| scripts | ||
| src | ||
| src-tauri | ||
| .gitignore | ||
| AGENTS.md | ||
| angular.json | ||
| CHANGELOG.md | ||
| cog.toml | ||
| package-lock.json | ||
| package.json | ||
| playwright.config.ts | ||
| README.md | ||
| RELEASE_WORKFLOW.md | ||
| tsconfig.app.json | ||
| tsconfig.json | ||
| tsconfig.spec.json | ||
G-Music
Reproductor de música nativo para Linux: local-first, con Navidrome (Subsonic/OpenSubsonic) como extensión. La referencia de producto es MusicBee — se copia su estructura y su comportamiento, nunca su código ni sus assets.
Tauri 2 (Rust) + Angular 22 (signals, standalone) + rodio/symphonia + lofty.
La regla que ordena la UI: sin sidebar global. Se navega con la barra de pestañas y cada panel trae su propio riel, su índice A-Z y su menú — como el original. Tabla de tracks ordenable, panel de cola a la derecha y barra de reproducción abajo.
Qué hace hoy
| Área | Funcionalidad |
|---|---|
| Biblioteca local | Escaneo de varias carpetas con tags (lofty) y base SQLite con paginado, filtro, orden y agrupación en SQL; filtro instantáneo con prefijos por campo (artist:, album:…), orden por columnas con columnas configurables, agrupación por artista/álbum/género con jerarquía editable de géneros, índice A-Z, ratings ★ 0-5 en tabla propia (no se escriben en los archivos y un re-escaneo no los borra), estadísticas de reproducción y skips |
| Reproducción | Cola con play-next/enqueue, reordenar, quitar, seek, shuffle, repeat off/all/one; EQ de 10 bandas con presets y modo automático por género; crossfade 0-12 s; ReplayGain track/album con pre-amp; volumen, cola y última pestaña persistidos; si se muere el dispositivo de audio, el tema se reanuda solo en la posición donde estaba |
| Audio | Elección de dispositivo de salida (con caída al default si el guardado ya no existe); rate nativo del archivo cuando el dispositivo lo anuncia; modo exclusivo por ALSA hw: (sin mixer, sin resample, sin EQ: bit-perfect de verdad); multicanal con downmix documentado a estéreo y passthrough AC-3/DTS sólo si el dispositivo anuncia IEC 958; la verdad del flujo (dispositivo, rate, canales, si hubo conversión) se muestra en Preferencias → Audio |
| Formatos | mp3, flac, wav, ogg/oga, opus (nativo), m4a/m4b (aac/alac), aac, aiff, caf, mka; wma/ape/ofr/tta/spx/mpc vía ffmpeg del sistema |
| DJ | Dos platos con crossfader de curva equal-power, corte de graves por plato, lista propia por plato (temas o listas hechas), forma de onda del archivo por plato y un piloto automático que elige con las reglas de Auto-DJ y cruza solo, sin tocar tu cola |
| Playlists | Del server (crear, renombrar, agregar/quitar) y del dispositivo (crear, renombrar, quitar, borrar); smart playlists con reglas por tag, crear y editar |
| Server | Artistas → álbumes (con discos) → tracks; multi-library (getMusicFolders); perfiles de servidor guardados con uno activo; búsqueda; carátulas; favoritos ★; scrobble con la regla Subsonic (50% del tema o 4 minutos); radio del server |
| Organización | Bandeja de entrada (lo más nuevo de tus carpetas) con marcar procesado/restaurar; duplicados con abrir carpeta y mover a papelera; organizar archivos con plantilla configurable y undo; editor de tags rápido; escribir la carátula buscada dentro de los archivos (con confirmación, copia temporal y rename atómico); drag & drop del gestor de archivos |
| Letras | Pipeline propio: un .lrc al lado del tema gana sobre el tag y conserva sus marcas de tiempo; búsquedas a LRCLIB a pedido del usuario, cacheadas |
| Internet | Deezer y SoundCloud sólo como previews (nada se descarga); Radio Browser con favoritos locales que funcionan sin server |
| Podcasts | Feeds RSS locales con progreso y resume, imágenes y caché offline |
| Extras | 18 temas, panel de cola/info/letras/carátula con pestañas, mini-player, tray icon, bookmarks de posición, convertidor a copias, sincronización a dispositivo, backup del estado, menú contextual por fila y por álbum, ↑ ↓ y ← → en todas las listas, atajos configurables, persistencia de tamaño y posición de ventana |
Instalar
Los artefactos (.rpm, .deb, .AppImage) están en la página de releases del
proyecto: http://192.168.1.100:3000/white-knight17/G-Music/releases.
# Fedora / Nobara
sudo dnf install ./G-Music-<version>-1.x86_64.rpm
# Debian / Ubuntu
sudo apt install ./G-Music_<version>_amd64.deb
# AppImage (sin instalar)
chmod +x G-Music_<version>_amd64.AppImage && ./G-Music_<version>_amd64.AppImage
Detalle por distribución, entrada de escritorio e icono: docs/INSTALL.md.
Los bundles se generan con npm run dist (rpm + AppImage).
La app no se autoactualiza: Ajustes → General → Acerca de tiene un botón Buscar actualizaciones que abre esa misma página en el navegador.
Requisitos (Fedora 44)
sudo dnf install -y cargo rustfmt clippy webkit2gtk4.1-devel gtk3-devel alsa-lib-devel libsoup3-devel
- Node >= 22.22.3 (el CI fija 22.22.3)
ffmpegen PATH sólo para los formatos que symphonia no decodifica (wma/ape/ofr/tta/spx/mpc)- Renderer: se elige por familia de GPU antes de que arranque Tauri
(
src-tauri/src/renderer.rs). Con el driver propietario de NVIDIA se pinta por software (evita el crashGdk Error 71de WebKitGTK); AMD e Intel, incluida ARC, van acelerados. Para soporte hay override:GM_RENDERER=safe|fast. Contexto en docs/RENDERING.md.
Desarrollo
npm install
npm run tauri dev # app completa
npm run build # build Angular
npm test # unit tests de Angular (vitest, headless)
npm run e2e # e2e con Playwright (Chromium del sistema + IPC mockeado)
cd src-tauri && cargo test # suite Rust (lib + fixtures de audio)
cd src-tauri && cargo clippy --all-targets -- -D warnings
Entorno nuevo paso a paso: docs/SETUP.md. CI y runners: docs/CI.md. Release y convención de commits: RELEASE_WORKFLOW.md.
Si la máquina tiene un solo núcleo, corré
npm run e2e -- --workers=1y no compiles nada en paralelo: el renderer de Chromium se cae por carga y parece un fallo de la app.
Documentación
- Guía de usuario — qué hay en cada pestaña y cómo se usa
- Instalación · Empaquetado y release · CI
- Roadmap · Pendientes y decisiones abiertas
- Migraciones de la base de la biblioteca — qué reconstruye un re-escaneo y qué no
- MusicBee vs Linux: qué se puede hacer y qué no
- Notas para agentes — stack, evidencias REA, quirks del wire Subsonic y de rodio 0.21
Limitaciones conocidas
- Opus decodifica nativo; wma/ape/ofr/tta/spx/mpc necesitan ffmpeg en PATH (se transcodifica a WAV temporal al vuelo; los archivos originales nunca se re-encodan).
- El server y la radio streamean el HTTP directo al decodificador (sin buffer
completo). Los contenedores que necesitan acceso aleatorio (MP4 crudo) caen a
una descarga bufferizada. El seek sobre un stream reabre con
timeOffset: hay un salto corto y la posición sigue siendo absoluta. Un corte de conexión a mitad de tema termina el tema temprano, no hay cola de la cual reintentar. - Una cuenta/instancia activa por vez (los perfiles se cambian desde Ajustes).
- El bit-perfect no siempre es posible: si PipeWire tiene tomado el PCM, el exclusivo devuelve un error claro y ofrece volver al modo compartido; y si el HDMI del equipo sólo acepta 32–48 kHz, un 24-bit/96 kHz no puede ser exacto en ningún dispositivo.
- El passthrough AC-3/DTS está implementado y cubierto por tests, pero sólo se activa si el dispositivo anuncia IEC 958: sin receptor no se puede probar de oído (procedimiento).
- Los podcasts usan almacenamiento propio con feeds RSS (Navidrome no expone
getPodcasts).
Legal
Código original, licencia Proprietary, © White Knight. La instalación de referencia de MusicBee se usó sólo como mapa de funcionalidades y estructura por análisis estático; su código, assets y skins son propietarios y no forman parte de este proyecto.