Youtube.Console 1.0.0

.NET 10.0 This package targets .NET 10.0. The package is compatible with this framework or higher. 
dotnet tool install --global Youtube.Console --version 1.0.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 Youtube.Console --version 1.0.0
This package contains a .NET tool you can call from the shell/command line. 
#tool dotnet:?package=Youtube.Console&version=1.0.0
                    


                    

                
nuke :add-package Youtube.Console --version 1.0.0

Youtube.Console

CLI for scraping YouTube videos, channels, playlists, and search results via Apify. YAML-first output optimized for LLM agent consumption.

Installation

dotnet tool install -g Youtube.Console

Prerequisites

Set your Apify API token:

export APIFY_TOKEN=your-token-here

Or pass it per-command with --api-key.

Usage

# Search for videos
youtube search "dotnet 10 new features"

# Limit results
youtube search "typescript tutorial" --max-results 5

# Include Shorts and streams
youtube search "cooking" --max-results 5 --max-shorts 3 --max-streams 2

# Sort and filter
youtube search "rust programming" --sort date --date month --length between420

# HD only
youtube search "4k nature" --hd --4k

# With subtitles download
youtube search "conference talk" --max-results 3 --download-subs --subs-lang en

# Only recent videos
youtube search "breaking news" --since "1 day"

Scrape

# Scrape a single video
youtube scrape "https://www.youtube.com/watch?v=dQw4w9WgXcQ"

# Scrape a channel (latest 10 videos)
youtube scrape "https://www.youtube.com/@Fireship" --max-results 10

# Scrape a playlist
youtube scrape "https://www.youtube.com/playlist?list=PLObrtcm1Kw6PmbXg8bmfJN-o2Hgx8sidf"

# Channel sorted by popularity
youtube scrape "https://www.youtube.com/@Fireship" --sort POPULAR --max-results 5

# With subtitles
youtube scrape "https://www.youtube.com/watch?v=dQw4w9WgXcQ" --download-subs

# Only videos from last week
youtube scrape "https://www.youtube.com/@Fireship" --since "7 days"

Common options

--api-key <KEY>        Apify token (or set APIFY_TOKEN env var)
--max-results <N>      Maximum regular videos (default: 10)
--max-shorts <N>       Maximum Shorts (default: 0)
--max-streams <N>      Maximum streams (default: 0)
--download-subs        Download subtitles
--subs-lang <LANG>     Subtitle language (default: en)
--subs-format <FMT>    Subtitle format: srt, vtt, xml, plaintext (default: srt)
--auto-subs            Prefer auto-generated subtitles
--since <DATE>         Only videos after this date (e.g. 2025-01-01 or '7 days')

License

MIT

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.0.0 91 4/30/2026