youtube

README

YouTube

Is maxres1 always available? No:

• http://i.ytimg.com/vi_webp/hq2KgzKETBw/maxres1.webp
• http://i.ytimg.com/vi/hq2KgzKETBw/maxres1.jpg

Is sd1 always available? No:

• http://i.ytimg.com/vi_webp/hq2KgzKETBw/sd1.webp
• http://i.ytimg.com/vi/hq2KgzKETBw/sd1.jpg

If hq1 always available? Yes:

http://i.ytimg.com/vi/hq2KgzKETBw/hq1.jpg

Clients

Need Android:

client	MeJVWBSsPAY
Android	pass
Embed	fail
Mweb	fail
TV	fail

Need Embed:

client	QWlNyzzwgcc
Android	fail
Embed	pass
Mweb	fail
TV	fail

Need Mweb:

client	aN76CmldknI publishDate
Android	fail
Embed	fail
Mweb	pass
TV	fail

Cover art

• https://wiki.musicbrainz.org/Cover_Art_Archive/API
• http://hackerfactor.com/blog?archives/529-Kind-of-Like-That.html
• http://mdpi.com/2313-433X/7/3/48/htm

Device OAuth

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

How to get X-Goog-Api-Key

Make a request like this:

GET / HTTP/2
Host: www.youtube.com

in the response you should see something like this:

"INNERTUBE_API_KEY":"AIzaSyAO_FJ2SlqU8Q4STEHLGCilw_Y9_11qcW8"

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

other repos

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

Documentation

Overview

YouTube

Index

• Variables
• func ValidID(id string) error
• 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 Item
  • func (i Item) Duration() (time.Duration, error)
  • func (i Item) Title() string
  • func (i Item) VideoID() string
• 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)
  • func (p Player) Author() string
  • func (p Player) Countries() []string
  • func (p Player) Date() string
  • func (p Player) Description() string
  • func (p Player) Title() string
  • func (p Player) Views() int
• type Search
  • func NewSearch(query string) (*Search, error)
  • func (s Search) Items() []Item
• type Text

Variables

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

var (
	Key     = Auth{"X-Goog-Api-Key", "AIzaSyAO_FJ2SlqU8Q4STEHLGCilw_Y9_11qcW8"}
	Verbose = false
)

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 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},
}

Functions

func ValidID

func ValidID(id string) error

Types

type Auth

type Auth struct {
	Key   string
	Value 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 Item

type Item struct {
	CompactVideoRenderer *struct {
		LengthText Text
		Title      Text
		VideoID    string
	}
}

func (Item) Duration

func (i Item) Duration() (time.Duration, error)

func (Item) Title

func (i Item) Title() string

func (Item) VideoID

func (i Item) VideoID() string

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 struct {
		PlayerMicroformatRenderer struct {
			AvailableCountries []string
			PublishDate        string
		}
	}
	PlayabilityStatus struct {
		Reason string
		Status string
	}
	StreamingData struct {
		AdaptiveFormats FormatSlice
		// just including this so I can bail if video is Dash Manifest
		DashManifestURL string
	}
	VideoDetails struct {
		Author           string
		ShortDescription string
		Title            string
		ViewCount        int `json:"viewCount,string"`
	}
}

func NewPlayer

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

func (Player) Author

func (p Player) Author() string

func (Player) Countries

func (p Player) Countries() []string

func (Player) Date

func (p Player) Date() string

func (Player) Description

func (p Player) Description() string

func (Player) Title

func (p Player) Title() string

func (Player) Views

func (p Player) Views() int

type Search

type Search struct {
	Contents struct {
		SectionListRenderer struct {
			Contents []struct {
				ItemSectionRenderer *struct {
					Contents []Item
				}
			}
		}
	}
}

func NewSearch

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

func (Search) Items

func (s Search) Items() []Item

type Text

type Text struct {
	Runs []struct {
		Text string
	}
}