Skip to content

SurajBhari/clip_finder

Repository files navigation

Clip Finder

Python Flask YouTube

A self-hosted Flask web app that searches a YouTube livestream's chat for a word or phrase and tells you exactly when it was said — then links you straight to that moment in the VOD.

Great for finding the funny/notable moments after a stream: search for a reaction word (a name, an emote, "clip it", etc.) and jump to every timestamp where it appeared in chat.

Notes & limitations

  • Only works on livestreams (or stream VODs) whose chat YouTube has finished rendering. It won't process regular uploads or streams that aren't fully processed yet.
  • Super Chat amounts are normalised across currencies (via CurrencyConverter) so you can also surface big-money moments.
  • No longer hosted publicly — but it's easy to self-host (below).

Run locally

pip install -r requirements.txt
python main.py

Open the local site, paste a stream URL and your search term, and submit.

Using cookies (member-only / restricted chats)

To search the chat of a members-only or otherwise restricted stream, provide your YouTube cookies:

  1. Install the Get cookies.txt LOCALLY extension.
  2. Open YouTube on an account that can see the chat.
  3. Click the extension and press Copy.
  4. Paste the cookies into the text box on the app and submit.

How it works

Chat is pulled with chat_downloader, each message's timestamp is recorded, and matches are returned with deep links into the video at the right second.

About

Self-hosted web app to find when a word was said in a YouTube livestream chat.

Topics

Resources

Stars

Watchers

Forks

Contributors

Languages