bandcampsync
BandcampSync es una herramienta de sincronización que descarga automáticamente los medios comprados en Bandcamp a un directorio local, compatible con servidores multimedia como Plex o Jellyfin.
Ficha actualizada 18 sept 2026, 20:43 · upstream 30 may 2026, 14:21 · release v0.8.0
Qué es bandcampsync
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
BandcampSync es un módulo Python y script de línea de comandos (también disponible como contenedor Docker) que sincroniza los medios comprados en una cuenta de Bandcamp con un directorio local. La herramienta autentica al usuario mediante cookies de sesión exportadas, escanea el directorio local para identificar elementos ya descargados e indexa la colección de compras del usuario.
El proceso descarga automáticamente las colecciones de archivos faltantes desde la colección de Bandcamp, descomprime los archivos y mueve el contenido al directorio local. Utiliza un archivo de control en el directorio de medios para evitar escanear repetidamente la colección completa, optimizando así el rendimiento y reduciendo la carga en el servidor.
- Sincronización automática de compras de Bandcamp con servidores multimedia locales como Plex o Jellyfin
- Descarga programada de nuevos álbumes y sencillos comprados en Bandcamp sin intervención manual
- Gestión de colecciones de audio de alta calidad (FLAC, WAV) en servidores autoalojados
- Integración con sistemas de notificación HTTP para refrescar bibliotecas de medios tras cada descarga
- Soporte nativo para múltiples formatos de audio incluyendo FLAC, MP3, AAC y WAV
- Sistema de checkpoint optimizado que evita reescanear colecciones completas en ejecuciones sucesivas
- Compatibilidad con contenedores Docker simplificada con variables de entorno configurables
- Funcionalidad de notificación HTTP para integración con servidores multimedia externos
- Requiere autenticación manual mediante cookies de sesión debido a las protecciones CAPTCHA de Bandcamp
- No incluye Docker Compose por defecto, aunque se puede configurar manualmente
- Dependencia de bibliotecas Python específicas (beautifulsoup4, curl-cffi) para instalación nativa
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.
Recomendado ejecutar en entornos Linux o Windows con soporte para Python3. Para despliegue Docker, utilizar la imagen ghcr.io/meeb/bandcampsync:latest configurando PUID y PGID adecuados al sistema de archivos local. Guardar cookies.txt en un directorio seguro fuera del volumen compartido. Configurar RUN_DAILY_AT para ejecución automática diaria. Considerar usar SYNC_IGNORE_FILE para mantener consistencia entre escaneos de sistema y archivo de ignorados.
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.