BeatDock
BeatDock es un bot de música autoalojado para Discord basado en Lavalink v4, diseñado para reproducir contenido multimedia desde múltiples plataformas como YouTube, SoundCloud y Twitch mediante comandos slash y despliegue Docker simplificado.
Ficha actualizada 26 sept 2026, 18:57 · upstream 26 sept 2026, 18:34 · release v2.11.1
Qué es BeatDock
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
BeatDock es una solución open source para automatizar la reproducción de música en servidores de Discord. Está construido sobre Node.js y Next.js, ejecutándose dentro de contenedores Docker con soporte nativo para docker-compose. La arquitectura separa el bot del servidor de audio Lavalink, permitiendo un despliegue modular donde el usuario puede gestionar su propia instancia o conectarse a nodos públicos gratuitos si no configura variables de entorno específicas.
- Reproducción de música en servidores privados sin depender de servicios externos como Spotify Connect.
- Gestión de listas de reproducción y control de volumen mediante comandos slash para moderadores.
- Despliegue rápido en infraestructura autoalojada (VPS, NAS) usando imágenes precompiladas de GitHub Container Registry.
- Uso en entornos de karaoke o radio online donde se requiere reproducir videos no musicales y listas automáticas.
- Gestión automática de poToken de YouTube mediante servicios auxiliares sin necesidad de credenciales de Google ni API keys.
- Soporte nativo para múltiples plataformas (YouTube, SoundCloud, Bandcamp, Twitch, Vimeo) con fallback a nodos públicos Lavalink.
- Interfaz multilenguaje configurable en el momento del despliegue (inglés, español, turco, italiano, portugués brasileño).
- Control granular de roles y permisos mediante variables de entorno para restringir acceso a comandos específicos.
- Actualización sin downtime mediante reinicio forzado de contenedores con docker compose up --force-recreate.
- La reproducción de videos no musicales y autoplay depende del poToken de YouTube, que puede expirar o ser bloqueado por Google.
- El soporte para Spotify es limitado a búsqueda y resolución vía YouTube si se habilita mediante variables de entorno.
- Requiere Node.js versión 22 o superior para la ejecución correcta del bot.
- La gestión de tokens de YouTube en nodos públicos Lavalink no está controlada por el usuario, dependiendo de la configuración del nodo.
- Algunas funcionalidades como autoplay pueden estar inactivas si se cambia la plataforma de búsqueda predetermina a SoundCloud.
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Para desplegar, cree un directorio y genere un archivo .env con su TOKEN de Discord. Utilice docker-compose.yml para definir servicios de bot, Lavalink y gestión de tokens. Asegúrese de habilitar las intenciones privilegiadas en el portal de desarrolladores de Discord. Si desea usar nodos públicos, comente las variables LAVALINK_HOST, LAVALINK_PORT y LAVALINK_PASSWORD en .env. Para actualizaciones, ejecute docker compose pull && docker compose up -d --force-recreate.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.