Skip to content

README.md

Latest commit

 

History

History
37 lines (24 loc) · 1.86 KB

README.md

File metadata and controls

37 lines (24 loc) · 1.86 KB

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.