you-get 0.3.3

A YouTube/Youku/Niconico video downloader written in Python 3.

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

Features

Supported Sites (As of Now)

• YouTube http://www.youtube.com

• Vimeo http://vimeo.com

• Dailymotion http://dailymotion.com

• Facebook http://facebook.com

• Google+ http://plus.google.com

• Tumblr http://www.tumblr.com

• SoundCloud http://soundcloud.com

• Mixcloud http://www.mixcloud.com

• JPopsuki http://jpopsuki.tv

• 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

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

   Or (on Windows):

   > setup.py install

   Check if the installation was successful:

   $ you-get -V

4. Direct download:

   $ 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

   Or (on Windows):

   > setup.py install

   Check if the installation was successful:

   $ you-get -V

5. Install from AUR (Arch User Repository):

   Click here.

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.

Changelog

0.3.3

Date: 2013-03-01

• Add support for:

  • Douban

  • MioMio

• Fix issue for:

  • Tudou

  • Vimeo

0.3.2

Date: 2013-02-22

• Add support for:

  • JPopsuki

• Fix issue for Xiami.

0.3.1

Date: 2013-02-15

• Fix issues for Google+ and Mixcloud.

• API changed.

0.3.0

Date: 2013-02-08

• Add support for:

  • Niconico

0.3dev-20130201

Date: 2013-02-01

• Add support for:

  • Mixcloud

  • Facebook

  • Joy.cn

0.3dev-20130125

Date: 2013-01-25

• Dailymotion: downloading best quality available now.

• iQIYI: fix #77.

0.3dev-20130118

Date: 2013-01-18

• YinYueTai: downloading best quality available now.

• Sohu: fix #69.

0.3dev-20130111

Date: 2013-01-11

• Add support for:

  • NetEase (v.163.com)

  • YouTube short URLs

• Vimeo: downloading best quality available now.

0.3dev-20130104

Date: 2013-01-04

• Sohu:

  • fix #53.

  • merge pull request #54; downloading best quality available now.

0.3dev-20121228

Date: 2012-12-28

• Add support for:

  • Xiami

  • Tumblr audios

0.3dev-20121221

Date: 2012-12-21

• YouTube: fix #45.

• Merge pull request #46; fix title parsing issue on Tudou.

0.3dev-20121220

Date: 2012-12-20

• YouTube: quick dirty fix to #45.

0.3dev-20121219

Date: 2012-12-19

• Add support for:

  • Tumblr

0.3dev-20121217

Date: 2012-12-17

• Google+: downloading best quality available now.

• Fix issues #42, #43 for Google+.

• Merge pull request #40; fix some issues for Ku6, Sina and 56.

0.3dev-20121212

Date: 2012-12-12

• YouTube: fix some major issues on parsing video titles.

0.3dev-20121210

Date: 2012-12-10

• YouTube: downloading best quality available now.

• Add support for:

  • SoundCloud

0.2.16

Date: 2012-12-01

• Add support for:

  • QQ

• Small fixes merged from youku-lixian.

0.2.15

Date: 2012-11-30

• Fix issue #30 for bilibili.

0.2.14

Date: 2012-11-29

• Fix issue #28 for Tudou.

• Better support for AcFun.

0.2.13

Date: 2012-10-30

• Nothing new.

0.2.12

Date: 2012-10-30

• Fix issue #20 for AcFun.

0.2.11

Date: 2012-10-23

• Move on to Python 3.3!

• Fix issues:

  • #17

  • #18

  • #19

0.2.10

Date: 2012-10-16

• Add support for:

  • Google+

0.2.9

Date: 2012-10-09

• Fix issue #16.

0.2.8

Date: 2012-10-02

• Fix issue #15 for AcFun.

0.2.7

Date: 2012-09-28

• Fix issue #6 for YouTube.

0.2.6

Date: 2012-09-26

• Fix issue #5 for YinYueTai.

0.2.5

Date: 2012-09-25

• Add support for:

  • Dailymotion

0.2.4

Date: 2012-09-18

• Use FFmpeg for converting and joining video files.

• Add ‘–url’ and ‘–debug’ options.

0.2.2

Date: 2012-09-17

• Add danmaku support for AcFun and bilibili.

• Fix issue #2 and #4 for YouTube.

• Temporarily fix issue for iQIYI (use .ts instead of .f4v).

0.2.1

Date: 2012-09-02

• Add support for:

  • ifeng

0.2

Date: 2012-09-02

• Add support for:

  • Vimeo

  • AcFun

  • bilibili

  • CNTV

  • iQIYI

  • Ku6

  • PPTV

  • Sina

  • Sohu

  • 56

0.1.3

Date: 2012-09-01

• Playlist URLs are now automatically handled. (’–playlist’ option is no longer needed)

• Handle KeyboardInterrupt silently.

• Fix Unicode character display on code pages.

0.1

Date: 2012-09-01

• First PyPI release.

• Fix issue #1.

0.0.1

Date: 2012-08-21

• Initial release, forked from iambus/youku-lixian; add:

  • YouTube support.

  • Pausing and resuming of downloads.

  • HTTP proxy settings.