ytstudio-cli 0.4.1

Manage and analyze your YouTube channel from the terminal. Designed for humans and AI agents.

YT Studio CLI

Manage and analyze your YouTube channel from the terminal. Designed for humans and AI agents.

[!NOTE] This is not an official Google product, see disclaimer.

Motivation

I built this because I needed to bulk update video titles for a YouTube channel I manage with 300+ videos. YouTube Studio does not support bulk search-replace operations, which made it a tedious manual process. This tool uses the YouTube Data API to perform bulk operations on video metadata. Furthermore, it provides features for analytics and comment moderation, all accessible from the command line.

Features

• Bulk update video metadata across hundreds of videos in one pass (search-replace titles, descriptions, tags).
• Upload videos from a directory using YAML sidecars for metadata and thumbnails.
• Schedule, start, stop, and update YouTube livestream broadcasts, including RTMP ingest details.
• Multi-channel profiles: manage several channels from one machine and switch per command.
• Comments moderation: list, reply, approve, reject, and ban from the CLI.
• Channel analytics queries via the YouTube Analytics API.
• Playlists: bulk-add by search and reorder by views with one command.

Documentation

See the full documentation for installation, OAuth setup, and the command reference.

Agent skill

This repo includes a harness-agnostic agent skill that teaches any skill-aware AI agent to operate a channel through this CLI, following the open SKILL standard.

Development

Clone the repo, sync dev dependencies, and install the pre-commit hook so ruff check and ruff format run on every commit (same checks CI runs):

uv sync --group dev
uv run pre-commit install

Run the suite manually with uv run pytest and uv run pre-commit run --all-files.

To preview the docs site locally, install the docs group and serve with mkdocs:

uv sync --group docs
uv run mkdocs serve  # or: uv run mkdocs build

API quota

The YouTube Data API enforces a default quota of 10_000 units per project per day. Most read operations (listing videos, comments, channel info) cost 1 unit, while write operations like updating video metadata or moderating comments cost 50 units each. Bulk updates can consume quota quickly. When exceeded, the API returns a 403 error; quota resets at midnight Pacific Time.

Action	Examples	Approx. cost
Read	list videos, comments, playlists; analytics queries	1 unit
Write	update a video, moderate a comment, add or reorder playlist items, schedule a broadcast	50 units
Search	search.list, used by playlists add --from-search	100 units
Upload	videos.insert	~1600 units

A full per-operation breakdown lives in the API quota docs.

You can request a quota increase via IAM & Admin → Quotas in the Google Cloud Console. See the official quota documentation for full details.

Disclaimer

This is not an officially supported Google or YouTube product. YouTube and YouTube Studio are trademarks of Google. All channel data is accessed exclusively through the official YouTube Data API and YouTube Analytics API.