登录

Cliparr

TechSquidTVMIT活跃维护

从 Jellyfin、Plex 等自建媒体服务器中按需截取片段，省去手动下载整片再剪辑的麻烦，适合做精彩集锦或分享。

Create clips from media on your personal media server

v3.1.0发布于 2026-11-08 17:06 UTC223star +6 / 7 天7fork同步于 2026-11-10 12:04 UTC
媒体服务器视频剪辑片段截取自托管Jellyfin
对比 GitHub 官网jellyfinmedia-serverplexradarrself-hosted

怎么上手

由 README 提炼，执行前请确认
原文 
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
硬件要求按 README 说明

README 未说明硬件要求；剪辑与导出在浏览器中运行，服务端以 Docker 容器部署。

有 Docker 镜像
下载：源码 zip·GitHub Releases（安装包）本站不镜像安装包

项目说明

由 README 自动翻译提炼
没人工点评？写下你的经验

自托管的浏览器剪辑工具，从 Plex、Jellyfin 或本地文件里剪出片段

从 Jellyfin、Plex 等自建媒体服务器中按需截取片段，省去手动下载整片再剪辑的麻烦，适合做精彩集锦或分享。

核心能力

  • 自动跟随 Plex 和 Jellyfin 的播放会话发现媒体
  • 在浏览器内完成裁剪、按比例裁切画面
  • 导出视频、纯音频或 GIF，全程在浏览器执行
  • 保留源元数据、封面和片段时码写入容器
  • 自制或导入字幕并烧录进片段

容易踩的坑

APP_KEY 必须是至少 32 字符的随机串且需长期保持不变，更换后要重新连接媒体服务器；数据卷 /data 需在升级时保留；默认只绑定 127.0.0.1:7171，从其他设备访问编辑需配置 HTTPS。

内容由模型根据 README 生成，可能不完整或不准确，以官方文档为准。看原文 README

最近发版

