9.9 KiB
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
- 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
- PPTV http://www.pptv.com
- Sina (新浪视频) http://video.sina.com.cn
- Sohu (搜狐视频) http://tv.sohu.com
- 56 (56网) http://www.56.com
Supported Video Formats
- WebM (*.webm)
- MP4 (*.mp4)
- FLV (*.flv)
- 3GP (*.3gp)
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. 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
4. 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
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
- 优酷 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
- PPTV http://www.pptv.com
- 新浪视频 http://video.sina.com.cn
- 搜狐视频 http://tv.sohu.com
- 56网 http://www.56.com
输出视频格式
- WebM (*.webm)
- MP4 (*.mp4)
- FLV (*.flv)
- 3GP (*.3gp)
对于YouTube，程序将下载画质最高的编码格式。
安装说明
（以下命令格式均以Linux shell为例）
1. 通过Pip安装:
$ pip install you-get
检查安装是否成功：
$ you-get -V
2. 通过EasyInstall安装：
$ easy_install you-get
检查安装是否成功：
$ you-get -V
3. 直接下载（从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
4. 从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
使用方法示例
如何下载视频
显示视频信息，但不进行下载（-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下发布。