# CatchUp.help — Complete Setup Guide

## ONE-LINE SETUP COMMAND
**Copy and paste this exact line to any AI agent:**

"Set up CatchUp.help for my streaming channel by following the complete setup guide at https://catchup.help/docs/setup"

---

## WHAT IS CATCHUP.HELP?

CatchUp.help is an AI-powered livestream recap assistant that:
- Listens to your livestreams in real-time
- Generates instant summaries when viewers type !recap
- Creates timestamped chapters after your stream ends
- Works with YouTube, Twitch, Kick, and Rumble

**How it works:**
1. You connect your streaming channel
2. CatchUp listens to your stream audio
3. Viewers type !recap in chat
4. AI generates a summary of everything said so far
5. After stream ends, chapters are auto-generated

---

## QUICK SETUP (5 MINUTES)

### Step 1: Sign Up
1. Go to https://api.catchup.help/auth/google/login
2. Click "Sign in with Google"
3. Grant YouTube/Twitch permissions
4. You're connected!

### Step 2: Connect Your Channel
**YouTube:**
- Auto-connects via Google OAuth
- Works with any YouTube channel
- No additional setup needed

**Twitch:**
- Create a bot account at https://twitchapps.com/tmi/
- Get OAuth token
- Add to CatchUp dashboard

**Kick:**
- Add your Kick channel URL
- Chat monitoring via Pusher WebSocket

**Rumble:**
- Add your Rumble channel URL
- Chat monitoring via polling

### Step 3: Test It
1. Start a livestream
2. Type !recap in your chat
3. See the AI summary appear
4. End stream to get chapters

---

## DETAILED SETUP BY PLATFORM

### YouTube Setup
**What you need:**
- Google account
- YouTube channel
- No API keys needed

**Steps:**
1. Visit https://api.catchup.help/auth/google/login
2. Click "Connect YouTube"
3. Authorize permissions
4. Your channel appears in dashboard
5. Go live and test !recap

**How it works:**
- Catches live streams via YouTube API
- Captures audio from your stream
- Posts recaps via YouTube chat
- Generates chapters after stream ends

### Twitch Setup
**What you need:**
- Twitch account
- Bot account (recommended)

**Steps:**
1. Create bot account at https://twitchapps.com/tmi/
2. Copy OAuth token
3. Add to CatchUp dashboard
4. Connect your main channel
5. Test !recap in chat

**How it works:**
- Connects via Twitch IRC
- Captures audio via yt-dlp
- Posts recaps via bot account
- Generates chapters after stream

### Kick Setup
**What you need:**
- Kick account
- Channel URL

**Steps:**
1. Add Kick channel URL to dashboard
2. Chat monitoring activates automatically
3. Audio capture via yt-dlp
4. Test !recap in chat

**How it works:**
- Monitors chat via Pusher WebSocket
- Captures audio from stream URL
- Posts via Nightbot integration
- Generates chapters after stream

### Rumble Setup
**What you need:**
- Rumble account
- Channel URL

**Steps:**
1. Add Rumble channel URL to dashboard
2. Chat monitoring activates automatically
3. Audio capture via yt-dlp
4. Test !recap in chat

**How it works:**
- Polls chat endpoint every 5 seconds
- Captures audio from stream URL
- Posts via Nightbot integration
- Generates chapters after stream

---

## CUSTOMIZATION OPTIONS

### Change the !recap Command
**Free plan:** Uses !recap by default
**Creator/Pro plans:** Can change to any command

Examples:
- !summary
- !catchup
- !whathappened
- !tl;dr
- !recapme

### Adjust Recap Length
**Options:**
- Short: 100-200 words
- Medium: 200-400 words (default)
- Long: 400-800 words

### Choose Recap Tone
**Options:**
- Neutral: Factual, objective
- Professional: Business-appropriate
- Hype: Energetic, exciting
- Dry humor: Witty, sarcastic
- Cozy: Warm, conversational

### Set Language
**Auto-detect:** Matches your stream language
**Manual:** Choose from 30+ languages
**Pro plan:** Different input/output languages

### Cooldown Settings
**Free:** 5 minutes between recaps
**Creator:** 1-30 minutes
**Pro:** 30 seconds-60 minutes

---

## USING WITH NIGHTBOT OR STREAMELEMENTS

