youtube

README

YouTube

Device OAuth

• https://datatracker.ietf.org/doc/html/rfc8628
• https://developers.google.com/identity/sign-in/devices

How to get X-Goog-Api-Key

Next open your browser menu, and click Web Developer, Network or similar. Then go to:

https://www.youtube.com

then go back to Developer Tools, and you should see a JSON request like this:

POST /youtubei/v1/guide?key=AIzaSyAO_FJ2SlqU8Q4STEHLGCilw_Y9_11qcW8 HTTP/1.1
Host: www.youtube.com

https://cloud.google.com/apis/docs/system-parameters

How to get client_id and client_secret

Set User-Agent to [1]:

Mozilla/5.0 (ChromiumStylePlatform) Cobalt/Version

Then visit:

https://www.youtube.com/tv

Next open your browser menu, and click Web Developer, Network or similar. Then go back to the page, and click "Sign in", then "Sign in with a web browser". On the next page, dont bother with any of the instructions, just go back to Developer Tools, and after about five seconds you should see a JSON request like this:

POST /o/oauth2/token HTTP/1.1
Host: www.youtube.com

{"client_id":"861556708454-d6dlm3lh05idd8npek18k6be8ba3oc68.apps.googleusercontent.com",
"client_secret":"SboVhoG9s0rNafixCSGGKXAT",
"code":"AH-1Ng14qVvEj76OeM_h14Mgklgyhchbyc67MhULhCKPY6K-0DTYJqaKng2ULVFTmTzU...",
"grant_type":"http://oauth.net/grant_type/device/1.0"}

References:

1. https://github.com/youtube/cobalt/blob/master/src/cobalt/browser/user_agent_string.cc

Free proxy list

• https://proxy.webshare.io/register
• https://unblockvideos.com/youtube-video-restriction-checker

other repos

• https://github.com/Hexer10/youtube_explode_dart
• https://github.com/Athlon1600/youtube-downloader
• https://github.com/DzenanJupic/rustube
• https://github.com/Tyrrrz/YoutubeDownloader
• https://github.com/Tyrrrz/YoutubeExplode
• https://github.com/haruhi-dl/haruhi-dl
• https://github.com/iawia002/annie
• https://github.com/ibv/YTD
• https://github.com/kkdai/youtube
• https://github.com/pytube/pytube
• https://github.com/yt-dlp/yt-dlp
• https://github.com/ytdl-org/youtube-dl

Documentation

Overview

YouTube

Index

• Variables
• type Auth
• type Client
• type Exchange
  • func (x *Exchange) Refresh() error
• type Format
  • func (f Format) Ext() string
  • func (f Format) Write(w io.Writer) error
• type FormatSlice
  • func (f FormatSlice) Filter(keep func(Format) bool) FormatSlice
  • func (f FormatSlice) Sort(less ...func(a, b Format) bool)
• type Microformat
• type OAuth
  • func NewOAuth() (*OAuth, error)
  • func (o OAuth) Exchange() (*Exchange, error)
• type Picture
  • func (p Picture) Address(id string) string
• type PictureFormat
• type PictureSlice
  • func (p PictureSlice) Filter(keep func(Picture) bool) PictureSlice
  • func (p PictureSlice) Sort(less ...func(a, b Picture) bool)
• type Player
  • func NewPlayer(id string, head Auth, body Client) (*Player, error)
• type PlayerMicroformatRenderer
• type Result
  • func (r *Result) SetDistance(other *goimagehash.ImageHash) error
• type Search
  • func NewSearch(query string) (*Search, error)
  • func (s Search) Results() []Result
• type StreamingData
• type VideoDetails

Variables

var (
	WebP = PictureFormat{0, "vi_webp", "webp"}
	JPG  = PictureFormat{1, "vi", "jpg"}
)

var (
	Android = Client{Name: "ANDROID", Version: "16.05"}
	Embed   = Client{Name: "ANDROID", Screen: "EMBED", Version: "16.05"}
	Mweb    = Client{Name: "MWEB", Version: "2.19700101"}
)

var Key = Auth{"X-Goog-Api-Key", "AIzaSyAO_FJ2SlqU8Q4STEHLGCilw_Y9_11qcW8"}

