mirror of
https://github.com/soimort/you-get.git
synced 2025-03-13 03:17:44 +03:00
update README.md: move zh-CN document to wiki
This commit is contained in:
Mort Yao
parent
53aec49f85
commit
117e03cdc8
227
README.md
227
README.md
@ -6,6 +6,8 @@
|
|||||||
|
|
||||||
See the project homepage <http://www.soimort.org/you-get> for further documentation.
|
See the project homepage <http://www.soimort.org/you-get> for further documentation.
|
||||||
|
|
||||||
|
中文说明：请参见[wiki](https://github.com/soimort/you-get/wiki/%E4%B8%AD%E6%96%87%E8%AF%B4%E6%98%8E)。
|
||||||
|
|
||||||
Fork me on GitHub: <https://github.com/soimort/you-get>
|
Fork me on GitHub: <https://github.com/soimort/you-get>
|
||||||
|
|
||||||
## Features
|
## Features
|
||||||
@ -206,228 +208,3 @@ You-Get is licensed under the [MIT license](https://raw.github.com/soimort/you-g
|
|||||||
## Contributing
|
## Contributing
|
||||||
|
|
||||||
Please see [CONTRIBUTING.md](https://github.com/soimort/you-get/blob/master/CONTRIBUTING.md).
|
Please see [CONTRIBUTING.md](https://github.com/soimort/you-get/blob/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的。
|
|
||||||
|
|
||||||
项目主页：<http://www.soimort.org/you-get>
|
|
||||||
|
|
||||||
GitHub地址：<https://github.com/soimort/you-get>
|
|
||||||
|
|
||||||
## 特点
|
|
||||||
|
|
||||||
### 说明
|
|
||||||
|
|
||||||
You-Get基于优酷下载脚本[iambus/youku-lixian](https://github.com/iambus/youku-lixian)用Python 3改写而成，增加了以下功能：
|
|
||||||
|
|
||||||
* 支持YouTube、Vimeo等国外视频网站
|
|
||||||
* 支持断点续传
|
|
||||||
* 可设置HTTP代理
|
|
||||||
|
|
||||||
### 支持的站点（截至目前）
|
|
||||||
|
|
||||||
已实现对以下站点的支持，以后会陆续增加（・∀・）
|
|
||||||
|
|
||||||
* 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>
|
|
||||||
* 优酷 <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://douban.com>
|
|
||||||
* 凤凰视频 <http://v.ifeng.com>
|
|
||||||
* 爱奇艺 <http://www.iqiyi.com>
|
|
||||||
* 激动网 <http://www.joy.cn>
|
|
||||||
* 酷6网 <http://www.ku6.com>
|
|
||||||
* MioMio <http://www.miomio.tv>
|
|
||||||
* 网易视频 <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>
|
|
||||||
* 5sing <http://www.5sing.com>
|
|
||||||
* 百度音乐 <http://music.baidu.com>
|
|
||||||
* 百度网盘 <http://pan.baidu.com>
|
|
||||||
* SongTaste <http://www.songtaste.com>
|
|
||||||
* Alive.in.th <http://alive.in.th>
|
|
||||||
|
|
||||||
## 依赖
|
|
||||||
|
|
||||||
* [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
|
|
||||||
|
|
||||||
检查安装是否成功：
|
|
||||||
|
|
||||||
$ 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
|
|
||||||
|
|
||||||
检查安装是否成功：
|
|
||||||
|
|
||||||
$ you-get -V
|
|
||||||
|
|
||||||
### 5. 从[AUR (Arch User Repository)](http://aur.archlinux.org/)安装：
|
|
||||||
|
|
||||||
点击[这里](https://aur.archlinux.org/packages.php\?ID=62576)。
|
|
||||||
|
|
||||||
### 升级：
|
|
||||||
|
|
||||||
使用Pip：
|
|
||||||
|
|
||||||
$ pip install --upgrade you-get
|
|
||||||
|
|
||||||
### FAQ（针对Windows用户)：
|
|
||||||
|
|
||||||
* Q：我不知道该如何在Windows下安装。
|
|
||||||
|
|
||||||
* A：不需要安装。直接把`you-get`目录放到系统`%PATH%`中。
|
|
||||||
|
|
||||||
* Q：出现错误提示`UnicodeDecodeError: 'gbk' codec can't decode byte 0xb0 in position 1012: illegal multibyte sequence`。
|
|
||||||
|
|
||||||
* A：执行`set PYTHONIOENCODING=utf-8`。
|
|
||||||
|
|
||||||
## 使用方法示例
|
|
||||||
|
|
||||||
### 如何下载视频
|
|
||||||
|
|
||||||
显示视频信息，但不进行下载（`-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://github.com/soimort/you-get/blob/master/CONTRIBUTING.md)。
|
|
||||||
|
|||||||
Loading…
x
Reference in New Issue
Block a user