Skip to content

Funkwhale ​

Conecta Crow a Funkwhale, un servidor de música y podcasts autoalojado que federa sobre ActivityPub. Explora y busca en tu biblioteca, sube pistas, gestiona playlists, sigue canales remotos a través del fediverso y modera tu pod — todo a través de tu asistente de IA.

Qué obtienes ​

  • Explorar y buscar en tu biblioteca de música
  • Subir pistas
  • Crear y gestionar playlists (agregar, quitar, reordenar, eliminar)
  • Seguir y dejar de seguir canales y bibliotecas remotos sobre ActivityPub
  • Ver qué se está reproduciendo actualmente
  • Moderación: bloquear/silenciar usuarios, bloquear o defederar dominios, depurar media en caché

Configuración ​

Funkwhale se instala como un bundle de Crow. Ejecuta seis contenedores (api, celeryworker, celerybeat, un servidor de archivos nginx interno, postgres, redis) junto a tu gateway de Crow.

"Crow, instala el bundle de Funkwhale"

O instálalo desde el panel de Extensiones en el Crow's Nest.

Hardware ​

El bundle está protegido por una verificación de hardware: se niega a instalarse por debajo de 1.5 GB de RAM efectiva (después de los bundles ya comprometidos) y advierte por debajo de 8 GB en total. El disco crece con tu biblioteca — espera aproximadamente 5–20 GB por cada 1,000 pistas, más cientos de MB para las cachés federadas.

Almacenamiento: disco local o Almacenamiento compartido ​

Por defecto, los archivos de audio viven en ~/.crow/funkwhale/data/media. Si Ajustes → Almacenamiento compartido está configurado al instalar, el instalador dirige Funkwhale a un bucket <prefijo>-funkwhale allí. El formulario de instalación no tiene campos S3 propios del bundle.

Federación ​

Funkwhale federa sobre ActivityPub: usuarios remotos de Mastodon / GoToSocial / Pixelfed pueden seguir tus canales, y tu pod puede suscribirse a canales y bibliotecas remotos (manteniendo cachés locales del audio). Exponlo en su propio dominio vía Caddy como parte del bootstrap de primera ejecución.

Herramientas de IA ​

Una vez instalado, puedes interactuar con Funkwhale a través de tu IA:

"¿Qué hay en mi biblioteca de Funkwhale?"

"Busca ambient en mi música"

"Sube esta pista a Funkwhale"

"Sigue ese canal"

"Crea una playlist llamada Focus"

"¿Qué se está reproduciendo ahora?"

Solución de problemas ​

El bundle no se instala ​

Revisa la verificación de hardware — Funkwhale se niega a instalarse por debajo de 1.5 GB de RAM efectiva después de contabilizar los otros bundles. Libera memoria o detén otro bundle y vuelve a intentarlo.

Las subidas fallan o el audio no se reproduce ​

Si el Almacenamiento compartido estaba configurado al instalar, confirma que sea accesible (Ajustes → Almacenamiento compartido) y que el bucket <prefijo>-funkwhale exista y sea escribible. Sin Almacenamiento compartido, Funkwhale guarda los medios en disco bajo ~/.crow/funkwhale/data/media.

La federación no funciona ​

Funkwhale debe ser accesible en su propio dominio público sobre HTTPS para que ActivityPub funcione. Confirma que el sitio de federación de Caddy esté configurado y que el dominio resuelva.

Released under the MIT License.