go-get-youtube

README

go-get-youtube v 0.2

A tiny Go library + client (command line Youtube video downloader) for downloading Youtube videos. The library is capable of fetching Youtube video metadata, in addition to downloading videos. If ffmpeg is available, client can extract MP3 audio from downloaded video files.

Client

Once you have compiled or downloaded the binary, simply run the following on your terminal:

ytdownload -id=youtube_video_id

Building

$ export GOPATH=$PWD/go-get-youtube
$ go get github.com/Kunal-Diwan/go-get-youtube
$ cd go-get-youtube/bin
$ ./go-get-youtube -id=cN_DpYBzKso -itag 18 -rename -mp3

Extracted audio: cN_DpYBzKso-rob-pike-concurrency-is-not-parallelis.mp3
Download duration: 5s
Average speed: 16.1MB/s
Downloaded video: cN_DpYBzKso-rob-pike-concurrency-is-not-parallelism.mp4

Library

Methods

youtube.Get(youtube_video_id)

video, err = youtube.Get(youtube_video_id)

Initializes a Video object by fetching its metdata from Youtube. Video is a struct with the following structure

{
	Id, Title, Author, Keywords, Thumbnail_url string
	Avg_rating float32
	View_count,	Length_seconds int
	Formats []Format
}

Video.Formats is an array of the Format struct, which looks like this:

type Format struct {
	Itag int
	Video_type, Quality, Url string
}

type Option struct {
	Resume bool // resume failed or cancelled download
	Rename bool // rename output file using video title
	Mp3    bool // extract audio using ffmpeg
}

youtube.Download(format_index, output_file, option)

format_index is the index of the format listed in the Video.Formats array. Youtube offers a number of video formats (mp4, webm, 3gp etc.)

youtube.GetExtension(format_index)

Guesses the file extension (avi, 3gp, mp4, webm) based on the format chosen

Example

import (
	youtube "github.com/Kunal-Diwan/go-get-youtube/youtube"
)

func main() {
	// get the video object (with metdata)
	video, err := youtube.Get("FTl0tl9BGdc")

	// download the video and write to file
	option := &youtube.Option{
		Rename: true,  // rename file using video title
		Resume: true,  // resume cancelled download
		Mp3:    true,  // extract audio to MP3
	}
	video.Download(0, "video.mp4", option)
}