Skip to content

michaelruck/yt-transcript-distiller

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

23 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

YouTube Transcript Distiller

A Firefox add-on that reads YouTube videos so you don't have to.

You open a video. Twelve minutes. You watch. You wait. The one insight you came for arrives at minute nine — buried under filler, recaps, and sponsor breaks.

YouTube Transcript Distiller fetches the full transcript and the video description, sends both to Google Gemini AI, and posts a clean summary directly into the YouTube comment field. One click. The important points, right where other viewers can see them.


Features

  • AI-powered summarization via Google Gemini (free API key required)
  • Transcript plus video description — the summary draws on both, so context from the description flows in
  • Silent transcript fetch — reads the caption track straight from the player, no panel opens, no scrolling
  • Posts directly into the YouTube comment field — formatted and ready to publish
  • Fully customizable prompt — change the instruction to anything you want
  • Configurable Gemini model — pick Flash-Lite (default), Flash, or Pro from a dropdown, or enter any model ID manually
  • 11 languages supported: Arabic, Chinese, English, French, German, Hindi, Japanese, Korean, Portuguese, Russian, Spanish
  • UI adapts to your browser language automatically
  • Quota countdown — if you hit the Gemini rate limit, the button shows a live countdown
  • Privacy first — your API key stays in your browser, anonymous usage stats can be disabled in settings

Installation

Firefox Add-On Store

The add-on can be installed from addons.mozilla.org.

Manual installation (Firefox Developer Edition / Nightly)

  1. Download the latest yt-transcript-distiller.xpi from Releases
  2. In Firefox: about:config → set xpinstall.signatures.required to false
  3. about:addons → gear icon → Install Add-on from File → select the .xpi

Setup

  1. Get a free Gemini API key at aistudio.google.com/app/apikey
  2. Open any YouTube video
  3. Click the gear icon next to the Transcript Distiller button
  4. Enter your API key and save
  5. Click Transcript Distiller — the AI summary appears in the comment field

How it works

YouTube Video
     │
     ▼
Transcript + description fetch
(player caption track → YouTube Internal API → DOM fallback)
     │
     ▼
Google Gemini API (your API key, your quota)
     │
     ▼
Formatted summary → YouTube comment field

The add-on never stores or transmits your transcript data anywhere other than directly to the Gemini API. The API key is stored locally in your browser via chrome.storage.sync.


Privacy

  • API key: stored locally, sent only to generativelanguage.googleapis.com
  • Usage statistics: sent only on button click: add-on name, action and language settings. No personal data.

Permissions

Permission Reason
storage Saves API key, prompt and language preference locally
clipboardWrite / clipboardRead Required for text injection into YouTube's comment field
youtube.com/* Content script runs on YouTube pages only
generativelanguage.googleapis.com/* Gemini API calls
marsgasse.com/* Anonymous usage counter

Customization

The prompt sent to Gemini is fully editable. Click the gear icon → edit the Prompt field. The default prompt instructs Gemini to produce a structured YouTube comment with bullet points, bold keywords, and blank lines between items — no raw Markdown, no HTML.

Click ↺ Reset to restore the default prompt at any time.

Gemini model

The Gemini Model dropdown (add-on settings page in about:addons) offers three alias IDs that Google keeps pointing at the newest release of each line:

  • gemini-flash-lite-latest — the default; fast, and its free-tier quota holds up in daily use
  • gemini-flash-latest — stronger, but the free tier allows few requests per day
  • gemini-pro-latest — effectively requires a paid plan

Custom model ID… accepts any model ID that supports generateContent from the Gemini model list. If a model answers with 404 (retired), 429 (daily quota used up), or 503 (overloaded), the error message says so — switching the model in the settings is the fix.


Requirements

  • Firefox 140+ (Desktop) / Firefox for Android 142+
  • A free Google Gemini API key
  • A YouTube video with subtitles/transcript available
  • A Google account (required to post comments)

Built at

marsgasse.com — Just another Basement Lab
Michael Ruck · michael.ruck@marsgasse.com


License

MIT

About

Firefox add-on that fetches YouTube transcripts and summarizes them with Google Gemini AI, posting the result directly into the comment field.

Resources

License

Stars

1 star

Watchers

0 watching

Forks

Packages

 
 
 

Contributors