OwnFlick: feed privado tipo TikTok para tus fotos, vídeos y música

Self-hosted Media Feed

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.

Convierte tus carpetas de medios en un feed privado tipo TikTok/Pinterest, autohospedado, sin nube, con IA opcional para búsqueda y recomendaciones.

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.

pip install ownflick ownflick ~/Videos # Abre http://<tu-ip>:8000 en la red local

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).

mkdir ownflick-data docker run -d --name ownflick --restart unless-stopped --init \ --user "$(id -u):$(id -g)" -p 8000:8000 \ -v ~/Videos:/media -v "$PWD/ownflick-data:/data" \ ghcr.io/oddloafhq/ownflick:latest docker logs ownflick # muestra la contraseña de acceso

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.

# compose.yaml services: spooly: image: ghcr.io/oddloafhq/ownflick:latest container_name: spooly restart: unless-stopped init: true user: "1000:1000" ports: - "8000:8000" environment: TZ: Etc/UTC # SPOOLY_AUTH_PASSWORD: "" # solo primer inicio; si no, ver docker logs spooly volumes: - ~/Videos:/media - ./spooly-data:/data # Ejecutar: docker compose up -d docker logs spooly

Android con Termux

OwnFlick puede ejecutarse en un teléfono Android mediante Termux. Consulta la guía oficial para los pasos detallados.

# Ver documentación: docs/android-termux.md

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:

media_sources: - id: default name: Main Library path: ~/Videos/OwnFlick - id: photos name: Photos path: ~/Pictures download_source: default name: Studio Mac port: 8000 exclude: - "folder.jpg" - "cover.jpg" media_sources: - id: music name: Music path: ~/Music exclude: - "*.png" - "Extras/" - "Albums/*/back.jpg"

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.

vision: enabled: true base_url: https://openrouter.ai/api/v1 model_name: google/gemini-2.5-flash tags_limit: 5 experiments: similarity: enabled: true embedding: base_url: https://openrouter.ai/api/v1 model_name: google/gemini-embedding-2 # api_key: ... # opcional; si no, usa variables de entorno # Claves de entorno: # SPOOLY_VISION_API_KEY, SPOOLY_EMBEDDING_API_KEY, SPOOLY_AI_API_KEY, OPENAI_API_KEY, OPENROUTER_API_KEY

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).

ownflick vectorize ~/Videos --dry-run # solo cuenta, no envía ownflick vectorize ~/Videos --limit 200 # lote pequeño de prueba ownflick vectorize ~/Videos --yes # ejecuta completo

Miniaturas de vídeo

Genera o regenera miniaturas para la cuadrícula y el feed.

ownflick thumbs /path/to/media # genera ownflick thumbs /path --overwrite # regenera

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.

ownflick dedupe /path/to/media # dry-run ownflick dedupe /path --type video # solo vídeos ownflick dedupe /path --keep newest --execute # elimina duplicados conservando el más nuevo # Opciones: --type video|image|all, --algorithm sha256|md5, --keep oldest|newest|shortest_path, --dry-run, --execute, --auto-confirm

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).

app = create_app() app.extensions['download_manager'].start() # en arranque del worker # en shutdown hook: app.extensions['download_manager'].close()

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.

docker pull ghcr.io/oddloafhq/ownflick:latest docker compose up -d # o con docker run: detener y eliminar contenedor anterior, volver a ejecutar docker run con mismos volúmenes

Logs y contraseña

La contraseña de acceso se muestra en los logs del primer inicio. Para recuperarla:

docker logs ownflick # o ownflick auth status

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)

Apoya el canal GENBYTE

Sígueme en mis redes sociales

Comentarios

Entradas populares de este blog

Cómo Instalar y configurar SERVIDOR VPN WIREGUARD en MIKROTIK 🔐 #VPN #Wireguard #Mikrotik #RouterOS

Cómo instalar y configurar DSM SYNOLOGY 7.2.2 en PC | Guía completa, instalación, RAID 1, SMB

Solución al Error "No se encontró la imagen de Windows RE" en Windows 10 al ejecutar reagentc /enable