Changelog

Other

• 8432603: Add discover, a breadth-first walk of the YouTube graph (#9) (@tamnd)

Changelog

Other

• dbfb4dc: Add list format, modern README, and demo GIF for v0.3.2 (#8) (@tamnd)

Changelog

Other

• 833b4d6: Add release notes page and document markdown and color output (#6) (@tamnd)
• c928dc9: Note v0.3.1 in the release notes (#7) (@tamnd)

Changelog

Other

• ea54c02: Bump any-cli to v0.3.2 for the lipgloss output formats (#5) (@tamnd)

ytb v0.2.0

A full rewrite of ytb onto the any-cli/kit framework.

What changed

• Kit-native command tree. The binary now runs through kit.Run. Every
  record operation is declared once with kit struct tags instead of hand-rolled
  cobra commands and row builders, so the JSON/Markdown/table renderings come
  straight from the data shape.
• Doubles as an ant driver. youtube/domain.go is both the binary's
  source of truth and the YouTube domain driver for
  ant: a blank import makes
  youtube://video/... and youtube://channel/... addressable across the
  whole tamnd/*-cli namespace.
• Same surface. All existing commands keep working — search, video,
  channel, playlist, comments, transcript, download, music, db, crawl, export,
  config — now sharing kit's output formats, store, and global flags.

Install

go install github.com/tamnd/ytb-cli/cmd/[email protected]

Or grab a prebuilt binary below, or docker run --rm ghcr.io/tamnd/ytb:0.2.0 --help.

This is a bug-fix release. A sweep of every subcommand against live pages turned up a handful of fields that came back blank or wrong on YouTube's current layout. Each one was data that had moved to a new place in the page, and each is now read from where it lives today.

Fixes

• channel --videos showed the channel name in the views column. The continuation feed sends a bare 101K with no "views" word, which the parser mistook for a name. It now reads the view count and the upload time correctly.
• channel printed blank subscriber and video counts. Those numbers moved into the page header, so the old lookup found nothing. 4.51M subscribers and 422 videos are back.
• playlist listed no videos and reported a count of zero. Modern playlist pages render their items in a new shape and keep the owner and count in the header. Playlists list their videos again, with a count and a channel.
• video printed a blank duration. The watch page dropped the field ytb was reading, so the duration is now derived from the length in seconds.
• channel --shorts returned nothing at all. The Shorts tab uses its own item format, which is now parsed for the id, title, and view count.
• formats ignored -n. It now stops at the row limit you ask for.

Install

Homebrew:

brew install tamnd/tap/ytb

Go:

go install github.com/tamnd/ytb-cli/cmd/[email protected]

Docker:

docker run --rm ghcr.io/tamnd/ytb video dQw4w9WgXcQ -o json

Or grab a prebuilt archive (Linux, macOS, Windows on amd64 and arm64) or a Linux package (deb, rpm, apk) from the assets below. Each release ships checksums.txt signed with keyless cosign, plus SBOMs.

Documentation

Full docs, guides, and the CLI reference live at https://ytb-cli.tamnd.com.

ytb is a fast, friendly command line for YouTube. It talks to the same public InnerTube endpoints the site itself uses, so there is no API key to register, no quota to budget, and nothing to pay for. One pure-Go binary, no runtime dependencies.

This is the first release.

Highlights

• Resolve videos. Full metadata for any video: title, channel, views, likes, publish date, duration, chapters, caption tracks, streaming formats, and the related-video graph.
• Walk channels and playlists. Stream a channel's uploads, shorts, live streams, and playlists, or page any playlist's items, following continuation tokens automatically.
• Search like the site does. The full filter grid: type, upload date, duration, sort order, and feature flags (HD, 4K, HDR, subtitles, live, 360, VR180, Creative Commons).
• Read the social layer. Comments and replies, community posts, hashtag feeds, and search autocomplete.
• Download video and audio. A built-in pure-Go engine fetches streams with no API key and no external downloader. It leads with the token-free ANDROID_VR client, deciphers the URL signature and the n throttling parameter with an embedded JavaScript interpreter, and pulls media down in parallel byte ranges. A yt-dlp-style -f selector, playlists, subtitles, output templates, download archives, and SponsorBlock are all built in.
• Browse YouTube Music. Search artists, albums, and songs, and open an artist, album, playlist, or song through the Music endpoints.
• Keep what you fetch. Point any command at a local SQLite store (pure-Go, no cgo) and it becomes a crawler, with a work queue, read-only SQL access, full-text search, and a Markdown exporter.

Optional tools

The binary is pure Go and never links anything. ffmpeg is used only to merge a separate video track with its audio, convert audio, and embed cover art; without it, single-stream downloads still work and the rest report a clear error (exit 6). yt-dlp is optional too, used only for download --use-yt-dlp, extract, and recovering caption text when YouTube gates the endpoint.

Install

Homebrew:

brew install tamnd/tap/ytb

Go:

go install github.com/tamnd/ytb-cli/cmd/[email protected]

Docker:

docker run --rm ghcr.io/tamnd/ytb video dQw4w9WgXcQ -o json

Or download a prebuilt archive (Linux, macOS, Windows on amd64 and arm64) or a Linux package (deb, rpm, apk) from the assets below. Each release ships checksums.txt signed with keyless cosign, plus SBOMs.

Verify

cosign verify-blob \
  --certificate checksums.txt.pem \
  --signature checksums.txt.sig \
  --certificate-identity-regexp 'https://github.com/tamnd/ytb-cli' \
  --certificate-oidc-issuer 'https://token.actions.githubusercontent.com' \
  checksums.txt

Documentation

Full docs, guides, and the CLI reference live at https://ytb-cli.tamnd.com.

Media download is your responsibility: respect YouTube's Terms of Service and copyright.