Repolode
TechSquidTV

TechSquidTV/Cliparr

Self-hosted web app to trim video, add subtitles, and export clips or GIFs from Plex, Jellyfin, or local files.

Stars
217
Forks
6
Open issues
10
Last commit
2 hours ago

What is it?

Cliparr is a self-hosted clipping tool for personal media libraries. It connects to Plex and Jellyfin servers and follows playback automatically, so you can start a clip from what you are currently watching. Local video files can be opened directly in the browser without uploading them.

The editor uses a timeline to trim and fine-tune a clip range. You can create your own subtitles or import existing ones, style them, and burn them into the output. Exports can be video, audio-only, or GIF, and run in the browser. Source details, artwork, and clip timing can be kept in supported video and audio containers.

Cliparr runs as a Docker container that serves a web interface on port 7171. It requires a secret APP_KEY of at least 32 characters, and HTTPS is needed for editing when accessed from other devices.

Key features

  • 01Follows live playback from connected Plex and Jellyfin servers.
  • 02Opens local video files without uploading them.
  • 03Non-linear timeline editor for trimming and zooming clip ranges.
  • 04Exports video, audio-only, or GIF files in the browser.
  • 05Creates, imports, styles, and burns subtitles into clips.
  • 06Keeps source metadata and artwork in supported containers.

Use cases

  • Sharing a favorite scene from a Plex or Jellyfin movie as a short video or GIF.
  • Extracting an audio clip from a local recording in your home media library.
  • Adding custom or imported subtitles to a short clip before sharing it.

Quick start

  1. 1

    Run the Cliparr container with Docker, replacing APP_KEY with your own 32+ character secret

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

    Open http://localhost:7171 in your browser, then connect a media server or choose Open Video for a local file

Things to know

  • Access from other devices requires HTTPS for editing.
  • Changing APP_KEY requires reconnecting your media servers.

In collections

Topics

FAQ

What is Cliparr?
Self-hosted web app to trim video, add subtitles, and export clips or GIFs from Plex, Jellyfin, or local files. Cliparr is a self-hosted clipping tool for personal media libraries. It connects to Plex and Jellyfin servers and follows playback automatically, so you can start a clip from what you are currently watching. Local video files can be opened directly in the browser without uploading them.
Is Cliparr free to use? What license does it have?
Cliparr is open source under the MIT license. Check the license terms before using it in commercial products.
Is Cliparr still maintained?
Actively maintained. The last commit to Cliparr was on Nov 7, 2026.
What can I use Cliparr for?
Sharing a favorite scene from a Plex or Jellyfin movie as a short video or GIF. Extracting an audio clip from a local recording in your home media library. Adding custom or imported subtitles to a short clip before sharing it.
How do I install Cliparr?
Run the Cliparr container with Docker, replacing APP_KEY with your own 32+ character secret: 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 Open http://localhost:7171 in your browser, then connect a media server or choose Open Video for a local file
Where can I get Cliparr?
The source code and installation instructions are on GitHub: https://github.com/TechSquidTV/Cliparr

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects