youtube

package module
v2.10.1 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Mar 11, 2024 License: MIT Imports: 23 Imported by: 139

README

Download Youtube Video in Golang

GitHub license Go Reference Build Status Coverage

This package is a Youtube video download package, for more detail refer https://github.com/ytdl-org/youtube-dl for more download options.

This tool is meant to be used to download CC0 licenced content, we do not support nor recommend using it for illegal activities.

Overview

Installation

Install via go get

Please ensure you have installed Go 1.21 or later.

go get github.com/kkdai/youtube/v2
From source code
git clone https://github.com/kkdai/youtube.git
cd youtube
go run ./cmd/youtubedr
Mac
brew install youtubedr
in Termux
pkg install youtubedr
You can also find this package in

Usage

Use the binary directly

It's really simple to use, just get the video id from youtube url - ex: https://www.youtube.com/watch?v=rFejpH_tAHM, the video id is rFejpH_tAHM

$ youtubedr download QAGDGja7kbs
$ youtubedr download https://www.youtube.com/watch?v=rFejpH_tAHM
Use this package in your golang program

Please check out the example_test.go for example code.

Example:

  • Get information of dotGo-2015-rob-pike video for downloading

    go get github.com/kkdai/youtube/v2/youtubedr

    Download video from dotGo 2015 - Rob Pike - Simplicity is Complicated

    youtubedr info https://www.youtube.com/watch?v=rFejpH_tAHM

Title: dotGo 2015 - Rob Pike - Simplicity is Complicated
Author: dotconferences
-----available streams-----
itag:  18 , quality: medium , type: video/mp4; codecs="avc1.42001E, mp4a.40.2"
itag:  22 , quality:  hd720 , type: video/mp4; codecs="avc1.64001F, mp4a.40.2"
itag: 137 , quality: hd1080 , type: video/mp4; codecs="avc1.640028"
itag: 248 , quality: hd1080 , type: video/webm; codecs="vp9"
........
  • Download dotGo-2015-rob-pike-video

    go get github.com/kkdai/youtube/v2/youtubedr

    Download video from dotGo 2015 - Rob Pike - Simplicity is Complicated

    youtubedr download https://www.youtube.com/watch?v=rFejpH_tAHM
  • Download video to specific folder and name

    go get github.com/kkdai/youtube/v2/youtubedr

    Download video from dotGo 2015 - Rob Pike - Simplicity is Complicated to current directory and name the file to simplicity-is-complicated.mp4

    youtubedr download -d ./ -o simplicity-is-complicated.mp4 https://www.youtube.com/watch?v=rFejpH_tAHM
  • Download video with specific quality

    go get github.com/kkdai/youtube/v2/youtubedr

    Download video from dotGo 2015 - Rob Pike - Simplicity is Complicated with specific quality

    youtubedr download -q medium https://www.youtube.com/watch?v=rFejpH_tAHM
    Special case by quality hd1080:

    Installation of ffmpeg is necessary for hd1080

    ffmpeg   //check ffmpeg is installed, if not please download ffmpeg and set to your PATH.
youtubedr download -q hd1080 https://www.youtube.com/watch?v=rFejpH_tAHM
  • Download video with specific itag

    go get github.com/kkdai/youtube/v2/youtubedr

    Download video from dotGo 2015 - Rob Pike - Simplicity is Complicated

    youtubedr download -q 18 https://www.youtube.com/watch?v=rFejpH_tAHM

How it works

  • Parse the video ID you input in URL
    • ex: https://www.youtube.com/watch?v=rFejpH_tAHM, the video id is rFejpH_tAHM
  • Get video information via video id.
    • Use URL: http://youtube.com/get_video_info?video_id=
  • Parse and decode video information.
    • Download URL in "url="
    • title in "title="
  • Download video from URL
    • Need the string combination of "url"

Inspired

Project52

It is one of my project 52.

License

This package is licensed under MIT license. See LICENSE for details.

Documentation

Overview

Package youtube implement youtube download package in go.

Index

Examples

Constants

View Source 
const (
	Size1Kb  = 1024
	Size1Mb  = Size1Kb * 1024
	Size10Mb = Size1Mb * 10
)
View Source 
const (
	ErrCipherNotFound             = constError("cipher not found")
	ErrSignatureTimestampNotFound = constError("signature timestamp not found")
	ErrInvalidCharactersInVideoID = constError("invalid characters in video id")
	ErrVideoIDMinLength           = constError("the video id must be at least 10 characters long")
	ErrReadOnClosedResBody        = constError("http: read on closed response body")
	ErrNotPlayableInEmbed         = constError("embedding of this video has been disabled")
	ErrLoginRequired              = constError("login required to confirm your age")
	ErrVideoPrivate               = constError("user restricted access to this video")
	ErrInvalidPlaylist            = constError("no playlist detected or invalid playlist ID")
)

