OutroKit 1.7.0

There is a newer version of this package available.
See the version list below for details.
dotnet tool install --global OutroKit --version 1.7.0
                    
This package contains a .NET tool you can call from the shell/command line.
dotnet new tool-manifest
                    
if you are setting up this repo
dotnet tool install --local OutroKit --version 1.7.0
                    
This package contains a .NET tool you can call from the shell/command line.
#tool dotnet:?package=OutroKit&version=1.7.0
                    
nuke :add-package OutroKit --version 1.7.0
                    

๐Ÿ“ผ OutroKit

OutroKit writes the titles, descriptions, chapters, and SRT subtitles for your episode from its transcript, video, or audio, using AI powered by the GitHub Copilot SDK. It works for podcasts and videos alike.

OutroKit was called Podcast Metadata Generator, and its NuGet package is now OutroKit. The old PodcastMetadataGenerator package still works and tells you how to switch: run dnx OutroKit, or if you installed it as a tool, run dotnet tool uninstall -g PodcastMetadataGenerator and then dotnet tool install -g OutroKit. Your settings carry over.

.NET License GitHub Copilot

New here? The step-by-step install and usage guide at outrokit.com walks through everything, starting from opening a terminal.

OutroKit Banner

<img width="720" alt="The OutroKit main menu in a terminal, with Burn Captions into Video selected" src="https://raw.githubusercontent.com/jamesmontemagno/outrokit/main/docs/images/outrokit-menu.png" />

<img width="720" alt="Ten title suggestions generated by OutroKit, with a prompt to select one" src="https://raw.githubusercontent.com/jamesmontemagno/outrokit/main/docs/images/outrokit-titles.png" />

โœจ Features

  • ๐ŸŽฏ Title Generation - Get multiple creative title suggestions for your episode
  • ๐ŸŽจ Title Styles - Pick a style (balanced, descriptive, curiosity hook, question, how-to, playful, professional, SEO, or mixed) each time you generate titles
  • ๐Ÿ“ Description Generation - Create short, medium, and long descriptions optimized for different platforms, picking which lengths to generate each time
  • ๐Ÿ“‘ Chapter Generation - Auto-generate YouTube-compatible chapter markers with timestamps
  • ๐ŸŽฌ SRT Conversion - Convert transcripts to valid SRT subtitle format
  • ๐Ÿงน Auto Fix SRT - Check an .srt file for readability issues, apply safe fixes, and save a corrected copy without changing the original
  • ๐Ÿ”„ Multiple Transcript Formats - Support for Zencastr, time-range, SRT formats, and plain text
  • ๐ŸŽง Video & Audio Transcription - Start from a video or audio file (.mp3, .wav) and generate an SRT transcript locally with ffmpeg and Whisper.net
  • ๐Ÿ”ฅ Burn Captions into Video - Draw an .srt, .vtt, .ass, or .ssa captions file into the picture of a video with four appearance choices. For other caption formats, or captions that need more work first, use CaptionStack
  • ๐Ÿ“‚ File Browser - Built-in file browser or drag-and-drop support
  • โšก Streaming Responses - Watch AI responses generate in real-time
  • ๐Ÿ“‹ Copy to Clipboard - Copy titles, descriptions, chapters, or everything at once; finished output is printed unwrapped so it also selects cleanly in the terminal
  • ๐Ÿ’พ Choose what to save - Save selected titles, descriptions, chapters, SRT subtitles, and the manifest, or everything at once; the suggested output folder is next to the transcript unless you configured another folder in Settings
  • ๐Ÿค– Model Selection - Choose from multiple AI models (GPT-5, Claude, Gemini)
  • โš™๏ธ Configurable Settings - Customize generation parameters and save preferences
  • โœจ What's New - See full details for the latest release and compact, title-only updates for older releases from the main menu

๐Ÿ“‹ Prerequisites

  • .NET 10.0 SDK or later
  • A GitHub Copilot account and authentication, unless using BYOK. The free Copilot plan works
  • GitHub Copilot CLI installed (see below)
  • ffmpeg available on PATH, or its executable path configured in Settings (only needed to transcribe video or audio files and to burn captions into video)
    • Burning captions needs an ffmpeg built with libass, which provides the subtitles filter. Homebrew's standard ffmpeg formula leaves it out; brew install ffmpeg-full includes it

