List all playlists in the inventory database.

Run scan_inventory() first if the database is empty.

List all videos in a specific playlist.

Run a full inventory scan: list all playlists, all items, check video status.

This is the primary data-collection command. Run this first before any curation operations. Uses the YouTube Data API — consumes ~1,200 quota units for a typical 900-playlist account.

Generate a summary report from the inventory database.

Shows playlist/video counts, dead videos, duplicates, and empty playlists. Requires that scan_inventory() has been run first.

Find videos that appear in multiple playlists.

Args: min_appearances: Minimum number of playlists a video must appear in (default: 2, meaning any duplication at all).

Find deleted, private, or blocked videos across all playlists.

Find playlists with 0 videos.

Suggest playlist merge candidates based on title similarity.

Useful for consolidating fragmented playlists (e.g. "Tech 2020" + "Tech 2021").

Move all videos from the SOURCE playlist into the TARGET, then delete SOURCE.

Skips videos already present in the target. By default runs in dry_run mode — set dry_run=False to actually execute.

Args: source_id: Playlist ID to move videos from (e.g. PL...) target_id: Playlist ID to move videos into dry_run: If True (default), only preview; set False to execute

Delete a playlist and all its contents.

By default runs in dry_run mode — set dry_run=False to actually delete.

Args: playlist_id: The YouTube playlist ID to delete (e.g. PL...) dry_run: If True (default), only preview; set False to execute

Remove all dead/private/blocked videos from their playlists.

By default runs in dry_run mode — set dry_run=False to actually remove.

Args: dry_run: If True (default), only preview; set False to execute

Check whether OAuth credentials are configured and valid.