OwnFlick: feed privado tipo TikTok para tus fotos, vídeos y música
OwnFlick: feed privado tipo TikTok para tus fotos, vídeos y música
Servidor multimedia autohospedado que convierte carpetas locales en un feed vertical deslizable, con biblioteca tipo Pinterest, línea temporal por años y reproductor de audio ambiente. Sin cuentas en la nube, todo queda en tu hardware.
Vídeo tutorial en YouTube
Mira el vídeo completo sobre cómo instalar y usar OwnFlick: feed privado tipo TikTok para tus fotos, vídeos y música en el canal GENBYTE:
¿Qué es OwnFlick: feed privado tipo TikTok para tus fotos, vídeos y música?
OwnFlick (anteriormente Spooly) es una aplicación self-hosted escrita en Python que transforma directorios de medios en una experiencia de navegación similar a TikTok o Pinterest, pero completamente privada. El proyecto permite servir vídeos, fotos y música desde tu propio ordenador, NAS o servidor, accesible desde cualquier navegador en la red local. No requiere conexión a internet para la reproducción y navegación local; las funciones de descarga por URL y características de IA opcionales sí necesitan conectividad. La interfaz ofrece tres vistas principales: Flow (feed vertical a pantalla completa), Library (cuadrícula explorable y línea temporal año/mes) y Home (punto de partida con "On This Day" y colecciones). Incluye sistema de favoritos y colecciones con reanudación de vídeo entre dispositivos, papelera para eliminaciones reversibles, descargas en segundo plano con yt-dlp y gallery-dl, y un modo Radio para reproducción de audio ambiente. La autenticación está activada por defecto con contraseña generada al primer inicio, almacenada como hash scrypt. El proyecto está licenciado bajo MIT y mantiene compatibilidad con instalaciones previas de Spooly.
Características principales
Flow — feed vertical inmersivo
Reproducción a pantalla completa de vídeos e imágenes mezclados. Deslizar arriba/abajo para siguiente/anterior, doble toque para favorito, mantener pulsado para 2× velocidad, arrastrar lateralmente para buscar en el vídeo. Los archivos que el navegador no puede reproducir (p.ej. HEVC/AV1 sin soporte) se saltan con una nota breve sin detener el feed.
Library — exploración y línea temporal
Vista de cuadrícula estilo Pinterest con imágenes aleatorias, vídeos recientes y archivos grandes. Línea temporal por año y mes para archivos de varios años. Explore muestra grupos de fotos relacionadas y vídeos sugeridos.
Home — punto de partida contextual
Reanuda donde lo dejaste, muestra recuerdos "On This Day" y da acceso rápido a Flow, Radio y colecciones.
Favoritos y colecciones persistentes
Guarda cualquier elemento desde cualquier vista. Los vídeos largos recuerdan la posición de reproducción entre dispositivos. Las colecciones agrupan elementos manualmente.
Descargas en segundo plano
Pega un enlace en la página /download; OwnFlick usa yt-dlp (sitios de vídeo) y gallery-dl (imágenes/álbumes) para guardar en tu biblioteca. Soporta cookies para contenido con inicio de sesión. ffmpeg une formatos y genera miniaturas de vídeo.
Radio — reproductor de audio ambiente
Reproduce música de las mismas carpetas que el resto de la biblioteca como una emisora continua.
Múltiples fuentes, una biblioteca unificada
Combina varios directorios de medios en una sola vista. Las eliminaciones van a una papelera recuperable. Los URIs de medios usan el formato @source_id/ruta; los enlaces y favoritos antiguos siguen funcionando a través de la fuente por defecto.
Patrones de exclusión flexibles
Excluye archivos o carpetas globalmente o por fuente (p.ej. folder.jpg, cover.jpg, *.png, Extras/, Albums/*/back.jpg). Las reglas distinguen mayúsculas/minúsculas, admiten comodines *, ?, [abc] y se aplican al reiniciar. Los archivos excluidos permanecen en disco y conservan favoritos, colecciones e historial.
IA opcional: títulos, etiquetas, búsqueda y similares
Modelo de visión para títulos/etiquetas de imágenes y modelo de embeddings para búsqueda por descripción y medios relacionados. Configurable vía config.yaml con proveedores como OpenRouter. Los vectores se almacenan localmente en SQLite; la preparación es en segundo plano, pausable y reintentable. Cambiar de modelo reinicia el espacio vectorial.
Acceso seguro por defecto
Autenticación obligatoria para todas las páginas, API y archivos multimedia. Contraseña establecida en el primer arranque (impresa en consola) o mediante comandos ownflick auth. Para HTTPS, usar proxy inverso con FLASK_AUTH_COOKIE_SECURE=true manteniendo cabecera Host y peticiones Range.
Ejecución local sin internet
La navegación y reproducción local funcionan sin conexión. Solo la descarga por URL y las funciones de IA requieren red.
Multiplataforma y contenedores
Instalación vía pip (Python 3.10+), Docker (imagen multiarch amd64/arm64 con ffmpeg, yt-dlp, gallery-dl, Deno), Docker Compose y Android mediante Termux.
Requisitos del sistema
- Python 3.10 o superior (para instalación nativa)
- Docker y Docker Compose (para despliegue en contenedor)
- ffmpeg, yt-dlp, gallery-dl (para descargas y miniaturas; incluidos en la imagen Docker)
- Deno (requerido por yt-dlp para YouTube; incluido en la imagen Docker)
- Navegador moderno con soporte de reproducción de vídeo HTML5 (H.264/AAC recomendado para máxima compatibilidad)
- Red local para acceso desde otros dispositivos (móvil, tablet, otro ordenador)
Instalación con Docker Compose
Instalación nativa con pip
Requiere Python 3.10+. Instala el paquete desde PyPI y ejecuta indicando la carpeta de medios. El primer arranque imprime la contraseña de acceso en la terminal.
Despliegue con Docker (línea de comandos)
Crea un directorio para datos persistentes y ejecuta el contenedor mapeando tu carpeta de medios y el directorio de datos. La imagen incluye ffmpeg, yt-dlp, gallery-dl y Deno para amd64 y arm64. El usuario del contenedor debe coincidir con el propietario de la carpeta de medios en el host (ajusta user: "1000:1000" según tu uid/gid).
Despliegue con Docker Compose
Usa el compose.yaml incluido en el repositorio. Ajusta la ruta de medios (~/Videos) y el directorio de datos (./spooly-data). La variable TZ define la zona horaria para la línea temporal y "On This Day". La contraseña se genera al primer inicio y aparece en los logs.
Android con Termux
OwnFlick puede ejecutarse en un teléfono Android mediante Termux. Consulta la guía oficial para los pasos detallados.
Acceder al proyecto
Acceso web
Abre http://<ip-del-servidor>:8000 desde cualquier navegador en la misma red. La primera vez se solicita la contraseña generada al inicio (visible en la terminal o en docker logs ownflick / docker logs spooly).
Gestión de contraseña
Comandos para consultar estado y cambiar contraseña (invalida sesiones existentes): - ownflick auth status - ownflick auth set-password - SPOOLY_AUTH_PASSWORD='contraseña-larga' ownflick auth set-password El hash scrypt se guarda en ~/.spooly/auth.json (o /data en Docker).
HTTPS mediante proxy inverso
OwnFlick sirve HTTP plano. Para HTTPS, colócalo detrás de un proxy inverso (nginx, Caddy, Traefik) que preserve la cabecera Host y las peticiones Range de vídeo, y define FLASK_AUTH_COOKIE_SECURE=true al iniciar: FLASK_AUTH_COOKIE_SECURE=true ownflick ~/Videos --host 127.0.0.1 --port 8000
Casos de uso
- Servidor multimedia personal tipo TikTok/Pinterest para fotos y vídeos familiares sin subir a la nube.
- Galería unificada de múltiples carpetas (Vídeos, Fotos, Descargas, Cámaras) con navegación por línea temporal.
- Reproductor de audio ambiente (Radio) para carpetas de música junto al resto de medios.
- Descarga automática de vídeos e imágenes de enlaces (YouTube, Twitter/X, Instagram, etc.) directamente a la biblioteca local.
- Búsqueda por descripción en lenguaje natural (incluye chino) y recomendación de medios similares mediante IA opcional.
- Visualización offline en red local: ideal para NAS en casa sin exposición a internet.
- Gestión de favoritos y colecciones con reanudación de vídeo entre dispositivos (móvil, tablet, escritorio).
- Deduplicación de archivos por hash (SHA256/MD5) conservando el más nuevo, más antiguo o ruta más corta.
Configuración avanzada
Configuración mediante config.yaml
La configuración se lee en orden: opciones de línea de comandos, variables de entorno (MEDIA_ROOT, SPOOLY_HOST, SPOOLY_PORT), config.yaml en SPOOLY_INSTANCE y ~/.config/spooly/config.yaml. Ejemplo con múltiples fuentes, exclusiones, puerto y nombre:
IA: visión y embeddings (opcional)
Habilita títulos/etiquetas automáticas y búsqueda/similares. Requiere claves API (OpenRouter, OpenAI, etc.). Los vectores se guardan en SQLite local. Reinicia tras cambiar la configuración.
Vectorización (preparación de embeddings)
Ejecuta la preparación en segundo plano desde la UI (Settings → Similar Images → Prepare) o desde terminal. Procesa fotos primero, luego vídeos (3 frames al 20%, 50%, 80%). Pausable, reintentable. Los vectores se almacenan en ~/.spooly/spooly.sqlite3 (o /data en Docker).
Miniaturas de vídeo
Genera o regenera miniaturas para la cuadrícula y el feed.
Deduplicación
Encuentra duplicados por hash (SHA256 o MD5) y opcionalmente elimina conservando el más nuevo, más antiguo o ruta más corta. Por defecto es dry-run.
Incrustar en otro servidor WSGI
Al usar create_app() externamente, inicia el gestor de descargas en el worker de servicio y ciérralo en su hook de apagado (no en teardown por petición de Flask).
Gestión y mantenimiento
Actualización de la imagen Docker
Descarga la última imagen y recrea el contenedor manteniendo los volúmenes de datos y medios.
Logs y contraseña
La contraseña de acceso se muestra en los logs del primer inicio. Para recuperarla:
Cambios de configuración
Tras editar config.yaml o variables de entorno, reinicia el servidor (docker compose restart o Ctrl+C y nuevo ownflick). La sincronización de fuentes y aplicación de exclusiones ocurre al arranque.
Copia de seguridad
Los datos persistentes están en el volumen /data (o ~/.spooly en instalación nativa): base de datos SQLite (spooly.sqlite3), hash de contraseña (auth.json), miniaturas, cookies y config.yaml opcional. Haz backup de ese directorio.
Limpieza de descargas interrumpidas
Al detener el servidor (Ctrl+C o SIGTERM) se cancelan descargas en curso y se conservan los archivos finalizados; los trabajos interrumpidos no se reanudan automáticamente.
Stack técnico
- Python 3.10+
- Flask 3.1
- Waitress 3.0 (servidor WSGI de producción)
- PyYAML
- Requests
- Pillow (procesamiento de imágenes)
- yt-dlp (descarga de vídeo)
- gallery-dl (descarga de imágenes/álbumes)
- ffmpeg (transcodificación, miniaturas, unión de formatos)
- Deno (runtime JS para yt-dlp YouTube)
- SQLite (base de datos local: índices, vectores, auth)
- TailwindCSS 4 + DaisyUI (frontend)
- Docker multiarch (amd64/arm64)
- scrypt (hash de contraseña)
Referencias oficiales
- Repositorio GitHub OwnFlick: https://github.com/oddloafhq/ownflick
- Sitio web oficial: https://oddloaf.dev/ownflick/
- Documentación Docker: https://github.com/oddloafhq/ownflick/blob/main/docs/docker.md
- Guía Android con Termux: https://github.com/oddloafhq/ownflick/blob/main/docs/android-termux.md
- Índice de documentación: https://github.com/oddloafhq/ownflick/blob/main/docs/README.md
- Interacción Flow: https://github.com/oddloafhq/ownflick/blob/main/docs/flow-interaction-unification.md
- Índice de medios y recomendación local: https://github.com/oddloafhq/ownflick/blob/main/docs/media-index-and-recommendation.md
- Notas de versión: https://github.com/oddloafhq/ownflick/blob/main/docs/release_notes.md
- Paquete en PyPI: https://pypi.org/project/ownflick/
- Imagen Docker en GHCR: https://ghcr.io/oddloafhq/ownflick:latest
- Licencia MIT: https://github.com/oddloafhq/ownflick/blob/main/LICENSE
Comentarios
Publicar un comentario