# You-Get [![Build Status](https://api.travis-ci.org/soimort/you-get.png)](https://travis-ci.org/soimort/you-get) [You-Get](https://github.com/soimort/you-get) is a video downloader runs on Python 3. It aims at easing the download of videos on [YouTube](http://www.youtube.com), [Youku](http://www.youku.com)/[Tudou](http://www.tudou.com) (biggest online video providers in China), [ Niconico](http://www.nicovideo.jp), etc., in one script. See the project homepage for further documentation. Fork me on GitHub: ## Features ### Supported Sites (As of Now) * YouTube * Vimeo * Dailymotion * Facebook * Google+ * Tumblr * SoundCloud * Mixcloud * JPopsuki * Niconico (ニコニコ動画) * Youku (优酷) * Tudou (土豆) * YinYueTai (音悦台) * AcFun * bilibili * CNTV (中国网络电视台) * Douban (豆瓣) * ifeng (凤凰视频) * iQIYI (爱奇艺) * Joy.cn (激动网) * Ku6 (酷6网) * MioMio * NetEase (网易视频) * PPTV * QQ (腾讯视频) * Sina (新浪视频) * Sohu (搜狐视频) * 56 (56网) * Xiami (虾米) ## Dependencies * [Python 3](http://www.python.org/download/releases/) * __(Optional)__ [FFmpeg](http://ffmpeg.org) * Used for converting and joining video files. ## Installation ### 1. Install via [Pip](http://www.pip-installer.org/): $ pip install you-get Check if the installation was successful: $ you-get -V ### 2. Install via [EasyInstall](http://pypi.python.org/pypi/setuptools): $ 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 ): $ 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)](http://aur.archlinux.org/): Click [here](https://aur.archlinux.org/packages.php\?ID=62576). ## 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](https://raw.github.com/soimort/you-get/master/LICENSE.txt). ## Contributing Please see [CONTRIBUTING.md](https://raw.github.com/soimort/you-get/master/CONTRIBUTING.md). *** # You-Get - 中文说明 [You-Get](https://github.com/soimort/you-get)是一个基于Python 3的视频下载工具。之所以写它的主要原因是，我找不到一个现成的下载工具能够同时支持[YouTube](http://www.youtube.com/)和[优酷](http://www.youku.com/)；而且，几乎所有以前的视频下载程序都是基于Python 2的。 项目主页： GitHub地址： ## 特点 ### 说明 You-Get基于优酷下载脚本[iambus/youku-lixian](https://github.com/iambus/youku-lixian)用Python 3改写而成，增加了以下功能： * 支持YouTube、Vimeo等国外视频网站 * 支持断点续传 * 可设置HTTP代理 ### 支持的站点（截至目前） 已实现对以下站点的支持，以后会陆续增加（・∀・） * YouTube * Vimeo * Dailymotion * Facebook * Google+ * Tumblr * SoundCloud * Mixcloud * JPopsuki * NICONICO动画 * 优酷 * 土豆 * 音悦台 * AcFun * bilibili * CNTV * 豆瓣 * 凤凰视频 * 爱奇艺 * 激动网 * 酷6网 * MioMio * 网易视频 * PPTV * 腾讯视频 * 新浪视频 * 搜狐视频 * 56网 * 虾米 ## 依赖 * [Python 3](http://www.python.org/download/releases/) * __（可选）__ [FFmpeg](http://ffmpeg.org) * 用于转换与合并视频文件。 ## 安装说明 （以下命令格式均以Linux shell为例） ### 1. 通过[Pip](http://www.pip-installer.org/)安装： $ pip install you-get 检查安装是否成功： $ you-get -V ### 2. 通过[EasyInstall](http://pypi.python.org/pypi/setuptools)安装： $ 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. 直接下载（从）： $ 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)](http://aur.archlinux.org/)安装： 点击[这里](https://aur.archlinux.org/packages.php\?ID=62576)。 ## 使用方法示例 ### 如何下载视频 显示视频信息，但不进行下载（`-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](https://github.com/iambus/youku-lixian) YouTube等国外视频网站的下载，请移步：[rg3/youtube-dl](https://github.com/rg3/youtube-dl) ## 许可证 You-Get在[MIT License](https://raw.github.com/soimort/you-get/master/LICENSE.txt)下发布。 ## 如何参与贡献 / 报告issue 请阅读 [CONTRIBUTING.md](https://raw.github.com/soimort/you-get/master/CONTRIBUTING.md)。