Reproductor de música local, radio, soundcloud y extensión de navidrome.
  • TypeScript 38.3%
  • Rust 34.3%
  • HTML 20.1%
  • SCSS 6.2%
  • Python 0.9%
  • Other 0.2%
Find a file Use this template
Repository files (latest commit first)
Filename Latest commit message Latest commit date
2026-11-18 16:55:43 -03:00
.agents/skills feat(local): full extended-selection gestures on every list 2026-11-15 01:36:16 -03:00
.forgejo/workflows chore: make the lint gate mandatory, finish the mixins, drop dead rules 2026-11-14 20:08:51 -03:00
.vscode chore: bootstrap Tauri 2 + Angular 22 workspace 2026-11-05 19:14:47 -03:00
design docs(odd): L197 closes the dense handoff 2026-11-17 10:42:37 -03:00
docs feat(dj): draw the record's envelope under each platter 2026-11-18 16:30:34 -03:00
e2e feat(dj): draw the record's envelope under each platter 2026-11-18 16:30:34 -03:00
odd/tasks feat(dj): draw the record's envelope under each platter 2026-11-18 16:30:34 -03:00
scripts feat(audit): catch false accessibility contracts 2026-11-14 22:42:45 -03:00
src feat(dj): draw the record's envelope under each platter 2026-11-18 16:30:34 -03:00
src-tauri chore(version): v2.8.0 2026-11-18 16:55:43 -03:00
.gitignore docs(skill): write down the UI traps, and check two of them automatically 2026-11-14 22:19:35 -03:00
AGENTS.md feat(dj): draw the record's envelope under each platter 2026-11-18 16:30:34 -03:00
angular.json feat(settings): the audio page names the layout and the mixing 2026-11-17 17:11:41 -03:00
CHANGELOG.md chore(version): v2.8.0 2026-11-18 16:55:43 -03:00
cog.toml feat(playlists): local device-side playlists 2026-11-06 11:57:53 -03:00
package-lock.json chore(lockfile): sync name and version with package.json 2026-11-13 20:27:27 -03:00
package.json chore(version): v2.8.0 2026-11-18 16:55:43 -03:00
playwright.config.ts feat(local): wider rail, visible hover on selection, ctrl+click albums 2026-11-15 00:36:55 -03:00
README.md docs(readme): center the logo 2026-11-18 16:47:59 -03:00
RELEASE_WORKFLOW.md fix(ci): stop attaching every old version's bundles to a new release 2026-11-14 01:30:38 -03:00
tsconfig.app.json chore: bootstrap Tauri 2 + Angular 22 workspace 2026-11-05 19:14:47 -03:00
tsconfig.json chore: bootstrap Tauri 2 + Angular 22 workspace 2026-11-05 19:14:47 -03:00
tsconfig.spec.json test(angular): vitest setup and PlayerService specs 2026-11-07 16:55:15 -03:00

G-Music

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)
  • ffmpeg en 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 crash Gdk Error 71 de 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=1 y no compiles nada en paralelo: el renderer de Chromium se cae por carga y parece un fallo de la app.

Documentación

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).

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.