lnsoso / you-get

A YouTube/Youku 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), 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
• Google+ http://plus.google.com
• Tumblr http://www.tumblr.com
• SoundCloud http://soundcloud.com
• 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
• ifeng (凤凰视频) http://v.ifeng.com
• iQIYI (爱奇艺) http://www.iqiyi.com
• Ku6 (酷6网) http://www.ku6.com
• 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 (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

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):

>>> import you_get

>>> you_get.__version__
'0.2'

>>> you_get.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)

>>> 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.

---

You-Get - 中文说明

You-Get是一个基于Python 3的视频下载工具。之所以写它的主要原因是，我找不到一个现成的下载工具能够同时支持YouTube和优酷；而且，几乎所有以前的视频下载程序都是基于Python 2的。

项目主页：http://www.soimort.org/you-get

GitHub地址：https://github.com/soimort/you-get

特点

说明

You-Get基于优酷下载脚本iambus/youku-lixian用Python 3改写而成，增加了以下功能：

• 支持YouTube、Vimeo等国外视频网站
• 支持断点续传
• 可设置HTTP代理

支持的站点（截至目前）

已实现对以下视频站点的支持，以后会陆续增加（・∀・）

• YouTube http://www.youtube.com
• Vimeo http://vimeo.com
• Dailymotion http://dailymotion.com
• Google+ http://plus.google.com
• Tumblr http://www.tumblr.com
• SoundCloud http://soundcloud.com
• 优酷 http://www.youku.com
• 土豆 http://www.tudou.com
• 音悦台 http://www.yinyuetai.com
• AcFun http://www.acfun.tv
• bilibili http://www.bilibili.tv
• CNTV http://www.cntv.cn
• 凤凰视频 http://v.ifeng.com
• 爱奇艺 http://www.iqiyi.com
• 酷6网 http://www.ku6.com
• 网易视频 http://v.163.com
• PPTV http://www.pptv.com
• 腾讯视频 http://v.qq.com
• 新浪视频 http://video.sina.com.cn
• 搜狐视频 http://tv.sohu.com
• 56网 http://www.56.com
• 虾米 http://www.xiami.com

依赖

• Python 3
• （可选） FFmpeg
  • 用于转换与合并视频文件。

安装说明

（以下命令格式均以Linux shell为例）

1. 通过Pip安装：

$ pip install you-get

检查安装是否成功：

$ you-get -V

2. 通过EasyInstall安装：

$ easy_install you-get

检查安装是否成功：

$ you-get -V

3. 从Git安装：

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

在不安装的情况下直接使用脚本：

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

若要将Python package安装到系统默认路径，执行：

$ make install

或：（适用于Windows）

> setup.py install

检查安装是否成功：

$ you-get -V

4. 直接下载（从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

在不安装的情况下直接使用脚本：

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

若要将Python package安装到系统默认路径，执行：

$ make install

或：（适用于Windows）

> setup.py install

检查安装是否成功：

$ you-get -V

5. 从AUR (Arch User Repository)安装：

点击这里。

使用方法示例

如何下载视频

显示视频信息，但不进行下载（-i或--info选项）：

$ you-get -i http://www.yinyuetai.com/video/463772

下载视频：

$ you-get http://www.yinyuetai.com/video/463772

下载多个视频：

$ you-get http://www.yinyuetai.com/video/463772 http://www.yinyuetai.com/video/471500

若当前目录下已有与视频标题同名的文件，下载时会自动跳过。若有同名的.download临时文件，程序会从上次中断处开始下载。 如要强制重新下载该视频，可使用-f（--force）选项：

$ you-get -f http://www.yinyuetai.com/video/463772

-l（--playlist）选项用于下载播放列表（只对某些网站适用）：

$ you-get -l http://www.youku.com/playlist_show/id_5344313.html

注：从0.1.3以后的版本起，-l选项不再必须。You-Get可以自动识别并处理播放列表的下载。

指定视频文件的下载目录：

$ you-get -o ~/Downloads http://www.yinyuetai.com/video/463772

显示详细帮助：

$ you-get -h

如何设置代理

默认情况下，Python自动使用系统的代理配置。可以通过环境变量http_proxy来设置系统的HTTP代理。

-x（--http-proxy）选项用于手动指定You-Get所使用的HTTP代理。例如：GoAgent的代理服务器是http://127.0.0.1:8087，则通过该代理下载某YouTube视频的命令是：

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

Windows下的自由门等翻墙软件会自动设置系统全局代理，因此无需指定HTTP代理即可下载YouTube视频：

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

如果不希望程序在下载过程中使用任何代理（包括系统的代理配置），可以显式地指定--no-proxy选项：

$ you-get --no-proxy http://v.youku.com/v_show/id_XMjI0ODc1NTc2.html

断点续传

下载未完成时被中止（因为Ctrl+C终止程序或者网络中断等原因），在目标路径中会有一个扩展名为.download的临时文件。

下次运行只要在目标路径中找到相应的.download临时文件，程序会自动从中断处继续下载。（除非指定了-f选项）

使用Python 2？

优酷等国内视频网站的下载，请移步：iambus/youku-lixian

YouTube等国外视频网站的下载，请移步：rg3/youtube-dl

许可证

You-Get在MIT License下发布。