Youtube Description Autoposter

💡 Examples

Mode 1 — YouTube URL

Fetches the transcript from the video, generates SEO timestamps, and optionally appends them to the description of that specific video.

# Generate only (view output)
python scripts/youtube_desc_generator.py --url "" ""
Generate and post to that video
python scripts/youtube_desc_generator.py --url "" "" --post

Mode 2 — Raw Transcript Text

Reads a raw transcript string, generates SEO timestamps, and optionally appends them to the description of your latest YouTube upload.

# Generate only (view output)
python scripts/youtube_desc_generator.py --transcript "0:00 Welcome..." ""
Generate and post to latest video
python scripts/youtube_desc_generator.py --transcript "0:00 Welcome..." "" --post

Mode 3 — Latest Video

Automatically fetches your most recent video, checks if timestamps already exist (to prevent duplicates), downloads the transcript, generates SEO timestamps, and optionally appends them to the description.

# Generate and post timestamps for your latest video (if they don't already exist)
python scripts/youtube_desc_generator.py --latest "" --post

Examples:

python scripts/youtube_desc_generator.py --url "https://youtu.be/abc123" "$GEMINI_API_KEY"
python scripts/youtube_desc_generator.py --url "https://youtu.be/abc123" "$GEMINI_API_KEY" --post
python scripts/youtube_desc_generator.py --transcript "0:00 Welcome..." "$GEMINI_API_KEY" --post

📋 Tips & Best Practices

No transcript available (URL mode):

The video may have transcripts disabled or no English captions

Switch to --transcript mode with a manually prepared transcript string

Transcript text not loading (transcript mode):

Ensure the text format is correct

Each line should follow MM:SS text format

Gemini API errors:

Verify your API key is valid and has access to gemini-3.1-flash-lite-preview

Check your quota at Google AI Studio

--post not updating the video:

Ensure credentials.json is in the scripts/ directory

Delete token.pickle and re-authenticate if credentials have expired

Confirm the YouTube Data API v3 is enabled in your Google Cloud project

Wrong video appended to in transcript mode:

Transcript mode always targets your most recent upload — make sure the correct video is your latest

If you need to target a specific video, use --url mode instead