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

On Windows, run this from Docker Desktop or another Docker engine using Linux containers. Cliparr publishes Linux container images for linux/amd64 and linux/arm64.

Open http://localhost:7171, 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.

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:

Next steps

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