# YouTube Auto Title Updater — Claude Setup Guide

Drop this file into a Claude conversation and say:
> **"Help me set up the YouTube Auto Title Updater using this guide."**

Claude will walk you through every step, write the code, and set it up on your machine.

---

## What This Builds

A script that automatically updates your YouTube video title every 10 minutes with live stats:

> **"This Video Has 8,432 Views, 1,204 Likes & 347 Comments"**

Runs silently in the background on your Windows PC. No coding experience needed.

---

## Before You Start — Tell Claude This

Copy and paste this into your Claude conversation:

```
I want to build the YouTube Auto Title Updater. Here is my setup:

- My Video URL: [PASTE YOUR YOUTUBE VIDEO URL HERE]
- My YouTube channel is a: [Personal Account / Brand Account]
- My Windows username: [run "whoami" in terminal and paste the result]
- My Python path: [run "where python" in terminal and paste the result]

Please set everything up for me step by step.
```

---

## What Claude Will Do For You

1. **Write the script** — `update_title.py` tailored to your video
2. **Create the batch file** — `run_update.bat` for Task Scheduler
3. **Walk you through Google Cloud Console** — getting your `client_secrets.json`
4. **Handle authentication** — including Brand Account setup
5. **Schedule the task** — runs every 10 minutes automatically
6. **Test it live** — confirms the title updated on YouTube

---

## Files Claude Will Create

| File | Purpose |
|---|---|
| `update_title.py` | Main script — fetches stats and updates title |
| `run_update.bat` | Wrapper that Task Scheduler calls |
| `setup_tasks.ps1` | Registers the scheduled task |
| `client_secrets.json` | You download this from Google Cloud Console |
| `youtube_token.pickle` | Auto-created after first login — never share this |
| `update_log.txt` | Auto-created — shows every update that runs |

---

## Google Cloud Console Setup (Claude will guide you through this)

You'll need to:
1. Create a free project at [console.cloud.google.com](https://console.cloud.google.com)
2. Enable the YouTube Data API v3
3. Create an OAuth 2.0 Desktop App credential
4. Download the JSON file and rename it `client_secrets.json`
5. Add your email as a test user under Audience settings

Claude will tell you exactly where to click at each step.

---

## API Quota — How Many Updates Per Day

YouTube gives you **10,000 free units/day**. Each update costs 51 units.

| Schedule | Updates/day | Units used | Status |
|---|---|---|---|
| Every 10 min | 144 | 7,344 | ✅ Recommended |
| Every 15 min | 96 | 4,896 | ✅ Conservative |
| Every 30 min | 48 | 2,448 | ✅ Safe |
| Every 5 min | 288 | 14,688 | ❌ Over quota |

---

## Title Template Options

Tell Claude which style you want, or make up your own:

| Template | Example Output |
|---|---|
| `"This Video Has {views} Views, {likes} & {comments}"` | This Video Has 8,432 Views, 1,204 Likes & 347 Comments |
| `"{views} people watched this. {likes} liked it."` | 8,432 people watched this. 1,204 liked it. |
| `"👁 {views} · ❤️ {likes} · 💬 {comments}"` | 👁 8,432 · ❤️ 1,204 · 💬 347 |

---

## Troubleshooting — Tell Claude If You See These

| Error | What to say to Claude |
|---|---|
| `Access blocked: Testing has not completed verification` | "I got the access blocked error" |
| `403 Forbidden` | "I got a 403 error — my channel is a Brand Account" |
| `ModuleNotFoundError: No module named 'googleapiclient'` | "I got a module not found error" |
| Task Scheduler runs but title doesn't update | "The task runs but the title isn't changing" |

---

## Requirements

- Windows 10 or 11
- Python 3.8+ installed ([python.org](https://python.org))
- A YouTube channel (personal or brand account)
- The Google account that owns the channel
- PC connected to the internet when updates run

---

## What's Possible Next

Once this is running, ask Claude to help you add:

- **Comment wall** — a live website showing all your comments as emoji bubbles
- **AI vote tracker** — detects which AI people mention in comments and shows a live leaderboard
- **Milestone alerts** — get notified when you hit 1K, 10K, 100K views
- **Multi-video support** — update titles across multiple videos at once

---

*Created by Chad Sheppard · Built entirely with AI · YouTube Data API v3*