gophersgang/ytdl

YouTube download library and CLI written in Go

ytdl

---

Go library for downloading YouTube videos

Documentation: https://godoc.org/github.com/rylio/ytdl

Example

import (
   "github.com/otium/ytdl"
   "os"
)

vid, err := ytdl.GetVideoInfo("https://www.youtube.com/watch?v=1rZ-JorHJEY")
file, _ = os.Create(vid.Title + ".mp4")
defer file.Close()
vid.Download(file)

ytdl CLI

To install: go get -u github.com/rylio/ytdl/...

Usage

ytdl [global options] [youtube url or video id]

Options

• --help, -h - show help
• --filter, -f - Filter out formats
  • Syntax: -f key:value1,value2,...,valueN
    • Shortcuts for best/worst(e.g. -f best)
      • best/worst - best/worst video and audio
      • best-video/worst-video - best/worst video
      • best-audio/worst-audio - best/worst audio
  • To exclude: -f !key:value1,...
  • Available keys (See format.go for available values):
    • ext - extension of video
    • res - resolution of video
    • videnc - video encoding
    • audenc - audio encoding
    • prof - youtube video profile
    • audbr - audio bitrate
  • Default filters
    • ext:mp4
    • !videnc:
    • !audenc:
    • best
• --output, -o - Output to specific path
  • Supports templates, ex: {{.Title}}.{{.Ext}}
  • Defaults to {{.Title}}.{{.Ext}}
  • Supported template variables are Title, Ext, DatePublished, Resolution
  • Pass - to output to stdout, former stdout output is redirected to stderr
• --info, -i - Just gets video info, outputs to stdout
• --no-progress - Disables the progress bar
• --silent, -s - Disables all output, except for fatal errors
• --debug, -d - Output debug logs
• --append, -a - append to output file, instead of truncating
• --range, -r - specify a range of bytes, placed in http range header, ex: 0-100
• --download-url, -u - just print download url to, don't do anything else
• --version, -v - print out ytdl cli version
• --start-offset - offset the beginning of the video by a duration of time(e.g. 20s or 1m)

License

ytdl is released under the MIT License, see LICENSE for more details.