var Pictures = PictureSlice{
	{120, 90, 68, "default", JPG},
	{120, 90, 90, "1", JPG},
	{120, 90, 90, "2", JPG},
	{120, 90, 90, "3", JPG},
	{120, 90, 68, "default", WebP},
	{120, 90, 90, "1", WebP},
	{120, 90, 90, "2", WebP},
	{120, 90, 90, "3", WebP},
	{320, 180, 180, "mqdefault", JPG},
	{320, 180, 320, "mq1", JPG},
	{320, 180, 320, "mq2", JPG},
	{320, 180, 320, "mq3", JPG},
	{320, 180, 180, "mqdefault", WebP},
	{320, 180, 320, "mq1", WebP},
	{320, 180, 320, "mq2", WebP},
	{320, 180, 320, "mq3", WebP},
	{480, 360, 270, "0", JPG},
	{480, 360, 270, "hqdefault", JPG},
	{480, 360, 360, "hq1", JPG},
	{480, 360, 360, "hq2", JPG},
	{480, 360, 360, "hq3", JPG},
	{480, 360, 270, "0", WebP},
	{480, 360, 270, "hqdefault", WebP},
	{480, 360, 360, "hq1", WebP},
	{480, 360, 360, "hq2", WebP},
	{480, 360, 360, "hq3", WebP},
	{640, 480, 360, "sddefault", JPG},
	{640, 480, 480, "sd1", JPG},
	{640, 480, 480, "sd2", JPG},
	{640, 480, 480, "sd3", JPG},
	{640, 480, 360, "sddefault", WebP},
	{640, 480, 480, "sd1", WebP},
	{640, 480, 480, "sd2", WebP},
	{640, 480, 480, "sd3", WebP},
	{1280, 720, 720, "hq720", JPG},
	{1280, 720, 720, "maxres1", JPG},
	{1280, 720, 720, "maxres2", JPG},
	{1280, 720, 720, "maxres3", JPG},
	{1280, 720, 720, "maxresdefault", JPG},
	{1280, 720, 720, "hq720", WebP},
	{1280, 720, 720, "maxres1", WebP},
	{1280, 720, 720, "maxres2", WebP},
	{1280, 720, 720, "maxres3", WebP},
	{1280, 720, 720, "maxresdefault", WebP},
}

Types

type Auth

type Auth struct {
	Key string
	Val string
}

type Client

type Client struct {
	Name    string `json:"clientName"`
	Screen  string `json:"clientScreen,omitempty"`
	Version string `json:"clientVersion"`
}

type Exchange

type Exchange struct {
	Access_Token  string
	Refresh_Token string
}

func (*Exchange) Refresh

func (x *Exchange) Refresh() error

type Format

type Format struct {
	Bitrate       int64
	ContentLength int64 `json:"contentLength,string"`
	Height        int
	Itag          int
	MimeType      string
	URL           string
}

func (Format) Ext

func (f Format) Ext() string

func (Format) Write

func (f Format) Write(w io.Writer) error

type FormatSlice

type FormatSlice []Format

func (FormatSlice) Filter

func (f FormatSlice) Filter(keep func(Format) bool) FormatSlice

func (FormatSlice) Sort

func (f FormatSlice) Sort(less ...func(a, b Format) bool)

type Microformat

type Microformat struct {
	PlayerMicroformatRenderer `json:"playerMicroformatRenderer"`
}

type OAuth

type OAuth struct {
	Device_Code      string
	User_Code        string
	Verification_URL string
}

func NewOAuth

func NewOAuth() (*OAuth, error)

func (OAuth) Exchange

func (o OAuth) Exchange() (*Exchange, error)

type Picture

type Picture struct {
	Width     int
	Height    int
	SubHeight int
	Base      string
	Format    PictureFormat
}

func (Picture) Address

func (p Picture) Address(id string) string

type PictureFormat

type PictureFormat struct {
	Size int
	Dir  string
	Ext  string
}

type PictureSlice

type PictureSlice []Picture

func (PictureSlice) Filter

func (p PictureSlice) Filter(keep func(Picture) bool) PictureSlice

func (PictureSlice) Sort

func (p PictureSlice) Sort(less ...func(a, b Picture) bool)

type Player

type Player struct {
	Microformat       `json:"microformat"`
	PlayabilityStatus struct {
		Reason string
		Status string
	}
	StreamingData `json:"streamingData"`
	VideoDetails  `json:"videoDetails"`
}

func NewPlayer

func NewPlayer(id string, head Auth, body Client) (*Player, error)

type PlayerMicroformatRenderer

type PlayerMicroformatRenderer struct {
	AvailableCountries []string
	PublishDate        string
}

type Result

type Result struct {
	VideoID  string
	Distance int
}

func (*Result) SetDistance

func (r *Result) SetDistance(other *goimagehash.ImageHash) error

type Search

type Search struct {
	Contents struct {
		SectionListRenderer struct {
			Contents []struct {
				ItemSectionRenderer struct {
					Contents []struct {
						CompactVideoRenderer struct {
							VideoID string
						}
					}
				}
			}
		}
	}
}

func NewSearch

func NewSearch(query string) (*Search, error)

func (Search) Results

func (s Search) Results() []Result

type StreamingData

type StreamingData struct {
	AdaptiveFormats FormatSlice
	// just including this so I can bail if video is Dash Manifest
	DashManifestURL string
}

type VideoDetails

type VideoDetails struct {
	Author           string
	ShortDescription string
	Title            string
	ViewCount        int `json:"viewCount,string"`
}