The app reaches Copilot through the Copilot CLI installed on your computer, on every system and whether you run the NuGet tool or build from source. It does not bundle a Copilot runtime, which keeps the package to about 11 MB. Make sure copilot is on your PATH, or set COPILOT_CLI_PATH to the executable. If the app cannot find it, it shows how to install it.

Installing GitHub Copilot CLI

macOS and Linux (Homebrew):

brew install copilot-cli

Windows (WinGet):

winget install GitHub.Copilot

All platforms (npm, requires Node.js 22+):

npm install -g @github/copilot

macOS and Linux (install script):

curl -fsSL https://gh.io/copilot-install | bash

Then authenticate:

copilot
# Type /login and follow the prompts

๐Ÿš€ Installation

dnx OutroKit

As a .NET Tool

dotnet tool install -g OutroKit

Then start it with outrokit.

From Source

git clone https://github.com/jamesmontemagno/outrokit.git
cd outrokit
dotnet build PodcastMetadataGenerator.sln

๐Ÿ“š Additional Docs

๐Ÿ“– Usage

Console App - Interactive Mode

# If installed as a tool:
outrokit

# Or from source:
cd src/Console
dotnet run

Console App - With a Transcript File

outrokit /path/to/transcript.txt

# Or from source:
dotnet run -- /path/to/transcript.txt

Console App - With a Video or Audio File

Open Settings โ†’ Transcription Settings, choose a Whisper GGML model, then download and initialize it. After setup, select Load Transcript, Video, or Audio โ†’ Video or audio file, or pass the file on the command line:

outrokit /path/to/episode.mp4
outrokit /path/to/episode.mp3

Supported video formats are .mp4, .mov, .mkv, .avi, .webm, .m4v, .wmv, .mpeg, and .mpg. Supported audio formats are .mp3 and .wav.

The app checks the file for an audio track with ffmpeg, asks where to save the .srt, transcribes the audio locally, and loads that SRT into the existing metadata flow. Model downloads and transcription can take a while; press Ctrl+C to cancel either one and return to the menu.

Models are downloaded from the Whisper.net Hugging Face repository into ~/.podcast-metadata-generator/models. Smaller models are faster and use less memory; larger models generally improve accuracy. English (.en) variants only transcribe English, while the other models are multilingual.

Console App - Auto Fix SRT

Select Auto Fix SRT from the main menu and choose an .srt file. OutroKit checks caption timing and readability, applies safe fixes, and suggests a <filename>-fixed.srt file next to the original. The original is never changed; issues that cannot be safely fixed are reported for manual review.

Console App - Save Results

Choose Save Results from the main menu to select the generated titles, individual descriptions, chapters, SRT subtitles, and manifest to save. Choose Everything to save all available results. The output folder defaults to the folder containing the loaded transcript; a custom Output Directory set under Settings takes precedence, and you can edit the folder for each save. If the generated SRT would overwrite the source transcript, OutroKit saves it as a separate *_subtitles.srt file.

Console App - Burn Captions into a Video

Select Burn Captions into Video from the main menu, then choose a video and a captions file (.srt, .vtt, .ass, or .ssa). No transcript needs to be loaded, and an SRT made by the app from the same video works as the captions file.

Before burning, the app checks caption timing and readability and reports invalid times, overlaps, empty cues, short durations, long lines, too many lines, and fast reading speeds. For SRT and WebVTT files, it can safely clean whitespace, remove empty cues, rewrap text, trim suitable overlaps, and extend captions into available time. Fixes are applied only to a temporary copy used for the burn; the original caption file is never changed. Remaining findings can be reviewed manually or left unchanged. The app then asks you to confirm the caption appearance, text size (Small, Medium, or Large), and position (Bottom or Top), then where to save the result. Choose Classic Outline, Contrast Panel, Bold Impact, or Clean Shadow; Classic Outline is the default. The default output is <video name>-captioned next to the original, and the original video is never overwritten. Captions are sized to the video, so they look the same at 720p and 4K and stay proportionate on portrait video. An .ass or .ssa file keeps its own fonts, sizes, and positions.

Burning captions re-encodes the picture as H.264, so it takes a while on long videos. The result is saved as .mp4, .mov, .mkv, or .m4v; a source in another format is saved as .mp4. Audio is copied unchanged when the format stays the same and converted to AAC otherwise. Press Ctrl+C to cancel and return to the menu; a cancelled or failed burn saves nothing and leaves an existing file as it was.

