Skip to content
Back to search

ortha-clipper

MarketplaceWorks with Claude CodeGitHub

AI stream clipper for Claude Code: streams to captioned 9:16 shorts, with Claude as the editor.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/connectfazla--ortha-clipper/badge.svg)](/listings/connectfazla--ortha-clipper)

HTML

<a href="/listings/connectfazla--ortha-clipper"><img src="/api/listings/connectfazla--ortha-clipper/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Requires [Claude Code](https://claude.com/claude-code) and [uv](https://docs.astral.sh/uv/). ffmpeg is recommended; a bundled one is used if it's missing.

/plugin install ortha-clipper --marketplace connectfazla/ortha-clipper

On older Claude Code versions:

/plugin marketplace add connectfazla/ortha-clipper
/plugin install ortha-clipper@ortha-clipper

Then just ask Claude:

> clip the best GTA 6 moments from https://www.twitch.tv/videos/... > > watch twitch.tv/somestreamer live and clip whenever chat goes off > > make 5 shorts from this YouTube stream https://www.youtube.com/watch?v=...

The first run asks for your clipper handle (for example `@yourclips`) and installs its Python dependencies automatically.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 12 lines
  1. {
  2. "name": "ortha-clipper",
  3. "description": "AI stream clipper for Claude Code: streams to captioned 9:16 shorts, with Claude as the editor.",
  4. "owner": { "name": "connectfazla", "url": "https://github.com/connectfazla" },
  5. "plugins": [
  6. {
  7. "name": "ortha-clipper",
  8. "source": "./",
  9. "description": "Turn Twitch/YouTube streams (live or VOD) into captioned 9:16 shorts. Claude is the editor."
  10. }
  11. ]
  12. }
