GitHub - TechSquidTV/Cliparr: Create clips from media on your personal media server

Instant media clipper for your personal media server.

Cliparr is a streamlined media clipper that allows you to quickly create and download clips from the media currently playing on your Plex or Jellyfin server.

Firefox.mp4

Features

Instant Session Discovery: Automatically loads your media player's currently playing file.
Intuitive Timeline Editor: Familiar UI based on common video editing interfaces.
Local Transcoding: Powered by Mediabunny, video is transcoded in your browser.
Rich Metadata Tagging: Clips are exported with full EXIF data, including Season, Episode numbers, and timing metadata.
Native Plex & Jellyfin Support: Seamless integration with the most popular media server platforms.

Getting Started

Quick Start with Docker

The fastest way to get Cliparr running is via the GitHub Container Registry.

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

Important

Stable APP_KEY Required: Cliparr uses APP_KEY to encrypt your provider credentials at rest. You must use a stable, random secret. If you change this key later, you will need to re-authenticate your media servers.

Using Docker Compose

For a persistent setup, we recommend using Docker Compose:

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

volumes:
  cliparr-data:

Configuration

Variable	Description	Default
`APP_KEY`	Required secret for credential encryption.	-
`PORT`	Internal port for the Express server.	`3000`
`CLIPARR_DATA_DIR`	Directory for SQLite storage.	`/data`
`CLIPARR_ALLOW_LOOPBACK_JELLYFIN_URLS`	Allow Jellyfin URLs that resolve to `localhost`/loopback. Use only for trusted self-hosted setups.	`false`

When running behind a reverse proxy, preserve the Host header and pass X-Forwarded-Proto. Cliparr trusts loopback, link-local, and private-LAN proxy ranges directly in the app, so typical Caddy/Nginx/Traefik setups on the same network do not need extra app configuration. Caddy already forwards the needed headers.

Development

We welcome contributions! To get started with a local development environment:

Clone: git clone https://github.com/techsquidtv/cliparr.git
Setup: cp .env.example .env (and fill in APP_KEY)
Install: pnpm install
Run: pnpm dev

See CONTRIBUTING.md for more detailed guidance.

License

Cliparr is released under the MIT License.