5 个版本v3.1.0
全部 release
  1. v3.1.0最新正式版2026-11-08 · 2026-11-08 17:06 UTC

    Highlights

    • Crop video with freeform drawing, aspect-ratio presets, or exact pixel controls. On desktop, open Crop beside the screenshot button or expand Crop in the Properties sidebar. On phones, choose Crop in the bottom action bar; settings appear below the preview, and the timeline hides to give the picture more room. Done returns to the cropped preview, and Remove crop restores the full frame. Crops are saved in drafts, support undo/redo and touch controls, and apply to video, GIF, and screenshot exports before resizing and subtitles.
    • Edit more comfortably on phones with a larger preview and a bottom action bar for Trim, Subtitles, Crop, Playback, and More. Open subtitle controls when needed, adjust exact clip ranges in Trim, and expand track names from Timeline view. Pending edits, undo/redo history, and timeline position are preserved when switching tools or resizing the workspace.
    • See which stage each media source has reached while playback loads: connecting, finding playback, or preparing playback details. Sources that are ready remain available while others continue loading.
    • Connect to Plex servers faster when an earlier connection address is slow or unavailable by trying addresses in a staggered sequence.
    • Get a confirmation before leaving the editor during an active export. Reloading or closing the tab also requests a browser warning.
    • Export valid standalone FLAC files with short final frames in full. Cliparr continues to reject incomplete sources rather than silently exporting truncated audio.
    • Improve timeline playback and scrubbing, including playback boundary and audio-context suspension behavior.

    Maintenance

    Application dependencies and container images are updated. Container builds and deployment examples are hardened, and playback loading timings are available in the logging guide.

    Upgrade notes

    Existing Docker commands and Compose files retain their configured port binding, data volume, and APP_KEY. If you replace your configuration with this repository's updated Compose file, it binds port 7171 to localhost by default. For remote access, set CLIPARR_BIND_ADDRESS to an appropriate host interface and use a VPN or authenticated reverse proxy. See Access control.

    Source builds and integrations: The production, development, and capture Dockerfiles have been consolidated into docker/Dockerfile with corresponding build targets. Development provider profiles, volume ownership, and custom fixture checksum settings have also changed; see the Docker guide before updating a source checkout.

    Live playback integrations: The source-state stream can now report discovering and preparing. Custom clients that exhaustively handle source states must accept these values.

    If you are upgrading from 2.x, follow the v3.0.0 migration instructions first.

    What's Changed

  2. v3.1.0-rc.3pre-release2026-11-08 · 2026-11-08 04:50 UTC
    查看更新说明

    Highlights

    • Crop video with freeform drawing, aspect-ratio presets, or exact pixel controls. On desktop, open Crop beside the screenshot button or expand Crop in the Properties sidebar. On phones, choose Crop in the bottom action bar; settings appear below the preview, and the timeline hides to give the picture more room. Done returns to the cropped preview, and Remove crop restores the full frame. Crops are saved in drafts, support undo/redo and touch controls, and apply to video, GIF, and screenshot exports before resizing and subtitles.
    • Edit more comfortably on phones with a larger preview and a bottom action bar for Trim, Subtitles, Crop, Playback, and More. Open subtitle controls when needed, adjust exact clip ranges in Trim, and expand track names from Timeline view. Pending edits, undo/redo history, and timeline position are preserved when switching tools or resizing the workspace.
    • See which stage each media source has reached while playback loads: connecting, finding playback, or preparing playback details. Sources that are ready remain available while others continue loading.
    • Connect to Plex servers faster when an earlier connection address is slow or unavailable by trying addresses in a staggered sequence.
    • Get a confirmation before leaving the editor during an active export. Reloading or closing the tab also requests a browser warning.
    • Export valid standalone FLAC files with short final frames in full. Cliparr continues to reject incomplete sources rather than silently exporting truncated audio.
    • Improve timeline playback and scrubbing, including playback boundary and audio-context suspension behavior.

    Maintenance

    Application dependencies and container images are updated. Container builds and deployment examples are hardened, and playback loading timings are available in the logging guide.

    Upgrade notes

    Existing Docker commands and Compose files retain their configured port binding, data volume, and APP_KEY. If you replace your configuration with this repository's updated Compose file, it binds port 7171 to localhost by default. For remote access, set CLIPARR_BIND_ADDRESS to an appropriate host interface and use a VPN or authenticated reverse proxy. See Access control.

    Source builds and integrations: The production, development, and capture Dockerfiles have been consolidated into docker/Dockerfile with corresponding build targets. Development provider profiles, volume ownership, and custom fixture checksum settings have also changed; see the Docker guide before updating a source checkout.

    Live playback integrations: The source-state stream can now report discovering and preparing. Custom clients that exhaustively handle source states must accept these values.

    If you are upgrading from 2.x, follow the v3.0.0 migration instructions first.

    What's Changed

    Full Changelog: https://github.com/TechSquidTV/Cliparr/compare/v3.1.0-rc.2...v3.1.0-rc.3

    Docker image

    Published to ghcr.io/techsquidtv/cliparr.

    docker pull ghcr.io/techsquidtv/cliparr:3.1.0-rc.3

    Tags:

    • ghcr.io/techsquidtv/cliparr:3.1.0-rc.3
    • `ghcr.i
  3. v3.1.0-rc.2pre-release2026-11-07 · 2026-11-07 19:33 UTC
    查看更新说明

    Highlights

    • Crop video with freeform drawing, aspect-ratio presets, or exact pixel controls. On desktop, open Crop beside the screenshot button or expand Crop in the Properties sidebar. On phones, choose Crop in the bottom action bar; settings appear below the preview, and the timeline hides to give the picture more room. Done returns to the cropped preview, and Remove crop restores the full frame. Crops are saved in drafts, support undo/redo and touch controls, and apply to video, GIF, and screenshot exports before resizing and subtitles.
    • Edit more comfortably on phones with a larger preview and a bottom action bar for Trim, Subtitles, Crop, Playback, and More. Open subtitle controls when needed, adjust exact clip ranges in Trim, and expand track names from Timeline view. Pending edits, undo/redo history, and timeline position are preserved when switching tools or resizing the workspace.
    • See which stage each media source has reached while playback loads: connecting, finding playback, or preparing playback details. Sources that are ready remain available while others continue loading.
    • Connect to Plex servers faster when an earlier connection address is slow or unavailable by trying addresses in a staggered sequence.
    • Get a confirmation before leaving the editor during an active export. Reloading or closing the tab also requests a browser warning.
    • Export valid standalone FLAC files with short final frames in full. Cliparr continues to reject incomplete sources rather than silently exporting truncated audio.
    • Improve timeline playback and scrubbing, including playback boundary and audio-context suspension behavior.

    Maintenance

    Application dependencies and container images are updated. Container builds and deployment examples are hardened, and playback loading timings are available in the logging guide.

    Upgrade notes

    Existing Docker commands and Compose files retain their configured port binding, data volume, and APP_KEY. If you replace your configuration with this repository's updated Compose file, it binds port 7171 to localhost by default. For remote access, set CLIPARR_BIND_ADDRESS to an appropriate host interface and use a VPN or authenticated reverse proxy. See Access control.

    Source builds and integrations: The production, development, and capture Dockerfiles have been consolidated into docker/Dockerfile with corresponding build targets. Development provider profiles, volume ownership, and custom fixture checksum settings have also changed; see the Docker guide before updating a source checkout.

    Live playback integrations: The source-state stream can now report discovering and preparing. Custom clients that exhaustively handle source states must accept these values.

    If you are upgrading from 2.x, follow the v3.0.0 migration instructions first.

    What's Changed

  4. v3.1.0-rc.1pre-release2026-11-07 · 2026-11-07 02:49 UTC
    查看更新说明

    Highlights

    • Crop video with freeform drawing, aspect-ratio presets, or exact pixel controls. On desktop, open Crop beside the screenshot button or expand Crop in the Properties sidebar. On phones, choose Crop in the bottom action bar; settings appear below the preview, and the timeline hides to give the picture more room. Done returns to the cropped preview, and Remove crop restores the full frame. Crops are saved in drafts, support undo/redo and touch controls, and apply to video, GIF, and screenshot exports before resizing and subtitles.
    • Edit more comfortably on phones with a larger preview and a bottom action bar for Trim, Subtitles, Crop, Playback, and More. Open subtitle controls when needed, adjust exact clip ranges in Trim, and expand track names from Timeline view. Pending edits, undo/redo history, and timeline position are preserved when switching tools or resizing the workspace.
    • See which stage each media source has reached while playback loads: connecting, finding playback, or preparing playback details. Sources that are ready remain available while others continue loading.
    • Connect to Plex servers faster when an earlier connection address is slow or unavailable by trying addresses in a staggered sequence.
    • Get a confirmation before leaving the editor during an active export. Reloading or closing the tab also requests a browser warning.
    • Export valid standalone FLAC files with short final frames in full. Cliparr continues to reject incomplete sources rather than silently exporting truncated audio.
    • Improve timeline playback and scrubbing, including playback boundary and audio-context suspension behavior.

    Maintenance

    Application dependencies and container images are updated. Container builds and deployment examples are hardened, and playback loading timings are available in the logging guide.

    Upgrade notes

    Existing Docker commands and Compose files retain their configured port binding, data volume, and APP_KEY. If you replace your configuration with this repository's updated Compose file, it binds port 7171 to localhost by default. For remote access, set CLIPARR_BIND_ADDRESS to an appropriate host interface and use a VPN or authenticated reverse proxy. See Access control.

    Source builds and integrations: The production, development, and capture Dockerfiles have been consolidated into docker/Dockerfile with corresponding build targets. Development provider profiles, volume ownership, and custom fixture checksum settings have also changed; see the Docker guide before updating a source checkout.

    Live playback integrations: The source-state stream can now report discovering and preparing. Custom clients that exhaustively handle source states must accept these values.

    If you are upgrading from 2.x, follow the v3.0.0 migration instructions first.

    What's Changed

  5. v3.0.12026-10-20 · 2026-10-20 02:30 UTC
    查看更新说明

    Highlights

    • Reduce memory use for video and audio exports in browsers with a native save picker by writing directly to disk. Cliparr and Cliparr Convert now ask you to choose the save location before processing starts. GIFs and browsers without the picker continue to download after export.
    • GIF exports using Compact quality produce smaller files with the same appearance and timing.
    • Screen readers announce editor slider labels and values, including units. More interface animations respect your device's reduced-motion setting.
    • Restore rounded corners and opening animations on Cliparr Convert's dropdowns.

    Maintenance

    Much of this release reorganizes the editor, export, and media-server code and removes duplicated logic. Dependencies and Docker images are also updated.

    Upgrade notes

    No new data migration or configuration changes are required when upgrading from v3.0.0. If you are upgrading from 2.x, follow the v3.0.0 migration instructions first.

    When saving directly to disk, MP4, MOV, and M4A files place playback metadata at the end of the file. If you host these files for progressive playback, a player may need to fetch the end before playback starts. Files downloaded through the browser keep playback metadata at the beginning.

    What's Changed

用户点评

登录用户的真实使用记录，可按版本和硬件筛选
共 0 条

    还没有人点评。第一个说出真实体验的人最有价值。

    README 原文

    未翻译
    在 GitHub 打开

    Cliparr

    Self-hosted clipping for Plex, Jellyfin, and local files. Trim video, add subtitles, and export video, audio, or GIFs in your browser.

    Documentation

    Features

    • Live session discovery: Follow playback automatically from connected Plex and Jellyfin servers.
    • Open local videos: Clip local files without uploading them. Direct media URLs require provider sign-in.
    • Trim and crop: Fine-tune your clip range, then crop the picture freely or to an aspect ratio with mouse or touch controls.
    • Video, audio, and GIF export: Choose video or audio-only formats, or make a GIF. Exports run in your browser.
    • Metadata included: Keep source details, artwork, and clip timing in supported video and audio containers.
    • Subtitle authoring: Create your own captions or import subtitles, then style and burn subtitles into your clip.

    Quick start

    Replace APP_KEY with a random secret of at least 32 characters; for example, generate one with openssl rand -base64 32. Keep the secret and data volume across updates. Changing APP_KEY requires reconnecting your media servers.

    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

    Use Docker with Linux containers.

    Open http://localhost:7171, then connect a media server or choose Open Video for a local file. Access from other devices requires HTTPS for editing.

    For Docker Compose and installation details, see Getting started.

    Guides

    Development

    See Contributing for local setup, the Docker dev stack, validation, and release procedures.

    License

    MIT.

    相关项目

    同分类里 star 最高的项目
    对比全部 →
    immich
    immich-app·TypeScript

    自托管的照片和视频管理方案，可替代 Google Photos，支持自动备份、相册浏览和移动端同步，数据完全掌握在自己手里。

    自托管相册+4媒体库 / 流媒体服务
    118682+2577.5kv3.3.62026-11-10 11:04 UTC
    jellyfin
    jellyfin·C#

    自建媒体服务器后端，把本地电影、剧集和音乐整理成可流式播放的媒体库，并提供 API 供各类客户端接入。

    媒体服务器+4媒体库 / 流媒体服务
    59177+955.8kv12.42026-11-09 03:49 UTC
    srs
    ossrs·C++

    简单高性能的实时流媒体服务器，支持 RTMP、WebRTC、HLS、SRT 等主流协议和多种音视频编码，适合搭建低延迟直播与分发服务。

    流媒体服务器+4媒体库 / 流媒体服务
    29436+35.7kv6.0-r32026-10-31 00:42 UTC
    livekit
    livekit·Go

    基于 WebRTC 的实时音视频传输栈，用 SFU 架构把人和 AI 接进同一个房间，适合做语音 AI、视频通话和直播。

    实时音视频+4媒体库 / 流媒体服务
    22128+422.6kv1.13.112026-11-10 10:01 UTC