Skip to content
Back to search

gta6-clipper

MarketplaceWorks with Claude CodeGitHub

A hands-off clip factory for game streams: discover, score, cut, judge, edit, post, learn.

Safety scan

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

Badge for your README
findsafeskills safety rating

Markdown

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

HTML

<a href="/listings/taarruunnnn--gta6-clipper"><img src="/api/listings/taarruunnnn--gta6-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.

New to the terminal? That's fine. Open the **Terminal** app and paste these one block at a time.

**You need:** a Mac with Apple Silicon (M1 or newer) is the tested setup. Windows and Linux are written but untested, see [Platform support](#platform-support).

**1. Install the basics** (skip any you already have). [Homebrew](https://brew.sh) is the Mac's app installer for the terminal:

brew install python ffmpeg node

**2. Install Claude Code** and sign in. It is the AI that judges clips and writes hooks: [claude.com/claude-code](https://claude.com/claude-code)

**3. Download this project:**

git clone https://github.com/taarruunnnn/gta6-clipper
cd gta6-clipper

**4. Install its parts:**

python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
(cd motion && npm install)

**5. Open the dashboard:**

python -m clipper ui

Your browser opens at `http://127.0.0.1:8765`. That page is your control room.

> Every time you come back later, run `cd gta6-clipper` and `source .venv/bin/activate` first.

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 · 15 lines
  1. {
  2. "name": "gta6-clipper",
  3. "description": "A hands-off clip factory for game streams: discover, score, cut, judge, edit, post, learn.",
  4. "owner": { "name": "taarruunnnn", "url": "https://github.com/taarruunnnn" },
  5. "plugins": [
  6. {
  7. "name": "gta6-clipper",
  8. "source": "./",
  9. "description": "Find the best moments in game streams, edit them into vertical Shorts, and post them. Runs locally; nothing is posted publicly without your say.",
  10. "version": "0.1.0",
  11. "category": "productivity",
  12. "tags": ["clipping", "shorts", "twitch", "youtube", "video", "gaming"]
  13. }
  14. ]
  15. }
README.md · README · 323 lines
  1. <div align="center">
  2. <img src="docs/logo.png" width="170" alt="GTA 6 Clipper logo">
  3. <h1 align="center">GTA 6 Clipper</h1>
  4. <p align="center"><b>Streamers make the moments.<br>This finds them, edits them and posts them while you sleep.</b></p>
  5. <p align="center"><b>The open-source GTA 6 clipper</b> · a Claude Code skill · works with OpenAI Codex · YouTube Shorts automation · built for GTA 6, works for any game</p>
  6. <p align="center">A hands-off clip factory for game streams. It watches the biggest streams of a game, catches the moments viewers react to, turns them into vertical Shorts with a hook, animated captions and a narrator, writes titles from real search data, and uploads them to your YouTube channel. Everything runs on your own computer.</p>
  7. <p align="center">
  8. <img src="https://img.shields.io/badge/Claude_Code-plugin_%2B_skill-FFD400?labelColor=111111" alt="Claude Code plugin and skill">
  9. <img src="https://img.shields.io/badge/clips-1080x1920-FFD400?labelColor=111111" alt="clips 1080x1920">
  10. <img src="https://img.shields.io/badge/posting-YouTube_Shorts-FFD400?labelColor=111111" alt="posts to YouTube Shorts">
  11. <img src="https://img.shields.io/badge/cost-free_to_run-FFD400?labelColor=111111" alt="free to run">
  12. </p>
  13. <p align="center">
  14. <img src="https://img.shields.io/badge/tested_on-macOS_Apple_Silicon-FFD400?labelColor=111111" alt="tested on macOS Apple Silicon">
  15. <img src="https://img.shields.io/badge/python-3.10%2B-FFD400?labelColor=111111" alt="python 3.10+">
  16. <img src="https://img.shields.io/badge/license-MIT-FFD400?labelColor=111111" alt="MIT license">
  17. <a href="https://github.com/taarruunnnn/gta6-clipper/stargazers"><img src="https://img.shields.io/github/stars/taarruunnnn/gta6-clipper?style=flat&color=FFD400&labelColor=111111" alt="GitHub stars"></a>
  18. </p>
  19. <p align="center"><sub>Unofficial fan project. Not affiliated with Rockstar Games, Take-Two, Twitch, YouTube or Anthropic.</sub></p>
  20. <p align="center">
  21. <a href="#install-in-5-minutes">Install</a> ·
  22. <a href="#your-first-clip">First clip</a> ·
  23. <a href="#let-it-run-by-itself">Run hands-off</a> ·
  24. <a href="#post-to-youtube">Post to YouTube</a> ·
  25. <a href="#use-it-from-claude-or-chatgpt">Claude / ChatGPT</a> ·
  26. <a href="#using-it-give-it-a-shoutout">Shoutout</a> ·
  27. <a href="#questions-people-ask">FAQ</a> ·
  28. <a href="#contact">Contact</a>
  29. </p>
  30. </div>
  31. ```
  32. /plugin marketplace add taarruunnnn/gta6-clipper
  33. /plugin install gta6-clipper@gta6-clipper
  34. ```
  35. Two lines in Claude Code, then say: *"Use gta6-clipper to set up a clips channel for GTA 6 and show me today's best moments."*
  36. > ⭐ **If this helps you, please star the repo.** It is how other people find it. Bugs, ideas and pull requests are all welcome: see [CONTRIBUTING.md](CONTRIBUTING.md).
  37. ---
  38. ## What a finished clip looks like
  39. <p align="center"><img src="docs/layout.png" width="620" alt="Layout of a finished clip: hook, watch cue, reaction text, captions, credit, progress bar"></p>
  40. Every part is there for a reason: the **hook** stops the swipe, the **watch cue** gives a reason to stay, the **reaction text** and a flash make the moment land with the sound off, **captions** carry the clip for people watching muted. A British-voiced narrator sets up the clip in the first seconds and reacts after the payoff, and every piece of text arrives with a sound.
  41. ## What it does for you
  42. | | |
  43. |---|---|
  44. | 🔎 **Finds moments** | Today's most-viewed viewer clips on Twitch, live streams (cuts when chat explodes), and finished YouTube streams |
  45. | 🧠 **Picks only good ones** | An AI judge looks at frames and the transcript, scores each clip 1-10 and throws out the dull, the unsafe and the wrong-language ones |
  46. | ✂️ **Edits** | Vertical 1080x1920 with hook, animated word-by-word captions, emojis, zoom on the peak, narrator and sound effects |
  47. | 🏷️ **Writes titles that get found** | Pulls what people are searching on YouTube right now and picks the title by a scoring rule, not by taste |
  48. | 🚀 **Posts** | Straight to your YouTube channel through your own free Google project |
  49. | 📈 **Learns** | Reads view counts back and feeds your best hooks and titles into the next ones |
  50. ## Install in 5 minutes
  51. New to the terminal? That's fine. Open the **Terminal** app and paste these one block at a time.
  52. **You need:** a Mac with Apple Silicon (M1 or newer) is the tested setup. Windows and Linux are written but untested, see [Platform support](#platform-support).
  53. **1. Install the basics** (skip any you already have). [Homebrew](https://brew.sh) is the Mac's app installer for the terminal:
  54. ```bash
  55. brew install python ffmpeg node
  56. ```
  57. **2. Install Claude Code** and sign in. It is the AI that judges clips and writes hooks: [claude.com/claude-code](https://claude.com/claude-code)
  58. **3. Download this project:**
  59. ```bash
  60. git clone https://github.com/taarruunnnn/gta6-clipper
  61. cd gta6-clipper
  62. ```
  63. **4. Install its parts:**
  64. ```bash
  65. python3 -m venv .venv
  66. source .venv/bin/activate
  67. pip install -r requirements.txt
  68. (cd motion && npm install)
  69. ```
  70. **5. Open the dashboard:**
  71. ```bash
  72. python -m clipper ui
  73. ```
  74. Your browser opens at `http://127.0.0.1:8765`. That page is your control room.
  75. > Every time you come back later, run `cd gta6-clipper` and `source .venv/bin/activate` first.
  76. ## Your first clip
  77. 1. Find who is streaming your game right now:
  78. ```bash
  79. python -m clipper streams
  80. ```
  81. 2. Copy a link from that list, or any YouTube or Twitch video link, paste it into the box at the top of the dashboard and click **Find clips**.
  82. 3. Wait a minute or two. Clips appear with a hook, title and caption already written. Watch them, edit anything, click **Render**.
  83. Nothing has been posted anywhere. The finished videos are on your computer, and **Show file** opens the folder.
  84. ## Let it run by itself
  85. ```bash
  86. python -m clipper auto
  87. ```
  88. That one command loops forever: discover, judge, edit and (if you allow it) post. To have it start whenever you log in to your Mac:
  89. ```bash
  90. python -m clipper autostart on
  91. ```
  92. **Two safety catches are on by default**, so nothing surprising happens on day one:
  93. | Setting | Default | What it means |
  94. |---|---|---|
  95. | `mode` | `"approve"` | Clips are prepared, but you press **Post** |
  96. | `privacy` | `"private"` | Uploads are visible only to you |
  97. When you trust it, switch them in `config.local.toml` (see [Make it yours](#make-it-yours)).
  98. > 💤 **It only works while the computer is awake.** The loop keeps a Mac awake while it is plugged in with the lid open (the screen can turn off). Close the lid and it pauses; open it and it carries on where it left off.
  99. ## Post to YouTube
  100. This is the fiddliest part, and you only do it once. It is free and allows 100 uploads a day.
  101. 1. Go to [console.cloud.google.com](https://console.cloud.google.com), create a project, and enable **YouTube Data API v3**.
  102. 2. Open **Google Auth Platform**, choose **External**, and add your own Google account as a **test user**.
  103. 3. Under **Clients**, create a client of type **Desktop app** and download its JSON file.
  104. 4. Save that file in the `gta6-clipper` folder as `client_secret.json`.
  105. 5. Connect your channel:
  106. ```bash
  107. python -m clipper youtube-login
  108. ```
  109. Pick your channel and approve. Google shows an "unverified app" warning because the app is your own; that is expected.
  110. Do one private upload first and watch it on your phone before going public.
  111. ## Make it yours
  112. Create a file called `config.local.toml` in the project folder. Anything you put there overrides the defaults in `config.toml`, and it is never uploaded anywhere.
  113. ```toml
  114. [brand]
  115. handle = "@yourchannel" # shown as a small watermark
  116. accent = "#FFD400" # hook box and highlight colour
  117. [auto]
  118. game = "Grand Theft Auto VI" # exactly as Twitch names the category
  119. seo_seed = "gta 6" # the phrase titles are built around
  120. mode = "auto" # post without asking
  121. daily_cap = 4 # posts per day
  122. [youtube]
  123. channel_id = "UC..." # uploads to any other channel are refused
  124. privacy = "public"
  125. ```
  126. Works for any game Twitch has a category for: change `game` and `seo_seed`.
  127. <details>
  128. <summary><b>All commands</b></summary>
  129. ```bash
  130. python -m clipper ui # the dashboard
  131. python -m clipper streams # who is live with the game
  132. python -m clipper radar <twitch-login> # what viewers are clipping on a channel
  133. python -m clipper find <url> # best moments of a finished stream or video
  134. python -m clipper live <url> --minutes 120 # cut a clip whenever chat explodes
  135. python -m clipper keywords # what people search, ranked by views
  136. python -m clipper topics # searched moments, and your clips for each
  137. python -m clipper learn # view counts and what is working
  138. python -m clipper auto # the whole loop
  139. python -m clipper autostart on|off|status # start at login (macOS)
  140. python -m clipper list # every clip and its status
  141. ```
  142. </details>
  143. <details>
  144. <summary><b>The two edit styles and what they cost</b></summary>
  145. | | Classic | Motion (`motion = true`, the default) |
  146. |---|---|---|
  147. | Text | Still hook box and captions | Animated hook, popping captions, emojis, cue and reaction text |
  148. | Audio | Narrator intro | Narrator intro and reaction, a sound on every text element |
  149. | Time per 20 s clip on an M5 | about 16 s | about 100-160 s |
  150. The loop renders quick previews in the classic style and only uses motion for the clip it is about to post, so six posts a day cost well under an hour of background processing.
  151. </details>
  152. ## Use it from Claude or ChatGPT
  153. **Claude Code**: the two `/plugin` lines at the top install a skill. After that, just ask in plain words: *"clip this stream"*, *"what are people searching for GTA 6"*, *"start the clipper"*.
  154. **Claude apps**: zip the `skills/gta6-clipper` folder and upload it as a skill.
  155. **ChatGPT**: the browser version cannot run programs on your computer, so it can only guide you. Paste the contents of [`skills/gta6-clipper/SKILL.md`](skills/gta6-clipper/SKILL.md) into a project or custom GPT as instructions. OpenAI's **Codex** command-line agent can run the project itself; it reads [`AGENTS.md`](AGENTS.md).
  156. ## How it works
  157. ```mermaid
  158. flowchart LR
  159. A[Discover<br>Twitch clips, live chat,<br>YouTube streams] --> B[Score<br>loudness, chat,<br>most replayed]
  160. B --> C[Cut<br>word timestamps,<br>sentence edges]
  161. C --> D{Judge<br>frames + transcript}
  162. D -- keep --> E[Edit<br>hook, captions,<br>narrator, sound]
  163. D -- reject --> X[Dropped]
  164. E --> F[Post<br>YouTube Shorts]
  165. F --> G[Learn<br>views feed back]
  166. G --> A
  167. ```
  168. For a long stream it never downloads the whole video. It scores every second from the audio and metadata alone, downloads only the 40 seconds around each winning moment, and starts the cut on a sentence about 12 seconds before the peak so the build-up is intact.
  169. ## Questions people ask
  170. **Will this make me money or get me views?** Nobody can promise that, and this README won't. It gives you speed and consistency. Views depend on the moments, the competition and luck.
  171. **Does it cost anything?** The tool is free. You need a Claude Code subscription for the AI judge. YouTube posting is free.
  172. **Is it allowed to post other people's streams?** Only if the creator allows it. Read [Use it responsibly](#use-it-responsibly) before you post anything.
  173. **Will it slow my computer down?** Barely. Heavy work runs at background priority on the efficiency cores, one job at a time.
  174. **Does it work when my laptop is asleep?** No. A sleeping computer runs nothing. Keep it plugged in with the lid open, or use a desktop.
  175. **Why were most of my clips rejected?** That is normal. The judge keeps roughly one clip in eight to ten. Lower `min_score` in the config if you want more volume and accept weaker clips.
  176. **Why is there a line about gta6-clipper in my video descriptions?** It is a small credit that keeps this free project discoverable. One setting turns it off: `tool_credit = false`.
  177. **Can I use my own voice or style?** Yes. Colours, fonts, the narrator voice, sound effects and layout are all settings in `config.toml`.
  178. ## Platform support
  179. | | Status |
  180. |---|---|
  181. | macOS on Apple Silicon | Developed and tested here: GPU transcription, hardware video encoding, start at login |
  182. | Linux, Windows, NVIDIA GPUs | The code paths are written (faster-whisper, NVENC or x264, font fallbacks) but **have never been run**. Expect rough edges. Reports and fixes are very welcome |
  183. ## Use it responsibly
  184. This tool reposts other people's work. That puts obligations on you, not on the software.
  185. - Clip creators who allow it: a clipping campaign, a stated clip policy, or direct permission. Keep the credit on.
  186. - Adding a hook and captions is editing, not permission. A creator or publisher can still have a clip removed.
  187. - If a creator asks you to take something down, do it and add them to `blocklist`.
  188. - Plain reposts are generally not eligible for platform monetisation. Your own commentary is what changes that.
  189. - Posting unattended means nobody looked at the clip first. The judge filters a lot, not everything.
  190. ## Known limits
  191. - Streams longer than 4 hours are skipped on YouTube.
  192. - Live mode on Twitch records what an anonymous viewer sees, including ad-break screens. The judge rejects them, but they waste time.
  193. - Loudness alone is a weak signal; most picks from streams with nothing else get rejected.
  194. - The narrator uses an unofficial free route to Microsoft's online voices and can break without notice.
  195. - There are no automated tests yet.
  196. ## Using it? Give it a shoutout
  197. This tool is free and always will be. If it earns you views, the best thank-you is telling other creators where it came from. Three easy ways, pick any:
  198. **1. Leave the credit line on (it is already on).** Every video description ends with one line:
  199. ```
  200. Clipped with gta6-clipper (free, open source): github.com/taarruunnnn/gta6-clipper
  201. ```
  202. It costs you nothing and it is how the next creator finds the tool. To remove it, set `tool_credit = false` under `[publish]` in `config.local.toml`. No hard feelings.
  203. **2. Mention it once.** Copy any of these into a video, a community post, or your channel's About page:
  204. > My clips are made with gta6-clipper, a free open-source tool that finds and edits the best stream moments automatically: github.com/taarruunnnn/gta6-clipper
  205. > How I make these clips: gta6-clipper, free on GitHub. Link in the description.
  206. Have a site, a Notion page or your own repo? Use the badge:
  207. ```markdown
  208. [![Clipped with gta6-clipper](https://img.shields.io/badge/clipped_with-gta6--clipper-FFD400?labelColor=111111)](https://github.com/taarruunnnn/gta6-clipper)
  209. ```
  210. [![Clipped with gta6-clipper](https://img.shields.io/badge/clipped_with-gta6--clipper-FFD400?labelColor=111111)](https://github.com/taarruunnnn/gta6-clipper)
  211. **3. Get your channel featured here.** Shoutouts go both ways: [fill in this short form](https://github.com/taarruunnnn/gta6-clipper/issues/new?template=showcase.yml) and your channel is added to the list below, with a link.
  212. ### Channels made with gta6-clipper
  213. | Channel | Game |
  214. |---|---|
  215. | [Vice Clipped - GTA 6 Clips](https://www.youtube.com/@viceclipped-t5r) | GTA 6 |
  216. | *Yours next: [add your channel](https://github.com/taarruunnnn/gta6-clipper/issues/new?template=showcase.yml)* | |
  217. ## Contributing
  218. The most useful things right now: run it on Windows or Linux and report what breaks, add tests, add more posting targets. Details in [CONTRIBUTING.md](CONTRIBUTING.md).
  219. ## Contact
  220. Questions, ideas, or want to learn how it was built? Email **[tarunkg1999@gmail.com](mailto:tarunkg1999@gmail.com)**, or [open an issue](https://github.com/taarruunnnn/gta6-clipper/issues) so others can benefit from the answer.
  221. ## License
  222. MIT. See [LICENSE](LICENSE). Built with [Claude Code](https://claude.com/claude-code).

Ratings and comments

Sign in to rate this skill.

Sign in

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