Captions in another format, such as YouTube's .sbv or .ttml? CaptionStack converts caption files for free in your browser, and is the place to go when captions need more work before you burn them in.

This feature needs an ffmpeg that includes libass. If yours does not, the app says so and offers to switch to another one. With Homebrew:

brew install ffmpeg-full
# It is installed beside the standard ffmpeg, not on PATH. Use this as the ffmpeg path:
echo "$(brew --prefix ffmpeg-full)/bin/ffmpeg"

๐ŸŒ Blazor Demo (Local Only)

A web UI demo is included for local development and presentations.

โš ๏ธ Local Use Only: The Blazor app uses your local Copilot authentication and is not designed for deployment or multi-user access.

Running the Blazor Demo

# From repository root
cd src/Blazor
dotnet run

Then open https://localhost:5001 in your browser.

Features

  • Drag-and-drop file upload
  • Real-time streaming AI output
  • Tabbed results view
  • Settings persistence via localStorage

Title Styles

Style What you get
Balanced Engaging, descriptive, and SEO-friendly
Descriptive Clear and straightforward, no hype
Curiosity Hook Teases a hook that makes people want to listen
Question Phrased as a question the episode answers
How-To / Educational Outcome-focused: how-to, guide, lessons learned
Playful Witty, with wordplay or humor
Professional Polished and authoritative
SEO Keywords Leads with the terms people search for
Mixed Variety A different style for each title

Set the default under Settings โ†’ Generation Settings โ†’ Title Settings (console) or on the Settings page (Blazor). The default is preselected whenever you generate titles, and you can choose a different style for that run.

Copying Results (Console)

When a generation finishes, the console offers a Copy to clipboard menu for the selected title, all titles, each description, chapters, or everything. The same menu is available from the main menu once you have results. On Linux, clipboard access requires xsel.

๐ŸŒ Website

The guide at outrokit.com lives in site/ as plain HTML, CSS, and JavaScript with no build step. Pushing changes under site/ to main deploys it through the Pages workflow.

To preview it locally:

cd site
python3 -m http.server 4173

Then open http://localhost:4173.

The site is served at outrokit.com through the custom domain in the repository's Pages settings.

The image shown when the link is shared is site/og.png. It is a 1200ร—630 screenshot of design/og-image.html, which uses the site's fonts and colors. To regenerate it after an edit, with Chrome or Edge:

"/Applications/Google Chrome.app/Contents/MacOS/Google Chrome" --headless --hide-scrollbars \
  --force-device-scale-factor=1 --window-size=1200,630 \
  --screenshot="$PWD/site/og.png" "file://$PWD/design/og-image.html"

The hype video that announces a release is made in the same style from design/hype-video/. Its README covers how to render it and how to update it for the next release.

The browser can keep running after the file is written; stop it with Ctrl+C.

๐ŸŽฏ Supported Transcript Formats

Zencastr Format

00:00.00 Speaker 1: Hello and welcome to the show.
00:15.50 Speaker 2: Thanks for having me!

Time-Range Format

00:00:00 - 00:00:15
Hello and welcome to the show.

00:00:15 - 00:00:30
Thanks for having me!

SRT Format

1
00:00:00,000 --> 00:00:15,000
Hello and welcome to the show.

2
00:00:15,000 --> 00:00:30,000
Thanks for having me!

Plain Text

Any text file without timestamps will be processed as plain text. Note: Chapter generation and SRT conversion require timestamps.

๐Ÿ“ Output Files

When you save results, the following files are generated:

File Description
titles.txt List of generated title suggestions
description-short.txt Short description (~50 words)
description-medium.txt Medium description (~150 words)
description-long.txt Long description (~300 words)
chapters.txt YouTube-compatible chapter markers
subtitles.srt SRT subtitle file
manifest.json JSON manifest with all metadata

โš™๏ธ Configuration

Access settings from the main menu to configure:

General Settings

  • AI Model - Select from available Copilot models (dynamically fetched from CLI)
  • ffmpeg Path - Executable path or command used to check video and audio files, extract 16 kHz mono audio, and burn captions into video
  • Whisper GGML Model - Select, download, and initialize a local Whisper.net model for transcription
  • Caption Appearance, Size, and Position - Default appearance (default: Classic Outline), text size (default: Medium), and position (default: Bottom) for captions burned into video. You are asked to confirm or change them each time you burn captions
  • Output Directory - Default location for saved files
  • Show Name - The name of your show (used in prompts for better context)
  • Host Names - Host names (used in prompts)
  • Episode Context - Add guest names, topics, or other context to improve generation

