You-Get

You-Get is a video downloader runs on Python 3. It aims at easing the download of videos on YouTube, Youku/Tudou (biggest online video providers in China), Niconico, etc., in one script.

See the project homepage http://www.soimort.org/you-get for further documentation.

Fork me on GitHub: https://github.com/soimort/you-get

__中文说明__已移至wiki。

Features

Supported Sites (As of Now)

• YouTube http://www.youtube.com
• Vimeo http://vimeo.com
• Coursera https://www.coursera.org
• Blip http://blip.tv
• Dailymotion http://dailymotion.com
• eHow http://www.ehow.com
• Facebook http://facebook.com
• Google+ http://plus.google.com
• Google Drive http://docs.google.com
• Khan Academy http://www.khanacademy.org
• TED http://www.ted.com
• Tumblr http://www.tumblr.com
• Vine http://vine.co
• Instagram http://instagram.com
• SoundCloud http://soundcloud.com
• Mixcloud http://www.mixcloud.com
• Freesound http://www.freesound.org
• JPopsuki http://jpopsuki.tv
• VID48 http://vid48.com
• Niconico (ニコニコ動画) http://www.nicovideo.jp
• Youku (优酷) http://www.youku.com
• Tudou (土豆) http://www.tudou.com
• YinYueTai (音悦台) http://www.yinyuetai.com
• AcFun http://www.acfun.tv
• bilibili http://www.bilibili.tv
• CNTV (中国网络电视台) http://www.cntv.cn
• Douban (豆瓣) http://douban.com
• ifeng (凤凰视频) http://v.ifeng.com
• iQIYI (爱奇艺) http://www.iqiyi.com
• Joy.cn (激动网) http://www.joy.cn
• Ku6 (酷6网) http://www.ku6.com
• MioMio http://www.miomio.tv
• NetEase (网易视频) http://v.163.com
• PPTV http://www.pptv.com
• QQ (腾讯视频) http://v.qq.com
• Sina (新浪视频) http://video.sina.com.cn
• Sohu (搜狐视频) http://tv.sohu.com
• 56 (56网) http://www.56.com
• Xiami (虾米) http://www.xiami.com
• 5sing http://www.5sing.com
• Baidu Music (百度音乐) http://music.baidu.com
• Baidu Wangpan (百度网盘) http://pan.baidu.com
• SongTaste http://www.songtaste.com
• Alive.in.th http://alive.in.th

Dependencies

• Python 3
• (Optional) FFmpeg
  • Used for converting and joining video files.

Installation

1. Install via Pip:

$ pip install you-get

Check if the installation was successful:

$ you-get -V

2. Install via EasyInstall:

$ easy_install you-get

Check if the installation was successful:

$ you-get -V

3. Install from Git:

$ git clone git://github.com/soimort/you-get.git

Use the raw script without installation:

$ cd you-get/
$ ./you-get -V

To install the package into the system path, execute:

$ make install

Check if the installation was successful:

$ you-get -V

4. Direct download (from https://github.com/soimort/you-get/zipball/master):

$ wget -O you-get.zip https://github.com/soimort/you-get/zipball/master
$ unzip you-get.zip

Use the raw script without installation:

$ cd soimort-you-get-*/
$ ./you-get -V

To install the package into the system path, execute:

$ make install

Check if the installation was successful:

$ you-get -V

5. Install from AUR (Arch User Repository):

Click here.

Upgrading:

Using Pip:

$ pip install --upgrade you-get

FAQ (For Windows Users):

• Q: I don't know how to install it on Windows.

• A: Then don't do it. Just put your you-get folder into system %PATH%.

• Q: I got something like UnicodeDecodeError: 'gbk' codec can't decode byte 0xb0 in position 1012: illegal multibyte sequence.

• A: Run set PYTHONIOENCODING=utf-8.

Examples (For End-Users)

Display the information of the video without downloading:

$ you-get -i http://www.youtube.com/watch?v=sGwy8DsUJ4M

Download the video:

$ you-get http://www.youtube.com/watch?v=sGwy8DsUJ4M

Download multiple videos:

$ you-get http://www.youtube.com/watch?v=sGwy8DsUJ4M http://www.youtube.com/watch?v=8bQlxQJEzLk

By default, program will skip any video that already exists in the local directory when downloading. If a temporary file (ends with a ".download" filename extension) is found, program will resume the download from last session.

To enforce re-downloading of videos, use '-f' option (this will overwrite any existing video or temporary file, rather than skipping or resuming them):

$ you-get -f http://www.youtube.com/watch?v=sGwy8DsUJ4M

Set the output directory for downloaded files:

$ you-get -o ~/Downloads http://www.youtube.com/watch?v=sGwy8DsUJ4M

Use a specific HTTP proxy for downloading:

$ you-get -x 127.0.0.1:8087 http://www.youtube.com/watch?v=sGwy8DsUJ4M

By default, Python will apply the system proxy settings (i.e. environment variable $http_proxy). To cancel the use of proxy, use '--no-proxy' option:

$ you-get --no-proxy http://www.youtube.com/watch?v=sGwy8DsUJ4M

Command-Line Options

For a complete list of all available options, see:

$ you-get --help

Examples (For Developers)

In Python 3 (interactive):

>>> from you_get.downloader import *
>>> youtube.download("http://www.youtube.com/watch?v=8bQlxQJEzLk", info_only = True)
Video Site: YouTube.com
Title:      If you're good at something, never do it for free!
Type:       WebM video (video/webm)
Size:       0.13 MB (133176 Bytes)

>>> import you_get
>>> you_get.any_download("http://www.youtube.com/watch?v=sGwy8DsUJ4M")
Video Site: YouTube.com
Title:      Mort from Madagascar LIKES
Type:       WebM video (video/webm)
Size:       1.78 MB (1867072 Bytes)

Downloading Mort from Madagascar LIKES.webm ...
100.0% (  1.8/1.8  MB) [========================================] 1/1

API Reference

See source code.

License

You-Get is licensed under the MIT license.

Contributing

Please see CONTRIBUTING.md.