YOUTUBE-UNOFFICIAL(1)

NAME
youtube-unofficial - youtube-unofficial v0.3.1

Access parts of your account unavailable through normal YouTube API access.

COMMANDS

  youtube

Unofficial YouTube CLI.

    youtube [OPTIONS] COMMAND [ARGS]...

  clear-watch-history

Clear watch history.

    youtube clear-watch-history [OPTIONS]

Options

-d, --debug
    Enable debug output.

-b, --browser <browser>
    Browser to read cookies from.

-p, --profile <profile>
    Browser profile.

  clear-watch-later

Clear watch later queue.

    youtube clear-watch-later [OPTIONS]

Options

-d, --debug
    Enable debug output.

-b, --browser <browser>
    Browser to read cookies from.

-p, --profile <profile>
    Browser profile.

  print-history

Print your watch history.

By default, this will print the video IDs of your watch history.

If -j/--json is specified, this will print a JSON object for each video in your watch history. The JSON object will have the following interface:

    {
        channel_thumbnails: {
            height: int
            width: int
            url: string
        }[]
        description: string
        length: string
        length_accessible: string
        long_byline_text: string
        moving_thumbnails: {
            height: int
            width: int
            url: string
        }[]
        owner_text: string
        short_byline_text: string
        short_view_count_text: string
        title: string
        video_id: string
        video_thumbnails: {
            height: int
            width: int
            url: string
        }[]
     }

    youtube print-history [OPTIONS]

Options

-d, --debug
    Enable debug output.

-b, --browser <browser>
    Browser to read cookies from.

-p, --profile <profile>
    Browser profile.

-j, --json
    Output in JSON format.

  print-playlist

Print a playlist.

By default, this will print the video IDs of the given playlist ID.

If -j/--json is specified, this will print a JSON object for each video in your Watch Later playlist. The JSON object will have the following interface:

    {
        owner: string
        title: string
        video_id: string
        watch_url: string
    }

    youtube print-playlist [OPTIONS] PLAYLIST_ID

Options

-d, --debug
    Enable debug output.

-b, --browser <browser>
    Browser to read cookies from.

-p, --profile <profile>
    Browser profile.

-j, --json
    Output in JSON format.

    Arguments

PLAYLIST_ID
    Required argument

  print-watch-later

Print your Watch Later playlist.

By default, this will print the video IDs of your Watch Later playlist.

If -j/--json is specified, this will print a JSON object for each video in your Watch Later playlist. The JSON object will have the following interface:

    {
        owner: string
        title: string
        video_id: string
        watch_url: string
    }

    youtube print-watch-later [OPTIONS]

Options

-d, --debug
    Enable debug output.

-b, --browser <browser>
    Browser to read cookies from.

-p, --profile <profile>
    Browser profile.

-j, --json
    Output in JSON format.

  remove-history-entries

Remove videos from Watch History.

    youtube remove-history-entries [OPTIONS] [VIDEO_IDS]...

Options

-d, --debug
    Enable debug output.

-b, --browser <browser>
    Browser to read cookies from.

-p, --profile <profile>
    Browser profile.

    Arguments

VIDEO_IDS
    Optional argument(s)

  remove-video-id

Remove videos from a playlist.

    youtube remove-video-id [OPTIONS] PLAYLIST_ID [VIDEO_IDS]...

Options

-d, --debug
    Enable debug output.

-b, --browser <browser>
    Browser to read cookies from.

-p, --profile <profile>
    Browser profile.

    Arguments

PLAYLIST_ID
    Required argument

VIDEO_IDS
    Optional argument(s)

  remove-watch-later-video-id

Remove videos from your Watch Later queue.

    youtube remove-watch-later-video-id [OPTIONS] [VIDEO_IDS]...

Options

-d, --debug
    Enable debug output.

-b, --browser <browser>
    Browser to read cookies from.

-p, --profile <profile>
    Browser profile.

    Arguments

VIDEO_IDS
    Optional argument(s)

  toggle-watch-history

Disable or enable watch history.

    youtube toggle-watch-history [OPTIONS]

Options

-d, --debug
    Enable debug output.

-b, --browser <browser>
    Browser to read cookies from.

-p, --profile <profile>
    Browser profile.

AUTHOR
Andrew Udvare <audvare@gmail.com>

COPYRIGHT
2025