Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/kkdai/youtube
Download Youtube Video in Golang
https://github.com/kkdai/youtube
go youtube
Last synced: 2 days ago
JSON representation
Download Youtube Video in Golang
- Host: GitHub
- URL: https://github.com/kkdai/youtube
- Owner: kkdai
- License: mit
- Created: 2015-12-15T07:15:27.000Z (almost 9 years ago)
- Default Branch: master
- Last Pushed: 2024-08-17T16:34:41.000Z (4 months ago)
- Last Synced: 2024-12-03T00:05:54.814Z (9 days ago)
- Topics: go, youtube
- Language: Go
- Size: 446 KB
- Stars: 3,410
- Watchers: 61
- Forks: 439
- Open Issues: 47
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- my-awesome - kkdai/youtube - 12 star:3.4k fork:0.4k Download Youtube Video in Golang (Go)
- awesome-golang-repositories - youtube
- awesome-macos - youtubedr - CLI to download YouTube videos in Golang. [![Open-Source Software][OSS Icon]](https://github.com/kkdai/youtube) [![Homebrew][Homebrew Icon]](https://formulae.brew.sh/formula/youtubedr) (Uncategorized / Uncategorized)
README
Download Youtube Video in Golang
==================
[](https://raw.githubusercontent.com/kkdai/youtube/master/LICENSE)
[](https://pkg.go.dev/github.com/kkdai/youtube/v2)
[](https://github.com/kkdai/youtube/actions)
[](https://codecov.io/gh/kkdai/youtube)
[](https://goreportcard.com/badge/github.com/kkdai/youtube)
This package is a Youtube video download package, for more detail refer [https://github.com/ytdl-org/youtube-dl](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
* [Install](#installation)
* [Usage](#usage)
* [Example: Download video from \[dotGo 2015 - Rob Pike - Simplicity is Complicated\]](#download-dotGo-2015-rob-pike-video)
## Installation
### Install via go get
Please ensure you have installed Go 1.22 or later.
```shell
go get github.com/kkdai/youtube/v2
```
### From source code
```shell
git clone https://github.com/kkdai/youtube.git
cd youtube
go run ./cmd/youtubedr
```
### Mac
```shell
brew install youtubedr
```
### in Termux
```shell
pkg install youtubedr
```
### You can also find this package in
- [archlinux](https://aur.archlinux.org/packages/youtubedr/) (thanks to [cjsthompson](https://github.com/cjsthompson))
- [Termux package](https://github.com/termux/termux-packages/tree/master/packages/youtubedr) (thanks to [kcubeterm](https://github.com/kcubeterm))
- [Homebrew](https://formulae.brew.sh/formula/youtubedr) (thanks to [kkc](https://github.com/kkc))
## 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`
```shell
$ 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](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](https://www.youtube.com/watch?v=rFejpH_tAHM)
```
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](https://www.youtube.com/watch?v=rFejpH_tAHM)
```
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](https://www.youtube.com/watch?v=rFejpH_tAHM) 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](https://www.youtube.com/watch?v=rFejpH_tAHM) 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](https://www.youtube.com/watch?v=rFejpH_tAHM)
```
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
- [https://github.com/ytdl-org/youtube-dl](https://github.com/ytdl-org/youtube-dl)
- [https://github.com/lepidosteus/youtube-dl](https://github.com/lepidosteus/youtube-dl)
- [拆解 Youtube 影片下載位置](http://hkgoldenmra.blogspot.tw/2013/05/youtube.html)
- [iawia002/annie](https://github.com/iawia002/annie)
- [How to get url from obfuscate video info: youtube video downloader with php](https://stackoverflow.com/questions/60607291/youtube-video-downloader-with-php)
## Project52
It is one of my [project 52](https://github.com/kkdai/project52).
## License
This package is licensed under MIT license. See LICENSE for details.