Automated Timestamping for YouTube Live Streams
Making highlights creation effortless for creators and viewers
📖 Read the full story on Medium - Learn about the journey behind Tsnip
Tsnip revolutionizes how you handle YouTube live streams by automatically timestamping key moments during your broadcast. After your stream ends, our intelligent bot comments all collected timestamps, making it incredibly valuable for:
- 📺 Offline Viewers - Easily navigate to the best moments
- ✂️ Content Editors - Quickly identify highlight-worthy segments
- 🎯 Content Creators - Boost engagement with organized content
- ✅ 100% Open Source - Full transparency
- ✅ No YouTube Login Required - Your channel stays secure
- ✅ Zero Cost - Free forever
- ✅ Privacy First - No data collection
You'll need Nightbot set up on your channel. If you haven't done this yet, follow this simple guide:
📹 How to Setup Nightbot
- Add the Command - Paste this in your YouTube live chat:
!addcom !ts $(urlfetch https://tsnip.vercel.app/api/clip?user=$(user)&chatId=$(chatid)&channelid=$(channelid)&msg=$(querystring)&delay=22)
-
Set User Permissions (Recommended) - To prevent spam, change the Required User-Level to Moderator in Nightbot settings.
-
Customize Delay - Adjust the
delay=22parameter based on your stream setup:
| Stream Type | Recommended Delay | Use Case |
|---|---|---|
| Low Latency | delay=22 |
Real-time interaction |
| Medium Latency | delay=42 |
Balanced performance |
| High Latency | delay=58 |
Stream sniper protection |
Once integrated, you and your viewers can create timestamps using these commands:
| Command | Description | Example |
|---|---|---|
!ts |
Creates timestamp with no title | Simple moment capture |
!ts Nice Flick Shot |
Creates timestamp with custom title | Titled as "Nice Flick Shot" |
💬 Confirmation: After a successful timestamp, you'll see a response from Nightbot confirming the action.
💡 Pro Tip: The delay compensates for the time difference between your live stream and when viewers see it in chat.
After your live stream ends, within 30 minutes our bot will automatically comment with all collected timestamps:
The bot organizes all timestamps chronologically, making navigation effortless for your audience.
Since our bot comments on multiple streams in a similar format, YouTube may flag it as spam and hide it by default. To find the comment, simply sort comments by "Newest first" on the stream — the bot's comment will be right there:
💡 Pro Tip for Creators: Add our bot as an approved user on your channel. Once the bot comments, pin that comment and engage with it (like/reply). A pinned comment is visible to all viewers instantly — no sorting needed!
Tsnip now supports sending timestamps directly to your Discord channel! When this feature is enabled, timestamp messages will be sent to your designated Discord channel like this:
⚠️ This feature is NOT enabled by default
To add Discord integration to your channel:
- Fill out the integration form: Discord Integration Request Form
- Wait for approval and integration setup
- Feature will be activated after review
Why approval is required:
- Custom setup needed for each Discord server
- Ensures proper permissions and security
- Prevents spam and unauthorized usage
- Maintains service quality and stability
Need help? Contact the developer on Discord: jd.208 for any queries or support.
 @kiwi_fps Professional Player |
 @Exion Variety Game Streamer |
 @lordbathura Entertainer |
 @BloodLineYT Full-time Content Creator |
 @RakaZoneGaming Variety streamer & 2x Indian Streamer of the Year |
 @SurvEcs FPS Streamer |
Join the growing community of streamers who trust Tsnip for their timestamping needs!
Tsnip is built with modern, reliable technologies:
| Component | Technology | Purpose |
|---|---|---|
| Language | Python 3.12+ | Core application logic |
| Framework | Flask | Lightweight web framework & API routes |
| Package Manager | uv | Fast dependency management (replaces pip) |
| YouTube API | YouTube Data API v3 + OAuth 2.0 | Stream detection, video status & comment posting |
| Discord | Discord Bot API | Real-time timestamp notifications to Discord channels |
| Database | Supabase | Timestamps, stream records & channel config storage |
| Logging | Loguru | Structured, production-grade logging |
| Linting | Ruff | Fast linting & code formatting |
| Deployment | Vercel (Serverless) | Zero-config Python serverless hosting |
Built for performance, scalability, and reliability.
This project uses Ruff for linting and formatting:
# Lint — check for errors and style issues
uv run ruff check .
# Lint + auto-fix — automatically fix fixable issues
uv run ruff check --fix .
# Format — apply consistent code formatting
uv run ruff format .Your support helps us:
- 🖥️ Cover Infrastructure Costs - Keep servers running smoothly
- 📈 Scale Reliably - Handle growing user base
- 🔧 Continuous Improvements - Add new features and fixes
 UPI Payment technoguys037493@okaxis
|
 Buy Me a Coffee ☕ Support Here |
 GitHub Sponsors 💖 Sponsor on GitHub |
Can't support monetarily? No worries! Here's how you can help:
- 📢 Share with fellow streamers
- 🗣️ Give shoutouts during your streams
- ⭐ Star this repository
- 💬 Spread the word on social media
Free publicity is just as valuable to us! ❤️
Got questions, suggestions, or need help? Reach out to us:
- 📧 Email: workbyjd@gmail.com
- 💬 Discord:
jd.208 - 💼 LinkedIn: jaypatel208
For any queries, issues, or suggestions, feel free to reach out through any of the above channels!
This project is licensed under the MIT License - see the LICENSE file for details.
If Tsnip helps your content creation journey, consider giving us a ⭐!
