Clip Search Bot Commands

Clip Reel System

An automated clip playback system for Twitch streamers. Perfect for BRB screens, pre-stream entertainment, or showcasing your best moments.

Features

Smart Weighted Selection

The system uses an intelligent weighting algorithm to keep clips fresh and varied:

Age-based weighting: Newer clips are prioritized to keep content fresh. Recent clips (last 30 days) get 50% weight, mid-age clips (30-180 days) get 30%, and older classics get 20%.
Category rotation: Automatically cycles through different game categories to provide variety.
No duplicates: Tracks recently played clips to avoid showing the same clip twice in a short period.
View count consideration: Popular clips with higher view counts get a slight boost.

Full Mod Control

Mods have complete control over the clip experience:

!cplay # - Instantly play any specific clip by number
!cskip - Skip the current clip immediately
!cprev - Go back to the previously played clip
!ccat game - Filter to only show clips from a specific game
!cremove / !cadd - Remove or restore clips from the rotation
!ctop - Display the top-voted clips on screen
!cvote - Clear votes for a clip
!chud - Move the HUD overlay to any corner

Chat Voting System

Viewers can interact with clips through voting:

!like / !dislike - Vote on the current clip or any clip by number
!cclip - See info about the currently playing clip
!cfind - Search clips by title, clipper, or game

Voting can be enabled/disabled per-channel by admins.

Clip Browser

A searchable web interface to browse all clips. Filter by title, clipper, game category, or clip number. See vote counts and click any clip to watch on Twitch.

Multi-Channel Support

Each channel has its own independent clip pool and settings:

Commands typed in a channel affect only that channel's clips
Each channel has its own HUD position settings
Admins can use !cswitch to control another channel's clips
Separate vote tracking per channel

Moveable HUD Overlays

Both the clip info HUD and top clips overlay can be positioned in any corner of the screen using !chud and !chud top commands. Settings persist per-channel.

How It Works

Add the clip player as a Browser Source in OBS. The player automatically fetches clips from your Twitch channel, converts them to MP4 for smooth playback, and cycles through them using the weighted selection algorithm.

The bot joins your Twitch chat to handle commands. Clip data is stored in a database with permanent clip numbers (seq) that never change, even if clips are added or removed. This means clip #42 will always be the same clip.

New clips can be fetched at any time through the admin panel without affecting existing clip numbers or disrupting playback.

Getting Started

Want to use this for your channel? The system supports multiple streamers. Reach out to get set up with your own clip reel.