README.md · README · 218 lines
  1. <p align="center">
  2. <img src=".claude-plugin/icon.png" width="88" alt="Ortha Clipper logo">
  3. </p>
  4. <h1 align="center">Ortha Clipper: AI GTA 6 &amp; Twitch Stream Clipper for Claude Code</h1>
  5. <p align="center">
  6. <b>Turn Twitch, YouTube and Kick streams (live or VOD) into captioned 9:16 clips for TikTok, YouTube Shorts and Instagram Reels.</b><br>
  7. It finds the moments from chat, audio, the transcript and YouTube comments, and Claude Code edits every clip.<br>
  8. An open-source Opus Clip alternative for stream clippers. No API keys: it runs on your Claude subscription.
  9. </p>
  10. <p align="center">
  11. <a href="LICENSE"><img alt="MIT license" src="https://img.shields.io/badge/license-MIT-7c6cff"></a>
  12. <img alt="Claude Code plugin" src="https://img.shields.io/badge/Claude%20Code-plugin-7c6cff">
  13. <img alt="Python 3.10+" src="https://img.shields.io/badge/python-3.10%2B-3ecf8e">
  14. <img alt="Works with Twitch, YouTube, Kick" src="https://img.shields.io/badge/Twitch%20%C2%B7%20YouTube%20%C2%B7%20Kick-supported-f5a524">
  15. </p>
  16. <p align="center">
  17. <a href="#install">Install</a> ·
  18. <a href="#clip-gta-vi-streams">GTA VI</a> ·
  19. <a href="#how-it-picks-moments">How it picks moments</a> ·
  20. <a href="#the-dashboard">Dashboard</a> ·
  21. <a href="#token-use">Token use</a> ·
  22. <a href="#faq">FAQ</a>
  23. </p>
  24. <p align="center">
  25. <img src="docs/editor.png" alt="Ortha Clipper editor: stream moments list, 16:9 source with facecam and gameplay boxes, 9:16 output preview, transcript and chat timeline, and inspector for layout, hook and captions" width="100%">
  26. </p>
  27. ---
  28. Ortha Clipper is a free, open-source **AI stream clipper** that runs inside [Claude Code](https://claude.com/claude-code). Paste a stream link. It finds the moments that hit, cuts them, frames the facecam and gameplay, burns in word-by-word captions and a hook, adds **your** clipper tag, and checks every render before you post it.
  29. Most AI clippers send a transcript to a language model and hope. Ortha Clipper works like an editing team:
  30. - **The script measures.** It downloads, reads chat, measures loudness, transcribes and renders, all locally. This part is deterministic and fast.
  31. - **Claude edits.** Before cutting, it reads why each moment scored, what was said around it, what chat wrote and what commenters remembered. It picks the moments worth posting, trims from setup to payoff, writes the hook, frames the shot from a real frame, follows whoever is talking, then looks at the rendered result and re-cuts it if something is off.
  32. ## Clip GTA VI streams
  33. GTA 6 is the biggest thing on Twitch and YouTube right now, and the clippers who post first get the views.
  34. - **Knows the game.** It reads GTA VI (also GTA V, Fortnite, Valorant, CS2, Warzone, Minecraft, Marvel Rivals and more) from the stream title. Hooks name the play ("1 VS 3", "HE GOT WASTED"), titles name the game, and posts carry the hashtags people search for: `#GTA6 #GTAVI #GTA6Game #ViceCity #RockstarGames`.
  35. - **Facecam + gameplay layout.** Facecam on top, Vice City below, in proper 9:16, with the HUD and overlay borders cropped out.
  36. - **Remembers each streamer.** Frame a GTA streamer's facecam once and every later stream from that channel opens already framed.
  37. - **Clips live.** Watch a GTA 6 stream live and get a saved clip seconds after chat goes off, ahead of the people clipping the VOD tomorrow.
  38. ## How it picks moments
  39. Each 5-second slice of the stream is scored against **that stream's own normal**. The signals are independent and capped, so no single one decides:
  40. | Signal | What it catches |
  41. |---|---|
  42. | **Chat** | Distinct people reacting (not messages, so one spammer can't fake a spike), plus hype words like `KEKW`, `W` and `?????` |
  43. | **Audio** | Loudness spikes, and the *silence-then-outburst* shape of a real reaction |
  44. | **Transcript** | A free local Whisper pass over the whole stream: "no way", "oh my god", "clip it", fast excited speech |
  45. | **YouTube comments** | Timestamps viewers wrote ("2:13:40 LMAO"), weighted by likes |
  46. Every moment shows **why** it scored and **what was said**. Claude also reads a compact skim of the whole transcript to catch the stories, hot takes and setups that chat stayed quiet for, then applies the **3-second test** working clippers use: would a stranger get it within 3 seconds?
  47. Before any clip is cut, Ortha Clipper writes a `context.md` for that moment: the surrounding transcript, the chat in that window, and the comments pointing at it. The editor reads it first.
  48. ## What it does
  49. | | |
  50. |---|---|
  51. | **Live and VOD** | `live` keeps a rolling 4-minute buffer and saves a moment the instant chat spikes (Twitch IRC, YouTube live chat). `scan` covers a finished stream or a local recording. |
  52. | **Downloads only what it needs** | Chat plus the smallest *original-language* audio track (about 20 MB per hour; YouTube's AI-dubbed tracks are skipped). Video is downloaded only for the moments you keep. Long scans resume if interrupted. |
  53. | **Speaker-aware framing** | Facecam + gameplay, crop-to-fill, whole frame on blur, or **timed shots** that cut to whoever is talking (duo cams, panels, podcasts). |
  54. | **Word-by-word captions** | The active word is highlighted, timed from Whisper word timestamps, and proofread by Claude for names and slang. Captions are drawn as image overlays, so they work with any ffmpeg build. |
  55. | **Your brand** | Your clipper handle goes on every clip. Streamer credit goes in the post copy. |
  56. | **Ready to post** | 1080×1920 H.264, loudness at -14 LUFS, `+faststart` for iOS, plus a `post.md` with a title, TikTok/Reels caption, hashtags and a Shorts description. |
  57. | **Multi-agent** | One Sonnet `clip-editor` subagent per clip, in parallel. Opus steps in only for clips that need a second look. |
  58. ## The dashboard
  59. Every command opens a local dashboard at **http://localhost:8790**.
  60. <p align="center">
  61. <img src="docs/home.png" alt="Ortha Clipper home dashboard: paste a stream link, streams with GTA VI tags and moment counts, recent vertical clips" width="100%">
  62. </p>
  63. - **Home:** paste a link and press *Find moments* (no AI tokens) or *Auto-clip with Claude* (Haiku, Sonnet or Opus). A link that's live right now gets watched live automatically. Running jobs show their latest step and a Stop button, each stream card says what's happening and what to do next, and recent clips open in one click. Your tag is in the header, and clicking *Ortha Clipper* always brings you back Home.
  64. - **Editor:** a pro editing layout.
  65. - The 16:9 source with **framing boxes you draw on the video**, next to a live 9:16 output preview.
  66. - A transport bar, and a timeline with transcript and chat tracks and drag-to-trim handles. Keys: `Space` plays, `I`/`O` set in and out.
  67. - A whole-stream view with chat, audio, speech and comment tracks and every moment marked.
  68. - **Inspector:**
  69. - **Edit:** why the moment scored, then layout, trim, hook, captions and tag. *Ask Claude* and *Render clip* stay pinned at the bottom.
  70. - **Context:** why the moment scored, the transcript before and after it, the chat in that window, and the comments.
  71. - **Publish:** QA frames, post copy and versions.
  72. - **All clips:** every render in one grid.
  73. <p align="center">
  74. <img src="docs/context.png" alt="Ortha Clipper whole-stream timeline with chat, audio, speech and YouTube comment tracks, and the context panel showing why a moment scored, the transcript around it and the chat in that window" width="100%">
  75. </p>
  76. The dashboard only listens on `127.0.0.1` and checks a per-session token on every action, so other websites can't start jobs on your machine.
  77. <sub>Screenshots show public VODs analyzed locally. Video frames and chat usernames are blurred.</sub>
  78. ## Install
  79. Requires [Claude Code](https://claude.com/claude-code) and [uv](https://docs.astral.sh/uv/). ffmpeg is recommended; a bundled one is used if it's missing.
  80. ```
  81. /plugin install ortha-clipper --marketplace connectfazla/ortha-clipper
  82. ```
  83. On older Claude Code versions:
  84. ```
  85. /plugin marketplace add connectfazla/ortha-clipper
  86. /plugin install ortha-clipper@ortha-clipper
  87. ```
  88. Then just ask Claude:
  89. > clip the best GTA 6 moments from https://www.twitch.tv/videos/...
  90. >
  91. > watch twitch.tv/somestreamer live and clip whenever chat goes off
  92. >
  93. > make 5 shorts from this YouTube stream https://www.youtube.com/watch?v=...
  94. The first run asks for your clipper handle (for example `@yourclips`) and installs its Python dependencies automatically.
  95. ## Token use
  96. Measured on real runs, one clip each:
  97. | Part | Model | Input tokens | Output tokens |
  98. |---|---|---|---|
  99. | Main session: scan, analyse, pick, delegate | Haiku or Sonnet | ~400k raw, ~75k after caching | ~6k |
  100. | Clip editor, per clip | Sonnet | 60–140k raw, 16–32k after caching | 2–3.5k |
  101. Dashboard runs start Claude without your other MCP servers and plugins: **19.5k instead of 39.6k context tokens per turn**. The scan itself (chat, audio, transcript, comments) uses no AI tokens.
  102. ## How it works
  103. ```mermaid
  104. flowchart LR
  105. A[Stream URL<br/>live or VOD] --> B[Chat · audio · transcript<br/>· comments, no video]
  106. B --> C[Score vs this<br/>stream's normal]
  107. C --> D[Grab only the<br/>hot sections]
  108. D --> E[context.md · transcript<br/>· contact sheet]
  109. E --> F{{Claude edits<br/>trim · framing · hook}}
  110. F --> G[Render 9:16<br/>captions · tag]
  111. G --> H{{Claude QA<br/>looks at the frames}}
  112. H -- fix --> F
  113. H -- ok --> I[Clip + post.md]
  114. ```
  115. | Source | VOD chat | Live chat |
  116. |---|---|---|
  117. | YouTube | chat replay via yt-dlp | live chat via yt-dlp |
  118. | Twitch | audio, transcript, or `--chat` with a [TwitchDownloader](https://github.com/lay295/TwitchDownloader) export | anonymous IRC |
  119. | Kick / local file | audio and transcript | n/a |
  120. ## Command line
  121. Claude runs these for you, but you can run them yourself too:
  122. ```bash
  123. C="uv run --script skills/clip/clipper.py"
  124. $C config clipper "@yourclips" # your tag on every clip
  125. $C config cookies chrome # if YouTube says "confirm you're not a bot"
  126. $C scan <url|file> [--chat chat.json] # find moments (chat, audio, transcript, comments)
  127. $C grab <url|file> --moments 1,3,5 # grab several picks at once
  128. $C render clips/<src>/m3730 --in 4 --out 38 \
  129. --cam 0.73,0.04,0.25,0.26 --hook "he got wasted" --remember
  130. $C live <url> # clip a live stream as it happens
  131. $C find ["Grand Theft Auto VI"] # who is live now, most viewers first
  132. $C config twitch_id <id>; $C config twitch_secret <secret> # Twitch in find (free app at dev.twitch.tv)
  133. $C frames clips/<src>/m3730 12 14.5 20 # check exact moments
  134. ```
  135. Run the self-check with `uv run --script tests/test_clipper.py`.
  136. ## FAQ
  137. **How do I clip GTA 6 streams automatically?**
  138. Install the plugin and ask Claude to clip a GTA VI stream or VOD link, or paste it into the dashboard and choose *Auto-clip with Claude*. It detects the game, finds the moments, frames facecam + gameplay, captions the clip, and tags it `#GTA6`.
  139. **How does it decide what's worth clipping?**
  140. Chat, audio, the streamer's own words and viewers' comment timestamps are each scored against that stream's normal, and none of them decides alone. Claude then reads the context around each candidate, and skims the whole stream for anything the signals missed.
  141. **Is it an Opus Clip alternative?**
  142. Yes, built for streams. Opus Clip and similar tools pick moments from the transcript. Ortha Clipper adds chat, audio and comment signals, live clipping, facecam + gameplay framing and per-streamer profiles, and it runs locally for free.
  143. **Do I need an OpenAI, Gemini or Anthropic API key?**
  144. No. Claude Code does the editing on your existing Claude subscription. Transcription runs locally with faster-whisper.
  145. **Does it work with Twitch, YouTube and Kick?**
  146. Yes, for VODs. Live clipping works on Twitch and YouTube. Twitch VOD chat needs a TwitchDownloader export, since Twitch offers no public chat-replay API.
  147. **Can it clip a live stream before it ends?**
  148. Yes. `live` mode saves each moment about 15 seconds after chat spikes, with a desktop notification.
  149. **Will it work on podcasts, Just Chatting or IRL streams?**
  150. Yes. Timed shots follow whoever is talking, and the transcript signals work even without chat.
  151. **Is it free?**
  152. Yes, MIT licensed. The editing uses your Claude Code plan.
  153. ## Credits
  154. Ideas borrowed with thanks from [PeakCut](https://github.com/haziqahmedqasmi/peakcut) (game-aware copy, counting chatters instead of messages, per-creator profiles), [TwitchSnipBot](https://github.com/bihanikeshav/TwitchSnipBot) (z-score chat spikes), [vod-to-viral](https://github.com/LuisSotelo/vod-to-viral) (score chat and audio first, download only the hot segments), and [AI-Youtube-Shorts-Generator](https://github.com/Anil-matcha/AI-Youtube-Shorts-Generator) (a score and hook for each clip). The moment criteria follow published clipper playbooks from AutoClip, CLIPPING, Clyper and LazyClipper.
  155. ## Responsible clipping
  156. Clip other people's streams only with their permission or through a clipping program they run, and always credit the streamer.
  157. *Ortha Clipper is not affiliated with or endorsed by Rockstar Games, Take-Two Interactive, Twitch, YouTube, Kick or Opus Clip. Grand Theft Auto and GTA are trademarks of Take-Two Interactive.*
  158. MIT © [connectfazla](https://github.com/connectfazla) · Built by [Ortha Studio](https://ortha.studio)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.