Sobre el proyecto
Cliparr es un recortador de medios simplificado para servidores de medios personales. Permite crear y descargar rápidamente clips de medios que se están reproduciendo en un servidor Plex o Jellyfin conectado, o de un archivo de vídeo local o una URL de medios directa abierta en el navegador.
Capacidades principales:
- Descubrimiento instantáneo de sesiones: carga automáticamente los medios en reproducción desde los proveedores Plex y Jellyfin conectados.
- Vídeos locales: abre un archivo local o una URL de medios directa antes o después de conectar un proveedor. Los archivos locales se leen en el navegador y no se suben al servidor.
- Editor de línea de tiempo: arrastra el bloque de medios para seleccionar un clip, recorta cualquiera de los extremos y amplía la sincronización de subtítulos en todo el vídeo.
- Transcodificación en el navegador: la configuración de exportación funciona con Mediabunny; los GIF se codifican con gifenc.
- Metadatos: las exportaciones de vídeo pueden incluir metadatos de temporada, episodio y tiempos de la fuente.
- Incrustación de subtítulos: incrusta los subtítulos compatibles con estilos personalizables y compatibilidad con fuentes locales en Chromium.
Despliegue y configuración:
- Inicio rápido con Docker desde el GitHub Container Registry, exponiendo el puerto 7171 y montando un volumen de datos.
- Se proporciona un ejemplo de Docker Compose para configuraciones persistentes.
- Se requiere una APP_KEY estable de al menos 32 caracteres para cifrar las credenciales de los proveedores en reposo; cambiarla requiere volver a autenticar los servidores de medios.
- El editor usa WebCodecs del navegador, por lo que se requiere un contexto seguro (HTTPS mediante proxy inverso, o localhost/127.0.0.1).
- Las variables de configuración cubren el puerto, el directorio de datos SQLite, el nivel de registro, el formato de registro, la rotación de archivos de registro y una opción para permitir URL de Jellyfin en loopback.
- Detrás de un proxy inverso, conserva el encabezado Host y pasa X-Forwarded-Proto. Cliparr confía en los rangos de proxy de loopback, link-local y LAN privada.
- No existe un sistema completo de usuarios o permisos a nivel de aplicación; restringe el acceso mediante una red de confianza o un proxy inverso autenticado.
Desarrollo:
- Clona el repositorio, copia .env.example a .env y establece APP_KEY, instala con pnpm y ejecuta pnpm dev.
- Una pila de desarrollo opcional con Docker precarga Plex y Jellyfin con Sintel, un corto de animación abierto de Blender con pistas de subtítulos incrustadas.
- La guía de contribución está en .github/CONTRIBUTING.md.
Licencia: MIT.
Comments
0 Rating appears after 10 ratings
Sign in to join the discussion.