Variables

View Source 
var (
	// WebClient, better to use Android client but go ahead.
	WebClient = clientInfo{
				// contains filtered or unexported fields
	}

	// AndroidClient, download go brrrrrr.
	AndroidClient = clientInfo{
					// contains filtered or unexported fields
	}

	// EmbeddedClient, not really tested.
	EmbeddedClient = clientInfo{
					// contains filtered or unexported fields
	}
)
View Source 
var DefaultClient = AndroidClient

DefaultClient type to use. No reason to change but you could if you wanted to.

View Source 
var (
	ErrNoFormat = errors.New("no video format provided")
)
View Source 
var (
	ErrTranscriptDisabled = errors.New("transcript is disabled on this video")
)
View Source 
var Logger = getLogger(os.Getenv("LOGLEVEL"))

The global logger for all Client instances

Functions

func ExtractVideoID added in v2.6.0 

func ExtractVideoID(videoID string) (string, error)

ExtractVideoID extracts the videoID from the given string

func SetLogLevel added in v2.9.0 

func SetLogLevel(value string)

Types

type CaptionTrack added in v2.8.2 

type CaptionTrack struct {
	BaseURL string `json:"baseUrl"`
	Name    struct {
		SimpleText string `json:"simpleText"`
	} `json:"name"`
	VssID          string `json:"vssId"`
	LanguageCode   string `json:"languageCode"`
	Kind           string `json:"kind,omitempty"`
	IsTranslatable bool   `json:"isTranslatable"`
}

type Client 

type Client struct {
	// HTTPClient can be used to set a custom HTTP client.
	// If not set, http.DefaultClient will be used
	HTTPClient *http.Client

	// MaxRoutines to use when downloading a video.
	MaxRoutines int

	// ChunkSize to use when downloading videos in chunks. Default is Size10Mb.
	ChunkSize int64
	// contains filtered or unexported fields
}

Client offers methods to download video metadata and video streams.

Example

ExampleDownload : Example code for how to use this package for download video. 

videoID := "BaW_jenozKc"
client := youtube.Client{}

video, err := client.GetVideo(videoID)
if err != nil {
	panic(err)
}

formats := video.Formats.WithAudioChannels() // only get videos with audio
stream, _, err := client.GetStream(video, &formats[0])
if err != nil {
	panic(err)
}
defer stream.Close()

file, err := os.Create("video.mp4")
if err != nil {
	panic(err)
}
defer file.Close()

_, err = io.Copy(file, stream)
if err != nil {
	panic(err)
}

Output:

func (*Client) GetPlaylist added in v2.6.0 

func (c *Client) GetPlaylist(url string) (*Playlist, error)

GetPlaylist fetches playlist metadata

func (*Client) GetPlaylistContext added in v2.6.0 

func (c *Client) GetPlaylistContext(ctx context.Context, url string) (*Playlist, error)

GetPlaylistContext fetches playlist metadata, with a context, along with a list of Videos, and some basic information for these videos. Playlist entries cannot be downloaded, as they lack all the required metadata, but can be used to enumerate all IDs, Authors, Titles, etc.

func (*Client) GetStream 

func (c *Client) GetStream(video *Video, format *Format) (io.ReadCloser, int64, error)

GetStream returns the stream and the total size for a specific format

Example 
video, err := testClient.GetVideo("https://www.youtube.com/watch?v=9_MbW9FK1fA")
if err != nil {
	panic(err)
}

// Typically youtube only provides separate streams for video and audio.
// If you want audio and video combined, take a look a the downloader package.
formats := video.Formats.Quality("medium")
reader, _, err := testClient.GetStream(video, &formats[0])
if err != nil {
	panic(err)
}

// do something with the reader

reader.Close()

Output:

func (*Client) GetStreamContext 

func (c *Client) GetStreamContext(ctx context.Context, video *Video, format *Format) (io.ReadCloser, int64, error)

GetStreamContext returns the stream and the total size for a specific format with a context.

func (*Client) GetStreamURL added in v2.0.2 

func (c *Client) GetStreamURL(video *Video, format *Format) (string, error)

