Cliparr: создание клипов из медиа на твоем сервере

Cliparr — это инструмент для быстрого создания и загрузки клипов из медиа, которые сейчас воспроизводятся на твоем сервере Plex или Jellyfin, а также из локальных видеофайлов, открываемых прямо в браузере. Он позволяет удобно вырезать отрывки и работать с ними в режиме реального времени.

Среди ключевых особенностей Cliparr:

• Автоматическое обнаружение сессий: обновления о воспроизведении из Plex и Jellyfin происходят в реальном времени без необходимости вручную обновлять страницу.
• Поддержка локальных видео: ты можешь открыть локальный файл или прямую ссылку на медиа перед или после подключения к серверу.
• Интуитивно понятный редактор таймлайна: просто перетаскивай медиа-блок и обрезай клип, регулируй время появления субтитров.
• Браузерное транскодирование: экспорт видеоклипов поддерживает настройки, предлагаемые Mediabunny, с возможностью создания GIF-файлов.
• Поддержка метаданных: в экспортируемые видео могут включаться информация о сезоне, эпизоде и времени из исходного материала.
• Встраивание субтитров: возможно встраивание поддерживаемых субтитров с настроенным стилем и локальным шрифтом.

Установка и запуск

Самый быстрый способ запустить Cliparr — это использование Docker. Вот команды для установки:

docker run -d \
  --name cliparr \
  -p 7171:7171 \
  -e APP_KEY="your-32-char-stable-random-secret" \
  -v cliparr-data:/data \
  ghcr.io/techsquidtv/cliparr:latest

Для PowerShell команда будет выглядеть так:

docker run -d `
  --name cliparr `
  -p 7171:7171 `
  -e APP_KEY="your-32-char-stable-random-secret" `
  -v cliparr-data:/data `
  ghcr.io/techsquidtv/cliparr:latest

Ты можешь использовать Docker Compose для постоянной настройки. Пример конфигурации:

services:
  cliparr:
    image: ghcr.io/techsquidtv/cliparr:latest
    container_name: cliparr
    ports:
      - "7171:7171"
    environment:
      - APP_KEY=replace-this-with-a-32-character-secure-random-string
    volumes:
      - cliparr-data:/data
    restart: unless-stopped

volumes:
  cliparr-data:

Ограничения и важные моменты

Для работы Cliparr требуется надежный APP_KEY длиной не менее 32 символов для шифрования учетных данных. Если ты изменишь его, придется заново аутентифицироваться на медиа-серверах.

Также важно использовать HTTPS для редактирования, так как браузеры требуют защищенный контекст для работы с WebCodecs.

Обратите внимание: если используешь Jellyfin, для неадминистраторских аккаунтов необходима версия Jellyfin 10.11 или выше для поддержки живых сессий. На более старых версиях тебе нужно обновить Jellyfin или подключить аккаунт администратора.

Разработка и участие

Если ты хочешь внести свой вклад в проект, его можно клонировать с GitHub и настроить локальную среду:

git clone https://github.com/techsquidtv/cliparr.git
cp .env.example .env
pnpm install
pnpm dev

Подробные рекомендации по участию доступны в файле CONTRIBUTING.md в репозитории.

Cliparr распространяется под лицензией MIT.