Reverbic

Reproductor de terminal todo en uno — Radio, Spotify y YouTube, para Windows, macOS y Linux.

Build CodeQL Version Platform Built with Rust License

English | Español

Vista previa de Reverbic

--- ## Instalación ```bash # Instalación rápida (Windows) irm https://raw.githubusercontent.com/sewandev/Reverbic/main/install.ps1 | iex # Instalación rápida (macOS / Linux) brew install sewandev/reverbic/reverbic # Gestores de paquetes scoop bucket add reverbic https://github.com/sewandev/scoop-reverbic; scoop install reverbic # Windows (Scoop) cargo install --git https://github.com/sewandev/Reverbic.git --locked # Cualquier OS (Rust) # Compilar desde el código fuente git clone https://github.com/sewandev/Reverbic.git cd Reverbic cargo build --release ./target/release/reverbic ``` > [!TIP] > Recomendado: ejecuta Reverbic en [Windows Terminal](https://apps.microsoft.com/detail/9n0dx20hk701?hl) con [PowerShell 7+](https://apps.microsoft.com/detail/9mz1snwt0n5d?hl) para la mejor experiencia visual. > [!WARNING] > **Windows SmartScreen** puede mostrar una advertencia para binarios sin firma. Haz clic en "Más información" → "Ejecutar de todas formas". --- ## Funcionalidades - **Radio** — Busca y reproduce miles de estaciones de radio por nombre, género o país - **Spotify** — Control remoto: buscar, reproducir, pausar, seek, volumen y transferencia de dispositivos (Premium requerido) - **YouTube** — Busca y reproduce audio directamente desde YouTube - **Liviano** — ~25 MB de RAM y < 1% de CPU en reposo, inicia en menos de un segundo - **Overlay flotante** — siempre encima, con detección automática de juegos - **Discord Rich Presence** — muestra tu estación y canción actual en tu perfil - **Favoritas y crossfade** — guarda tus estaciones favoritas con crossfade suave entre ellas - **Protector de pantalla** — reloj, información de la estación y metadatos de la canción cuando está inactivo - **CLI headless** — controla la reproducción de radio desde la línea de comandos; sigue sonando en segundo plano aunque cierres la terminal > [!NOTE] > Actualmente, las funciones de **Overlay flotante**, **Audio ducking**, **Teclas multimedia**, **Bandeja del sistema (Tray)**, **Notificaciones**, **Discord RPC** y **CLI headless** son exclusivas de Windows. ¡Estamos buscando colaboradores para portarlas a macOS y Linux! > [!NOTE] > Los cambios de política de Spotify en 2026 podrían restringir la reproducción nativa (librespot) en cualquier momento. El modo de Control Remoto (búsqueda y control de reproducción vía la API oficial de Spotify) no depende de librespot y es un respaldo razonable para ese riesgo, aunque tiene sus propios requisitos (tu propia cuenta Premium de Spotify y app de Developer). Ver [LEGAL.md](LEGAL.md) para más detalles (en inglés). --- ## Control por línea de comandos (headless) > [!NOTE] > Por ahora solo en Windows. Solo radio — Spotify y YouTube quedan fuera de alcance. Controla la reproducción de radio sin mantener la interfaz abierta. Tras instalar, ejecuta `reverbic` seguido de un comando; la reproducción corre en un proceso de fondo que sobrevive al cierre de la terminal. ```bash reverbic play # inicia la radio en segundo plano (busca primero en favoritos, luego en línea) reverbic play # reanuda la última estación reproducida reverbic status # muestra la estación, la canción y el estado actual reverbic volume <0-100> # ajusta el volumen reverbic toggle # reproducir / pausar reverbic stop # detiene y apaga el reproductor de fondo reverbic # sin argumentos: abre la interfaz completa ``` --- ## Documentación - **[Guía de Spotify](docs/spotify.es.md)** — modos de reproducción, configuración del Client ID, atajos y limitaciones conocidas - **[Guía de YouTube](docs/youtube.es.md)** — funcionalidades (Mix, capítulos, SponsorBlock), configuración de cookies y limitaciones conocidas - **[Notas legales](LEGAL.md)** — servicios de terceros, términos de servicio y declaración de riesgos (en inglés) > [!WARNING] > Si configuras cookies de YouTube, **usa una cuenta secundaria ("burner")** — nunca tu cuenta principal de Google. Instrucciones completas en la [guía de YouTube](docs/youtube.es.md). --- ## Capturas de pantalla
Control remoto de Spotify
Control remoto de Spotify
Búsqueda en YouTube
Búsqueda en YouTube
Overlay para juegos
Overlay para juegos
Modo protector de pantalla
Modo protector de pantalla
Configuración
Configuración
Discord Rich Presence
Discord Rich Presence
--- ## Changelog Consulta [CHANGELOG.es.md](CHANGELOG.es.md) para conocer las novedades de cada versión. ([English](CHANGELOG.md)) --- ## Sobre este proyecto e IA Desarrollo Reverbic en mi tiempo libre, fuera del trabajo. Para avanzar rápido con poco tiempo, me apoyo en herramientas de IA a lo largo del desarrollo, pero la arquitectura, las decisiones de diseño y la revisión final de lo que se publica son mías. Cualquier contribución o feedback siempre es bienvenido. --- ## Contribuidores