GetStreamURL returns the url for a specific format

func (*Client) GetStreamURLContext added in v2.0.2 

func (c *Client) GetStreamURLContext(ctx context.Context, video *Video, format *Format) (string, error)

GetStreamURLContext returns the url for a specific format with a context

func (*Client) GetTranscript added in v2.8.0 

func (c *Client) GetTranscript(video *Video, lang string) (VideoTranscript, error)

GetTranscript fetches the video transcript if available.

Not all videos have transcripts, only relatively new videos. If transcripts are disabled or not available, ErrTranscriptDisabled is returned.

func (*Client) GetTranscriptCtx added in v2.8.0 

func (c *Client) GetTranscriptCtx(ctx context.Context, video *Video, lang string) (VideoTranscript, error)

GetTranscriptCtx fetches the video transcript if available.

Not all videos have transcripts, only relatively new videos. If transcripts are disabled or not available, ErrTranscriptDisabled is returned.

func (*Client) GetVideo 

func (c *Client) GetVideo(url string) (*Video, error)

GetVideo fetches video metadata

func (*Client) GetVideoContext 

func (c *Client) GetVideoContext(ctx context.Context, url string) (*Video, error)

GetVideoContext fetches video metadata with a context

func (*Client) VideoFromPlaylistEntry added in v2.6.0 

func (c *Client) VideoFromPlaylistEntry(entry *PlaylistEntry) (*Video, error)

func (*Client) VideoFromPlaylistEntryContext added in v2.6.0 

func (c *Client) VideoFromPlaylistEntryContext(ctx context.Context, entry *PlaylistEntry) (*Video, error)

type DecipherOperation added in v2.4.0 

type DecipherOperation func([]byte) []byte

type ErrPlayabiltyStatus 

type ErrPlayabiltyStatus struct {
	Status string
	Reason string
}

func (ErrPlayabiltyStatus) Error 

func (err ErrPlayabiltyStatus) Error() string

type ErrPlaylistStatus added in v2.7.9 

type ErrPlaylistStatus struct {
	Reason string
}

func (ErrPlaylistStatus) Error added in v2.7.9 

func (err ErrPlaylistStatus) Error() string

type ErrUnexpectedStatusCode 

type ErrUnexpectedStatusCode int

ErrUnexpectedStatusCode is returned on unexpected HTTP status codes

func (ErrUnexpectedStatusCode) Error 

func (err ErrUnexpectedStatusCode) Error() string

type Format 

type Format struct {
	ItagNo           int    `json:"itag"`
	URL              string `json:"url"`
	MimeType         string `json:"mimeType"`
	Quality          string `json:"quality"`
	Cipher           string `json:"signatureCipher"`
	Bitrate          int    `json:"bitrate"`
	FPS              int    `json:"fps"`
	Width            int    `json:"width"`
	Height           int    `json:"height"`
	LastModified     string `json:"lastModified"`
	ContentLength    int64  `json:"contentLength,string"`
	QualityLabel     string `json:"qualityLabel"`
	ProjectionType   string `json:"projectionType"`
	AverageBitrate   int    `json:"averageBitrate"`
	AudioQuality     string `json:"audioQuality"`
	ApproxDurationMs string `json:"approxDurationMs"`
	AudioSampleRate  string `json:"audioSampleRate"`
	AudioChannels    int    `json:"audioChannels"`

	// InitRange is only available for adaptive formats
	InitRange *struct {
		Start string `json:"start"`
		End   string `json:"end"`
	} `json:"initRange"`

	// IndexRange is only available for adaptive formats
	IndexRange *struct {
		Start string `json:"start"`
		End   string `json:"end"`
	} `json:"indexRange"`

	// AudioTrack is only available for videos with multiple audio track languages
	AudioTrack *struct {
		DisplayName    string `json:"displayName"`
		ID             string `json:"id"`
		AudioIsDefault bool   `json:"audioIsDefault"`
	}
}

func (*Format) LanguageDisplayName added in v2.10.0 

func (f *Format) LanguageDisplayName() string

type FormatList 

type FormatList []Format

func (FormatList) AudioChannels added in v2.6.0 

func (list FormatList) AudioChannels(n int) FormatList

AudioChannels returns a new FormatList filtered by the matching AudioChannels

func (FormatList) Itag added in v2.10.0 

func (list FormatList) Itag(itagNo int) FormatList

Type returns a new FormatList filtered by itag

