Clips Kitty OBS Plugin

Pre-release. Needs the next Clips Kitty release, which adds the API this plugin uses. With Clips Kitty 1.1.4 or older the dock says "Please update Clips Kitty".

Create clips from your stream after it ends, without leaving OBS Studio.

The plugin adds a Clips Kitty dock to OBS. It stays idle while you are live. When your stream really ends, it opens Clips Kitty, which finds your Twitch or YouTube VOD and turns it into vertical clips with captions, on your own PC.

Clips Kitty does not perform AI or video processing while you are live.

How it works

1. You go live. The dock shows ● LIVE and AI processing: OFF. The plugin records when the stream started and which platform it went to. Nothing else runs: no network, no files, no processing.
2. The stream stops. The dock waits a confirmation delay (60 seconds by default). If you go live again inside it, as after a dropped connection, nothing is created.
3. The stream really ended. Depending on your setting, the dock asks "Create clips from this stream?", starts on its own, or waits for you to click Create Clips From Last Stream.
4. Clips Kitty takes over.
   • The plugin opens Clips Kitty and hands over the stream.
   • Clips Kitty waits for Twitch or YouTube to publish the VOD, which usually takes a few minutes, then downloads and clips it.
   • The dock shows the stage, percentage, time remaining and how many clips were made.

Editing, reviewing and posting clips all happen in the Clips Kitty app.

Requirements

• Windows 10 or 11, 64-bit.
• OBS Studio 31.1 or newer.
• Clips Kitty from the Microsoft Store or GitHub. You need a version with the integrations API. The dock tells you if yours is too old.
• Past broadcasts on. On Twitch, turn on Store past broadcasts in Creator Dashboard > Settings > Stream. YouTube keeps live streams by default.
• Kick: Kick does not let apps list past broadcasts yet, so the dock asks you to paste the VOD link.

Install

• Installer (recommended): run clips-kitty-obs-plugin-<version>-windows-x64-Installer.exe from the latest release, then restart OBS.
• Zip: extract the clips-kitty-obs-plugin folder into C:\ProgramData\obs-studio\plugins\, then restart OBS.

Then open Docks > Clips Kitty in OBS.

First run

The dock welcomes you and opens its settings:

Setting	What it does
After a stream	Ask before creating clips (default), Create clips automatically, or Only when I click.
Confirmation delay	30 seconds, 60 seconds (default), 2 minutes or 5 minutes before a stopped stream counts as ended.
Platform	Detected from your OBS stream settings. Choose it here if OBS uses a custom server.
Channel name	Your Twitch or YouTube handle, used to find the VOD.
Processing profile	Standard, Podcast, Long clips or Stream highlights, as defined by Clips Kitty.

If OBS closes during or right after a stream, the dock always asks next time instead of starting on its own.

Privacy

• Local only. The plugin talks only to Clips Kitty on your own computer (127.0.0.1:8765).
• No uploads. It sends your stream's start and end times, platform, channel name and chosen profile.
• No recordings. It never records, reads or uploads video.
• Clips Kitty downloads the VOD from Twitch or YouTube, the same way it does when you paste a link into the app.

Troubleshooting

• No dock: check Docks > Clips Kitty, and that the plugin folder is in C:\ProgramData\obs-studio\plugins\. Help > Log Files shows [clips-kitty-obs-plugin] plugin loaded when it loads.
• "Clips Kitty isn't installed": install it from the Microsoft Store, then click Try Again.
• "Please update Clips Kitty": your Clips Kitty is older than the integrations API. Update it.
• "Waiting for your VOD" for a long time: check that past broadcasts are on and public, and that the channel name in Settings is right. After two hours the dock asks for the link instead.
• "Keep Clips Kitty open while it processes": closing Clips Kitty pauses the job. Open it again and processing resumes.

Building from source

CI builds every push on GitHub Actions: the plugin, a zip and an installer. Tag a version such as 0.1.0 to create a draft release.

Locally, you need Visual Studio 2022 and CMake 3.28 or newer:

cmake --preset windows-x64
cmake --build --preset windows-x64

The stream session state machine has its own tests, with no OBS or Qt needed:

cmake -S tests -B build_tests
cmake --build build_tests --config Release
ctest --test-dir build_tests -C Release --output-on-failure

Built on the Clips Kitty API

This plugin uses only the documented Clips Kitty local API. Anything that can make an HTTP request can do the same. See PROJECTS.md.

Notes

• Built from the official OBS plugin template.
• Written with the help of an AI coding assistant (Claude).
• Report problems in Issues.

License

GPL-2.0-or-later. See LICENSE.