Getting started

Run Cliparr in Docker, then open the app and connect Plex, Jellyfin, or a local video. Mount /data before connecting media servers so settings and encrypted credentials survive updates.

Docker quick start

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

Open http://localhost:3000, connect Plex or Jellyfin, or choose Open Video for a local file.

Docker Compose

For a persistent setup, keep the same APP_KEY and volume across updates.

docker-compose.yml

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

volumes:
  cliparr-data:

Next steps

When a playable source is available, Cliparr opens the timeline editor. Pick the range you want to save, then export the clip.