func (FormatList) Language added in v2.10.0 

func (list FormatList) Language(displayName string) FormatList

Type returns a new FormatList filtered by display name

func (FormatList) Quality added in v2.6.0 

func (list FormatList) Quality(quality string) FormatList

Quality returns a new FormatList filtered by quality, quality label or itag, but not audio quality

func (FormatList) Select added in v2.10.0 

func (list FormatList) Select(f func(Format) bool) (result FormatList)

Type returns a new FormatList filtered by itag

func (FormatList) Sort added in v2.6.1 

func (list FormatList) Sort()

Sort sorts all formats fields

func (FormatList) Type added in v2.6.0 

func (list FormatList) Type(value string) FormatList

Type returns a new FormatList filtered by mime type

func (FormatList) WithAudioChannels added in v2.7.3 

func (list FormatList) WithAudioChannels() FormatList

AudioChannels returns a new FormatList filtered by the matching AudioChannels

type Playlist added in v2.6.0 

type Playlist struct {
	ID          string
	Title       string
	Description string
	Author      string
	Videos      []*PlaylistEntry
}
Example

Example usage for playlists: downloading and checking information. 

playlistID := "PLQZgI7en5XEgM0L1_ZcKmEzxW1sCOVZwP"
client := youtube.Client{}

playlist, err := client.GetPlaylist(playlistID)
if err != nil {
	panic(err)
}

/* ----- Enumerating playlist videos ----- */
header := fmt.Sprintf("Playlist %s by %s", playlist.Title, playlist.Author)
println(header)
println(strings.Repeat("=", len(header)) + "\n")

for k, v := range playlist.Videos {
	fmt.Printf("(%d) %s - '%s'\n", k+1, v.Author, v.Title)
}

/* ----- Downloading the 1st video ----- */
entry := playlist.Videos[0]
video, err := client.VideoFromPlaylistEntry(entry)
if err != nil {
	panic(err)
}
// Now it's fully loaded.

fmt.Printf("Downloading %s by '%s'!\n", video.Title, video.Author)

stream, _, err := client.GetStream(video, &video.Formats[0])
if err != nil {
	panic(err)
}

file, err := os.Create("video.mp4")

if err != nil {
	panic(err)
}

defer file.Close()
_, err = io.Copy(file, stream)

if err != nil {
	panic(err)
}

println("Downloaded /video.mp4")

Output:

type PlaylistEntry added in v2.6.0 

type PlaylistEntry struct {
	ID         string
	Title      string
	Author     string
	Duration   time.Duration
	Thumbnails Thumbnails
}

type Thumbnail added in v2.6.0 

type Thumbnail struct {
	URL    string
	Width  uint
	Height uint
}

type Thumbnails added in v2.6.0 

type Thumbnails []Thumbnail

type TranscriptSegment added in v2.8.0 

type TranscriptSegment struct {
	// Text is the transcipt text.
	Text string `json:"text"`

	// StartMs is the start timestamp in ms.
	StartMs int `json:"offset"`

	// OffsetText e.g. '4:00'.
	OffsetText string `json:"offsetText"`

	// Duration the transcript segment spans in ms.
	Duration int `json:"duration"`
}

TranscriptSegment is a single transcipt segment spanning a few milliseconds.

func (TranscriptSegment) String added in v2.8.0 

func (tr TranscriptSegment) String() string

type Video 

type Video struct {
	ID              string
	Title           string
	Description     string
	Author          string
	ChannelID       string
	ChannelHandle   string
	Views           int
	Duration        time.Duration
	PublishDate     time.Time
	Formats         FormatList
	Thumbnails      Thumbnails
	DASHManifestURL string // URI of the DASH manifest file
	HLSManifestURL  string // URI of the HLS manifest file
	CaptionTracks   []CaptionTrack
}

func (*Video) FilterQuality added in v2.6.0 

func (v *Video) FilterQuality(quality string)

FilterQuality reduces the format list to formats matching the quality

func (*Video) SortBitrateAsc added in v2.6.0 

func (v *Video) SortBitrateAsc(i int, j int) bool

func (*Video) SortBitrateDesc added in v2.6.0 

func (v *Video) SortBitrateDesc(i int, j int) bool

type VideoTranscript added in v2.8.0 

type VideoTranscript []TranscriptSegment

func (VideoTranscript) String added in v2.8.0 

func (vt VideoTranscript) String() string

Source Files

View all Source files

Directories

Path Synopsis
cmd
youtubedr

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.