Generation Settings

  • Title Count - Number of title suggestions to generate (default: 5)
  • Title Max Words - Maximum words per title (default: 10)
  • Title Style - Default style for generated titles (default: Balanced). You are asked to confirm or change it each time you generate titles or all metadata
  • Description Lengths - Word counts for short/medium/long descriptions (default: 50/150/300)
  • Chapter Range - Min/max chapters to generate (default: 3-12)
  • Chapters per 30 min - Target density of chapters (default: 5)
  • Chapter Title Words - Max words per chapter title (default: 8)

Settings are automatically saved to ~/.podcast-metadata-generator/settings.json.

๐Ÿ—๏ธ Project Structure

outrokit/
โ”œโ”€โ”€ PodcastMetadataGenerator.sln     # Solution file
โ”œโ”€โ”€ src/
โ”‚   โ”œโ”€โ”€ Core/                        # Shared class library
โ”‚   โ”‚   โ”œโ”€โ”€ Models/
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ AppSettings.cs       # Configuration and generation settings
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ CaptionStyle.cs      # Caption size and position options
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ GenerationResult.cs  # Results container
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ Manifest.cs          # JSON manifest structure
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ TitleStyle.cs        # Title style options and prompt guidance
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ Transcript.cs        # Transcript model
โ”‚   โ”‚   โ”‚   โ””โ”€โ”€ TranscriptSegment.cs # Segment model
โ”‚   โ”‚   โ”œโ”€โ”€ Services/
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ CaptionBurnService.cs   # Burns captions into video with ffmpeg
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ CopilotAuthService.cs   # CLI authentication checks
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ FfmpegRunner.cs         # Shared ffmpeg process launcher
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ MetadataGenerator.cs    # AI generation via Copilot SDK
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ OutputService.cs        # File output handling
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ SettingsService.cs      # Settings persistence
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ SrtConverter.cs         # SRT format conversion
โ”‚   โ”‚   โ”‚   โ””โ”€โ”€ TranscriptParser.cs     # Multi-format transcript parsing
โ”‚   โ”‚   โ””โ”€โ”€ Prompts/
โ”‚   โ”‚       โ””โ”€โ”€ PromptTemplates.cs      # AI prompt templates
โ”‚   โ”œโ”€โ”€ Console/                     # Console application
โ”‚   โ”‚   โ”œโ”€โ”€ UI/
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ AppWorkflow.cs          # Main application workflow
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ ConsoleUI.cs            # Spectre.Console UI helpers
โ”‚   โ”‚   โ”‚   โ””โ”€โ”€ WhatsNew.cs             # Entries for the What's New screen
โ”‚   โ”‚   โ””โ”€โ”€ Program.cs                  # Console entry point
โ”‚   โ””โ”€โ”€ Blazor/                      # Blazor Server demo (local only)
โ”‚       โ”œโ”€โ”€ Components/
โ”‚       โ”‚   โ”œโ”€โ”€ Layout/                 # MainLayout, NavMenu
โ”‚       โ”‚   โ””โ”€โ”€ Pages/                  # Home, Generate, Settings
โ”‚       โ”œโ”€โ”€ wwwroot/
โ”‚       โ”‚   โ””โ”€โ”€ css/app.css
โ”‚       โ””โ”€โ”€ Program.cs                  # Blazor entry point
โ”œโ”€โ”€ tests/                           # xUnit tests, run on Linux, Windows, and macOS in CI
โ””โ”€โ”€ data/                            # Sample transcripts

๐Ÿค Contributing

Contributions are welcome! Please see CONTRIBUTING.md for guidelines.

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add some amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

๐Ÿ“„ License

This project is licensed under the MIT License - see the LICENSE file for details.

๐Ÿ™ Acknowledgments

Product Compatible and additional computed target framework versions.
.NET net10.0 is compatible.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

This package has no dependencies.

Version Downloads Last Updated
1.8.1 110 11/9/2026
1.8.0 102 11/7/2026
1.7.0 171 10/9/2026
1.6.0 147 10/8/2026
1.5.0 121 10/4/2026