Documentation

Getting started

Run Cliparr with Docker, keep settings persistent, and open the app for the first time.

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 127.0.0.1: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 127.0.0.1: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.

The default port binding accepts connections only from this computer. For remote access, use a VPN or authenticated reverse proxy as described in Access control. APP_KEY protects stored credentials; it is not an app login.

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:
      - "127.0.0.1:7171:7171"
    environment:
      - APP_KEY=replace-this-with-a-32-character-secure-random-string
    volumes:
      - cliparr-data:/data
    read_only: true
    tmpfs:
      - /tmp:rw,noexec,nosuid,size=64m
    cap_drop: [ALL]
    security_opt: [no-new-privileges:true]
    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.

On phones, use the bottom action bar: Trim for exact clip boundaries, Subtitles for captions, and Crop for framing. Done closes the active tool and returns to the workspace.

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.