zenwave

🌊 ZenWave

Lo-Fi Cafe & Ambient Soundboard TUI con estética moderna estilo Hyprland / Catppuccin / Unixporn.

✨ Características

• 🎨 Estética Hyprland / Waybar:

  • Píldoras de estado superiores redondeadas (██).
  • 4 Paletas de color míticas conmutables en tiempo real: Catppuccin Mocha, Tokyo Night, Rosé Pine y Nord.
  • Soporte nativo para glifos e iconos de Nerd Fonts.

• 󰽰 Visualizador Musical con 3 Modos (tecla v):

  • CAVA Bars: Barras clásicas de frecuencias con física de gravedad, rebote y picos de color (peak meters).
  • Osciloscopio: Onda sinusoidal continua y suave (∿∿∿) estilo sintetizador analógico.
  • Matriz de Densidad Braille: Puntos orgánicos de alta resolución (⣾⣽⣻⢿⡿) con bordes difusos.

• 💾 Guardado Automático de Ajustes:

  • Tu tema, los niveles del mezclador ambiental y la última estación se guardan en ~/.config/zenwave/config.json y se restauran automáticamente al reabrir ZenWave.

• 🎧 Motor de Audio Multi-Canal (Fogata, Lluvia, Viento, Olas + Radio en Vivo):

  • Mezclador de audio multicapa en tiempo real:
    • Fogata / Leña: Sintetizador con rumor cálido de brasas, siseo de resina y crujidos acústicos orgánicos (pops & snaps).
    • Lluvia y Olas de Mar: Streams de radio ambiental reales en vivo con generadores procedurales de respaldo instantáneo.
    • Viento Nocturno: Ruido modulado de baja frecuencia.
  • Estaciones de música Lo-Fi online (Lofi Girl, Synthwave, Jazz Café, Ambient Lounge, Cyberpunk Bar).

• 󰅐 Temporizador Zen / Pomodoro & 🔔 Notificaciones Nativas:

  • Modos: Enfoque (25 min), Descanso Corto (5 min) y Descanso Largo (15 min) con seguimiento de ciclos.
  • Notificaciones de escritorio nativas en macOS/Linux/Windows con sonidos del sistema cuando termina el tiempo de enfoque o descanso.

• 󰝚 Streaming de YouTube (Videos y Playlists Completas):

  • Presiona y para abrir el cuadro de diálogo y pegar cualquier enlace de YouTube o Playlist.
  • Extrae audio en alta calidad sin publicidad ni consumo de video.
  • Navega las canciones de la playlist con ← / →, o presiona y de nuevo para abrir un navegador de la playlist y saltar directamente a cualquier canción de la lista.
  • Totalmente mezclado con los sonidos ambientales y reactivo al ecualizador CAVA.
  • La playlist y la canción actual se guardan automáticamente: al reabrir ZenWave continúas exactamente donde la dejaste.

• 󰃭 Escenas ASCII Animadas Interactivas:

  • Habitación Lofi & Lluvia: Gato durmiendo, gotas animadas en la ventana y café humeante.
  • Ciudad Neón Cyberpunk: Rascacielos con luces parpadeantes y fases lunares.
  • Fogata en el Bosque: Chispas flotantes y cielo estrellado titilante.

⌨️ Atajos de Teclado

🚀 Instalación y Uso

Requisitos previos

• Go 1.22+ — solo para instalar/compilar; el binario resultante no lo necesita para correr.
• Una Nerd Font instalada y configurada en tu terminal (recomendada: JetBrainsMono Nerd Font), para que se vean los íconos correctamente en vez de símbolos "�".
• (Opcional, solo para la función de YouTube) yt-dlp y ffmpeg en tu PATH:

  brew install yt-dlp ffmpeg   # macOS
  

Instalar con go install (recomendado)

go install github.com/FernandoCHT/zenwave@latest
zenwave

Esto descarga, compila e instala el binario en $(go env GOPATH)/bin (agrégalo a tu PATH si no lo está).

Compilar desde el código fuente

git clone https://github.com/FernandoCHT/zenwave.git
cd zenwave
go build -o zenwave .
./zenwave

(Opcional) Moverlo a tus binarios globales para lanzarlo desde cualquier terminal:

cp zenwave /usr/local/bin/zenwave
zenwave

📄 Licencia

Este proyecto está bajo la licencia MIT.

Desarrollado con ❤️ en Go usando Charm Bubble Tea y Lip Gloss.