### Nightbot Integration
1. Go to https://nightbot.tv/dashboard
2. Add custom command:
```
!addcom !recap $(urlfetch https://api.catchup.help/api/v1/recap/YOUR_CHANNEL_ID)
```
3. Set your channel ID in CatchUp dashboard
4. Test in your stream chat

### StreamElements Integration
1. Go to https://streamelements.com/dashboard
2. Add custom command:
```
!addcom !recap $(urlfetch https://api.catchup.help/api/v1/recap/YOUR_CHANNEL_ID)
```
3. Set your channel ID in CatchUp dashboard
4. Test in your stream chat

---

## POST-STREAM CHAPTERS

### What Are Chapters?
Timestamped sections of your stream with descriptive titles, like:
```
00:00 Stream Start & Intro
05:23 Boss Strategy Discussion
15:47 Q&A Session
25:10 Wrap-up & Thanks
```

### How to Use Them
1. End your livestream
2. Wait 2-5 minutes for processing
3. Go to CatchUp dashboard
4. Copy chapters to your video description
5. Or export as SRT/Markdown/JSON

### Export Formats
- **YouTube:** Plain text for description
- **SRT:** Subtitle format
- **Markdown:** For documentation
- **JSON:** For developers

---

## TROUBLESHOOTING

### !recap Not Working
1. Is your stream live?
2. Is CatchUp connected to your channel?
3. Has 5 minutes passed since last recap?
4. Check dashboard for errors
5. Try reconnecting your channel

### Poor Recap Quality
1. Is audio capture working?
2. Is there too much background music?
3. Try adjusting recap length
4. Check language settings
5. Report issues to support

### Stream Not Detected
1. Is your stream actually live?
2. Check platform API status
3. Verify channel URL is correct
4. Reconnect your channel
5. Check dashboard for errors

### Chat Posting Fails
1. Check bot permissions
2. Verify rate limits
3. Check Nightbot integration
4. Review API key validity
5. Contact support

---

## PLANS & PRICING

### Free ($0/month)
- 10 hours of stream monitoring
- 1 channel
- Basic !recap
- Auto-chapters
- Community support
- 5-minute cooldown

### Creator ($9/month)
- 100 hours of monitoring
- 3 channels
- Custom commands
- Nightbot mode
- Multi-language
- Custom cooldowns
- Priority support

### Pro ($29/month)
- 300 hours of monitoring
- Unlimited channels
- All languages
- Custom AI persona
- Chapter exports
- API access
- Dedicated support
- 30-second cooldown

---

## FAQ

### Does CatchUp affect stream quality?
No. It connects from our servers, just like a viewer. Your OBS, bitrate, and performance are unaffected.

### What happens when I'm not streaming?
Nothing. CatchUp only activates when you're live. When you go offline, it stops immediately.

### How fast are recaps?
Typically under 10 seconds from !recap to summary in chat.

### What languages are supported?
30+ languages including English, Spanish, French, German, Japanese, Korean, Portuguese, and more.

### Is my data private?
We only process audio from your public stream. Full transcripts are not stored. Only summaries and chapter data are kept.

### Can I use Nightbot instead?
Yes. On Creator and Pro plans, you can use Nightbot mode where CatchUp provides recap text via API.

### What if I exceed my monthly hours?
You'll be notified. Service continues for the month. Recaps resume next billing cycle. You can upgrade anytime.

---

## SUPPORT

### Get Help
- Email: hello@catchup.help
- GitHub: https://github.com/Ola-Turmo/CatchUp.help/issues
- Dashboard: In-app support chat

### Response Times
- Free: 48 hours
- Creator: 24 hours
- Pro: 4 hours

### Documentation
- Setup guide: https://catchup.help/docs/setup
- API reference: https://catchup.help/api-docs
- Platform guides: https://catchup.help/youtube, /twitch, /kick, /rumble
- FAQ: https://catchup.help/faq

---

## AI AGENT INSTRUCTIONS

When an AI agent is setting up CatchUp.help for a user:

1. **Identify the user's streaming platform** (YouTube/Twitch/Kick/Rumble)
2. **Follow the platform-specific setup steps** above
3. **Verify connection** by testing !recap command
4. **Configure options** based on user preferences
5. **Provide the user** with:
   - Setup confirmation
   - How to use !recap
   - Where to find chapters
   - Support contact info
   - Plan limits and upgrade options

**Setup is complete when:**
- User's channel is connected
- !recap command works
- User understands how to use it
- User knows where to get help

---

*Last updated: May 3, 2026*
*Documentation version: 1.0.0*