bitchord-selfhosted-addon
Addon de BitChord para reproducir música propia desde un servidor Plex autoalojado.
Ficha actualizada 23 sept 2026, 8:34 · upstream 21 sept 2026, 16:21 · release v0.3.1
Qué es bitchord-selfhosted-addon
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Este addon permite que BitChord (Android) busque y reproduzca archivos musicales directamente desde una biblioteca de música alojada en un servidor propio. Funciona como fuente alternativa a las fuentes nativas de BitChord, con prioridad sobre addons externos cuando hay coincidencias. El token de autenticación del Plex nunca se envía al cliente, sino que se mantiene localmente en el contenedor. Cada ruta está protegida por una URL secreta (ADDON_SECRET), lo que garantiza que solo el propio addon pueda acceder a los archivos.
El addon utiliza un índice in-memoria de cada sección de música del Plex para búsquedas rápidas, con un refresh automático cada 15 minutos. Soporta búsqueda en tiempo real con soporte Range para saltos y desplazamiento. Los archivos originales se sirven desde el servidor, sin pérdida de calidad ni necesidad de proxies externos.
Se recomienda usar un proxy HTTPS como Caddy o Traefik que termine la conexión SSL antes de llegar al addon (que escucha en HTTP). Se debe desactivar el buffering del proxy para mantener tiempos de respuesta rápidos y evitar descargas parciales cuando se saltan canciones.
- Reproducir música propia desde BitChord sin depender de YouTube Music o Spotify
- Organizar y buscar archivos musicales en una biblioteca personal sin usar servicios externos
- Aumentar la privacidad al no enviar tokens de autenticación a servidores externos
- Integrar con un servidor Plex autoalojado como fuente principal de reproducción
- Reproducir música desde cualquier sección del Plex (todos los álbumes y artistas)
- Ofrecer calidad original sin degradar audio ni perder archivos
- El token de autenticación del Plex nunca se envía al cliente, garantizando privacidad
- Cada ruta está protegida por una URL secreta (ADDON_SECRET), lo que evita acceso no autorizado
- Soporta búsqueda en tiempo real con soporte Range para saltos y desplazamiento rápido
- No requiere proxies externos ni configuración compleja de red
- El índice se actualiza automáticamente cada 15 minutos sin intervención manual
- Permite reproducir música desde cualquier sección del Plex, no solo una sola
- Solo funciona con servidores Plex; no soporta otras fuentes como Jellyfin o MusicBrainz
- El token de autenticación debe ser válido y no revocado en el momento de la consulta
- La búsqueda puede fallar si un título tiene caracteres que no son latinos ni dígitos (ej. '夜に駆ける')
- Los archivos se descargan desde el servidor Plex, lo que consume ancho de banda
- El refresh del índice es automático cada 15 minutos y no permite búsquedas instantáneas sin reinicio
- No hay soporte para reproducción en segundo plano ni streaming continuo
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: copia .env.example a .env, genera un token con openssl rand -hex 24, configura PLEX_TOKEN y PLEX_URL según tu servidor Plex. Usa Caddy o Traefik como proxy HTTPS que termine la conexión SSL antes de llegar al addon (que escucha en HTTP). En compose.yml, pon el nombre del network del proxy y configura PUBLIC_URL con https://tu-sitio.com/. Inicia con docker compose up -d. Para actualizar, usa docker compose pull y up -d --build. Desactiva buffering del proxy para mantener tiempos de respuesta rápidos.
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.