Skip to content

Latest commit

 

History

History
159 lines (120 loc) · 7.03 KB

File metadata and controls

159 lines (120 loc) · 7.03 KB

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

# Instalación rápida (Windows)
winget install Sewandev.Reverbic

# O, mediante script de PowerShell (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 con PowerShell 7+ 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 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.

reverbic play <estación>   # 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 — modos de reproducción, configuración del Client ID, atajos y limitaciones conocidas
  • Guía de YouTube — funcionalidades (Mix, capítulos, SponsorBlock), configuración de cookies y limitaciones conocidas
  • Notas legales — 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.


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 para conocer las novedades de cada versión. (English)


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