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 127.0.0.1:7171:7171 \
-e APP_KEY="your-32-char-stable-random-secret" \
-v cliparr-data:/data \
ghcr.io/techsquidtv/cliparr:latestdocker 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:latestOn 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.
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.