README

You-Get





NOTICE (30 May 2022): Support for Python 3.5, 3.6 and 3.7 will eventually be dropped. (see details here))

NOTICE (8 Mar 2019): Read this if you are looking for the conventional "Issues" tab.

---

You-Get is a tiny command-line utility to download media contents (videos, audios, images) from the Web, in case there is no other handy way to do it.

Here's how you use you-get to download a video from YouTube:

console
$ you-get 'https://www.youtube.com/watch?v=jNQXAC9IVRw'
site:                YouTube
title:               Me at the zoo
stream:
    - itag:          43
      container:     webm
      quality:       medium
      size:          0.5 MiB (564215 bytes)
     download-with: you-get --itag=43 [URL]

Downloading Me at the zoo.webm ...
 100% (  0.5/  0.5MB) ├██████████████████████████████████┤[1/1]    6 MB/s

Saving Me at the zoo.en.srt ... Done.


And here's why you might want to use it:

 You enjoyed something on the Internet, and just want to download them for your own pleasure.
 You watch your favorite videos online from your computer, but you are prohibited from saving them. You feel that you have no control over your own computer. (And it's not how an open Web is supposed to work.)
 You want to get rid of any closed-source technology or proprietary JavaScript code, and disallow things like Flash running on your computer.
 You are an adherent of hacker culture and free software.

What you-get can do for you:

 Download videos / audios from popular websites such as YouTube, Youku, Niconico, and a bunch more. (See the full list of supported sites)
 Stream an online video in your media player. No web browser, no more ads.
 Download images (of interest) by scraping a web page.
 Download arbitrary non-HTML contents, i.e., binary files.

Interested? Install it now and get started by examples.

Are you a Python programmer? Then check out the source and fork it!

!

 Installation

 Prerequisites

The following dependencies are recommended:

 Python  3.7.4 or above
 FFmpeg 1.0 or above
 (Optional) RTMPDump

 Option 1: Install via pip

The official release of you-get is distributed on PyPI, and can be installed easily from a PyPI mirror via the pip) package manager: (Note that you must use the Python 3 version of pip)

    $ pip install you-get

 Option 2: Install via Antigen (for Zsh users)

Add the following line to your .zshrc:

    antigen bundle soimort/you-get

 Option 3: Download from GitHub

You may either download the stable (identical with the latest release on PyPI) or the develop (more hotfixes, unstable features) branch of you-get. Unzip it, and put the directory containing the you-get script into your PATH.

Alternatively, run


$ cd path/to/you-get
$ [sudo] python -m pip install .


Or


$ cd path/to/you-get
$ python -m pip install . --user


to install you-get to a permanent path. (And don't omit the dot . representing the current directory)

You can also use the pipenv to install the you-get in the Python virtual envi

Latest release

You-Get 0.4.1743 is now released on PyPI.

Please upgrade to the latest version:

 console
$ pip install --upgrade you-get


 What's Changed
 [YouTube] Fix extraction
 Fix: Restore functionality of -o parameter for Miaopai downloads by @doskey in https://github.com/soimort/you-get/pull/3030
 remove imported but unsed module by @ljhcage in https://github.com/soimort/you-get/pull/3032

 New Contributors
 @doskey made their first contribution in https://github.com/soimort/you-get/pull/3030

Full Changelog: https://github.com/soimort/you-get/compare/v0.4.1730...v0.4.1743