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. The timeline spans the full video, and the block labeled with the media title represents the range to export. Drag the block to choose a different moment, or drag either edge to adjust In and Out.

Use the scrollbar to navigate and zoom into subtitle timing, then export the clip. See Editor shortcuts for precise timecodes, range editing, and long-video navigation.