PublicMirrors/you-get
1
0
Fork 0
mirror of https://github.com/soimort/you-get.git synced 2025-01-23 05:25:02 +03:00
Code Issues Actions Packages Projects Releases 1 Wiki Activity

Initial commit

Browse Source
This commit is contained in:
Mort Yao 2015-07-12 16:55:47 +08:00
commit d5c02164a6
3 changed files with 231 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

0
.nojekyll Normal file
View File

1
CNAME Normal file
View File

@ -0,0 +1 @@
you-get.org

230
README.html Normal file
View File

@ -0,0 +1,230 @@
<!-- sans mono theme (pandoc template) v0.1.0 -->
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<meta name="generator" content="pandoc">
<meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=yes">
<title></title>
<style type="text/css">
/*! normalize.css v3.0.3 | MIT License | github.com/necolas/normalize.css */html{font-family:sans-serif;-ms-text-size-adjust:100%;-webkit-text-size-adjust:100%}body{margin:0}article,aside,details,figcaption,figure,footer,header,hgroup,main,menu,nav,section,summary{display:block}audio,canvas,progress,video{display:inline-block;vertical-align:baseline}audio:not([controls]){display:none;height:0}[hidden],template{display:none}a{background-color:transparent}a:active,a:hover{outline:0}abbr[title]{border-bottom:1px dotted}b,strong{font-weight:700}dfn{font-style:italic}h1{font-size:2em;margin:.67em 0}mark{background:#ff0;color:#000}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sup{top:-.5em}sub{bottom:-.25em}img{border:0}svg:not(:root){overflow:hidden}figure{margin:1em 40px}hr{box-sizing:content-box;height:0}pre{overflow:auto}code,kbd,pre,samp{font-family:monospace,monospace;font-size:1em}button,input,optgroup,select,textarea{color:inherit;font:inherit;margin:0}button{overflow:visible}button,select{text-transform:none}button,html input[type=button],input[type=reset],input[type=submit]{-webkit-appearance:button;cursor:pointer}button[disabled],html input[disabled]{cursor:default}button::-moz-focus-inner,input::-moz-focus-inner{border:0;padding:0}input{line-height:normal}input[type=checkbox],input[type=radio]{box-sizing:border-box;padding:0}input[type=number]::-webkit-inner-spin-button,input[type=number]::-webkit-outer-spin-button{height:auto}input[type=search]{-webkit-appearance:textfield;box-sizing:content-box}input[type=search]::-webkit-search-cancel-button,input[type=search]::-webkit-search-decoration{-webkit-appearance:none}fieldset{border:1px solid silver;margin:0 2px;padding:.35em .625em .75em}legend{border:0;padding:0}textarea{overflow:auto}optgroup{font-weight:700}table{border-collapse:collapse;border-spacing:0}td,th{padding:0}
/*! sans mono theme v0.1.0 | Public Domain */body{width:60%;padding:5% 10%;background:ivory;font-family:Helvetica,'Liberation Sans',Arial,freesans,sans-serif}code{font-size:.9em;font-family:Consolas,'Liberation Mono','Droid Sans Mono','DejaVu Sans Mono',Courier,freemono,monospace}a{color:maroon}#TOC{position:fixed;width:20%;right:5%;font-size:.8em}#TOC ul{list-style:none;padding-left:1em}
</style>
<style type="text/css">code{white-space: pre;}</style>
<!--[if lt IE 9]>
<script src="http://html5shim.googlecode.com/svn/trunk/html5.js"></script>
<![endif]-->
</head>
<body>
<nav id="TOC">
<ul>
<li><a href="#you-get">You-Get</a><ul>
<li><a href="#features">Features</a><ul>
<li><a href="#supported-sites">Supported Sites</a></li>
</ul></li>
<li><a href="#prerequisites">Prerequisites</a><ul>
<li><a href="#python-3">Python 3</a></li>
<li><a href="#dependencies-optional-but-recommended">Dependencies (Optional but Recommended)</a></li>
</ul></li>
<li><a href="#installation">Installation</a><ul>
<li><a href="#using-pip-standard-method">1. Using Pip (Standard Method)</a></li>
<li><a href="#downloading-from-pypi">2. Downloading from PyPI</a></li>
<li><a href="#downloading-from-github">3. Downloading from GitHub</a></li>
<li><a href="#using-git-recommended-for-developers-and-advanced-users">4. Using Git (Recommended for Developers and Advanced Users)</a></li>
</ul></li>
<li><a href="#upgrading">Upgrading</a><ul>
<li><a href="#using-pip">1. Using Pip</a></li>
</ul></li>
<li><a href="#getting-started">Getting Started</a></li>
<li><a href="#faq">FAQ</a></li>
<li><a href="#command-line-options">Command-Line Options</a></li>
<li><a href="#license">License</a></li>
<li><a href="#reporting-an-issue-contributing">Reporting an Issue / Contributing</a></li>
</ul></li>
</ul>
</nav>
<h1 id="you-get">You-Get</h1>
<p><a href="https://travis-ci.org/soimort/you-get"><img src="https://api.travis-ci.org/soimort/you-get.png" alt="Build Status" /></a> <a href="http://badge.fury.io/py/you-get"><img src="https://badge.fury.io/py/you-get.png" alt="PyPI version" /></a> <a href="https://gitter.im/soimort/you-get?utm_source=badge&amp;utm_medium=badge&amp;utm_campaign=pr-badge&amp;utm_content=badge"><img src="https://badges.gitter.im/Join%20Chat.svg" alt="Gitter" /></a></p>
<p><a href="http://www.soimort.org/you-get">You-Get</a> is a video downloader for <a href="http://www.youtube.com">YouTube</a>, <a href="http://www.youku.com">Youku</a>, <a href="http://www.nicovideo.jp">niconico</a> and a few other sites.</p>
<p><code>you-get</code> is a command-line program, written completely in Python 3. Its prospective users are those who prefer CLI over GUI. With <code>you-get</code>, downloading a video is just one command away:</p>
<pre><code>$ you-get http://youtu.be/sGwy8DsUJ4M</code></pre>
<p>Fork me on GitHub: <a href="https://github.com/soimort/you-get" class="uri">https://github.com/soimort/you-get</a></p>
<h2 id="features">Features</h2>
<h3 id="supported-sites">Supported Sites</h3>
<ul>
<li>Dailymotion <a href="http://dailymotion.com" class="uri">http://dailymotion.com</a></li>
<li>Freesound <a href="http://www.freesound.org" class="uri">http://www.freesound.org</a></li>
<li>Google+ <a href="http://plus.google.com" class="uri">http://plus.google.com</a></li>
<li>Instagram <a href="http://instagram.com" class="uri">http://instagram.com</a></li>
<li>JPopsuki <a href="http://jpopsuki.tv" class="uri">http://jpopsuki.tv</a></li>
<li>Magisto <a href="http://www.magisto.com" class="uri">http://www.magisto.com</a></li>
<li>Mixcloud <a href="http://www.mixcloud.com" class="uri">http://www.mixcloud.com</a></li>
<li>Niconico (ニコニコ動画) <a href="http://www.nicovideo.jp" class="uri">http://www.nicovideo.jp</a></li>
<li>Vimeo <a href="http://vimeo.com" class="uri">http://vimeo.com</a></li>
<li>Vine <a href="http://vine.co" class="uri">http://vine.co</a></li>
<li>Twitter <a href="http://twitter.com" class="uri">http://twitter.com</a></li>
<li>Youku (优酷) <a href="http://www.youku.com" class="uri">http://www.youku.com</a></li>
<li>YouTube <a href="http://www.youtube.com" class="uri">http://www.youtube.com</a></li>
<li>AcFun <a href="http://www.acfun.tv" class="uri">http://www.acfun.tv</a></li>
<li>Alive.in.th <a href="http://alive.in.th" class="uri">http://alive.in.th</a></li>
<li>Baidu Music (百度音乐) <a href="http://music.baidu.com" class="uri">http://music.baidu.com</a></li>
<li>Baidu Wangpan (百度网盘) <a href="http://pan.baidu.com" class="uri">http://pan.baidu.com</a></li>
<li>Baomihua (爆米花) <a href="http://video.baomihua.com" class="uri">http://video.baomihua.com</a></li>
<li>bilibili <a href="http://www.bilibili.com" class="uri">http://www.bilibili.com</a></li>
<li>Blip <a href="http://blip.tv" class="uri">http://blip.tv</a></li>
<li>Catfun (喵星球) <a href="http://www.catfun.tv" class="uri">http://www.catfun.tv</a></li>
<li>CBS <a href="http://www.cbs.com" class="uri">http://www.cbs.com</a></li>
<li>CNTV (中国网络电视台) <a href="http://www.cntv.cn" class="uri">http://www.cntv.cn</a></li>
<li>Coursera <a href="https://www.coursera.org" class="uri">https://www.coursera.org</a></li>
<li>Dongting (天天动听) <a href="http://www.dongting.com" class="uri">http://www.dongting.com</a></li>
<li>Douban (豆瓣) <a href="http://douban.com" class="uri">http://douban.com</a></li>
<li>DouyuTV (斗鱼) <a href="http://www.douyutv.com" class="uri">http://www.douyutv.com</a></li>
<li>eHow <a href="http://www.ehow.com" class="uri">http://www.ehow.com</a></li>
<li>Facebook <a href="http://facebook.com" class="uri">http://facebook.com</a></li>
<li>Google Drive <a href="http://docs.google.com" class="uri">http://docs.google.com</a></li>
<li>ifeng (凤凰视频) <a href="http://v.ifeng.com" class="uri">http://v.ifeng.com</a></li>
<li>iQIYI (爱奇艺) <a href="http://www.iqiyi.com" class="uri">http://www.iqiyi.com</a></li>
<li>Joy.cn (激动网) <a href="http://www.joy.cn" class="uri">http://www.joy.cn</a></li>
<li>Khan Academy <a href="http://www.khanacademy.org" class="uri">http://www.khanacademy.org</a></li>
<li>Ku6 (酷6网) <a href="http://www.ku6.com" class="uri">http://www.ku6.com</a></li>
<li>Kugou (酷狗音乐) <a href="http://www.kugou.com" class="uri">http://www.kugou.com</a></li>
<li>Kuwo (酷我音乐) <a href="http://www.kuwo.cn" class="uri">http://www.kuwo.cn</a></li>
<li>LeTV (乐视网) <a href="http://www.letv.com" class="uri">http://www.letv.com</a></li>
<li>Lizhi.fm (荔枝FM) <a href="http://www.lizhi.fm" class="uri">http://www.lizhi.fm</a></li>
<li>MioMio <a href="http://www.miomio.tv" class="uri">http://www.miomio.tv</a></li>
<li>MTV 81 <a href="http://www.mtv81.com" class="uri">http://www.mtv81.com</a></li>
<li>NetEase (网易视频) <a href="http://v.163.com" class="uri">http://v.163.com</a></li>
<li>NetEase Music (网易云音乐) <a href="http://music.163.com" class="uri">http://music.163.com</a></li>
<li>PPTV <a href="http://www.pptv.com" class="uri">http://www.pptv.com</a></li>
<li>QQ (腾讯视频) <a href="http://v.qq.com" class="uri">http://v.qq.com</a></li>
<li>Sina (新浪视频) <a href="http://video.sina.com.cn" class="uri">http://video.sina.com.cn</a></li>
<li>Sohu (搜狐视频) <a href="http://tv.sohu.com" class="uri">http://tv.sohu.com</a></li>
<li>SongTaste <a href="http://www.songtaste.com" class="uri">http://www.songtaste.com</a></li>
<li>SoundCloud <a href="http://soundcloud.com" class="uri">http://soundcloud.com</a></li>
<li>TED <a href="http://www.ted.com" class="uri">http://www.ted.com</a></li>
<li>Tudou (土豆) <a href="http://www.tudou.com" class="uri">http://www.tudou.com</a></li>
<li>Tumblr <a href="http://www.tumblr.com" class="uri">http://www.tumblr.com</a></li>
<li>VID48 <a href="http://vid48.com" class="uri">http://vid48.com</a></li>
<li>VideoBam <a href="http://videobam.com" class="uri">http://videobam.com</a></li>
<li>VK <a href="http://vk.com" class="uri">http://vk.com</a></li>
<li>56 (56网) <a href="http://www.56.com" class="uri">http://www.56.com</a></li>
<li>Xiami (虾米) <a href="http://www.xiami.com" class="uri">http://www.xiami.com</a></li>
<li>YinYueTai (音悦台) <a href="http://www.yinyuetai.com" class="uri">http://www.yinyuetai.com</a></li>
<li>Zhanqi (战旗TV) <a href="http://www.zhanqi.tv/lives" class="uri">http://www.zhanqi.tv/lives</a></li>
</ul>
<h2 id="prerequisites">Prerequisites</h2>
<h3 id="python-3">Python 3</h3>
<p><code>you-get</code> is known to work with:</p>
<ul>
<li>Python 3.2</li>
<li>Python 3.3</li>
<li>Python 3.4</li>
<li>PyPy3</li>
</ul>
<p><code>you-get</code> does not (and will never) work with Python 2.x.</p>
<h3 id="dependencies-optional-but-recommended">Dependencies (Optional but Recommended)</h3>
<ul>
<li><a href="http://ffmpeg.org">FFmpeg</a> or <a href="http://libav.org/">Libav</a>
<ul>
<li>For video and audio processing.</li>
</ul></li>
<li><a href="http://rtmpdump.mplayerhq.hu/">RTMPDump</a>
<ul>
<li>For RTMP stream processing.</li>
</ul></li>
</ul>
<h2 id="installation">Installation</h2>
<p>You don't have to learn the Python programming language to use this tool. However, you need to make sure that Python 3 (with pip) is installed on your system.</p>
<p>On Linux and BSD, installation made easy with your package manager:</p>
<ul>
<li>Find and install packages: <code>python3</code> and <code>python3-pip</code> (if your distro did not make Python 3 the default, e.g., Debian)</li>
<li>Or packages: <code>python</code> and <code>python-pip</code> (if your distro made Python 3 the default, e.g., Arch)</li>
</ul>
<p>On other systems (which tend to have quite evil user experience), please read the documentation and ask Google for help:</p>
<ul>
<li><a href="https://www.python.org/downloads/" class="uri">https://www.python.org/downloads/</a></li>
<li><a href="https://pip.pypa.io/en/latest/installing.html" class="uri">https://pip.pypa.io/en/latest/installing.html</a></li>
</ul>
<h3 id="using-pip-standard-method">1. Using Pip (Standard Method)</h3>
<pre><code>$ [sudo] pip3 install you-get</code></pre>
<p>Check if the installation is successful:</p>
<pre><code>$ you-get -V</code></pre>
<h3 id="downloading-from-pypi">2. Downloading from PyPI</h3>
<p>You can also download the Python wheel for each release from <a href="https://pypi.python.org/pypi/you-get">PyPI</a>.</p>
<p>If you choose to download the wheel from a PyPI mirror or elsewhere, remember to verify the signature of the package. For example:</p>
<pre><code>$ gpg --verify you_get-0.3.30-py3-none-any.whl.asc you_get-0.3.30-py3-none-any.whl</code></pre>
<h3 id="downloading-from-github">3. Downloading from GitHub</h3>
<p>Download it <a href="https://github.com/soimort/you-get/zipball/master">here</a> or:</p>
<pre><code>$ wget -O you-get.zip https://github.com/soimort/you-get/zipball/master
$ unzip you-get.zip</code></pre>
<p>Use the raw script without installation:</p>
<pre><code>$ cd soimort-you-get-*/
$ ./you-get -V</code></pre>
<p>To install the package into the system path, execute:</p>
<pre><code>$ [sudo] make install</code></pre>
<p>Check if the installation is successful:</p>
<pre><code>$ you-get -V</code></pre>
<h3 id="using-git-recommended-for-developers-and-advanced-users">4. Using Git (Recommended for Developers and Advanced Users)</h3>
<pre><code>$ git clone git://github.com/soimort/you-get.git</code></pre>
<p>Use the raw script without installation:</p>
<pre><code>$ cd you-get/
$ ./you-get -V</code></pre>
<p>To install the package into the system path, execute:</p>
<pre><code>$ [sudo] make install</code></pre>
<p>Check if the installation is successful:</p>
<pre><code>$ you-get -V</code></pre>
<h2 id="upgrading">Upgrading</h2>
<h3 id="using-pip">1. Using Pip</h3>
<pre><code>$ [sudo] pip3 install --upgrade you-get</code></pre>
<h2 id="getting-started">Getting Started</h2>
<p>Display the information of a video without downloading:</p>
<pre><code>$ you-get -i &#39;http://www.youtube.com/watch?v=sGwy8DsUJ4M&#39;</code></pre>
<p>Download a video:</p>
<pre><code>$ you-get &#39;http://www.youtube.com/watch?v=sGwy8DsUJ4M&#39;</code></pre>
<p>Download multiple videos:</p>
<pre><code>$ you-get &#39;http://www.youtube.com/watch?v=sGwy8DsUJ4M&#39; &#39;http://www.youtube.com/watch?v=8bQlxQJEzLk&#39;</code></pre>
<p>By default, program will skip any video that already exists in the local directory when downloading. If a temporary file (ends with a <code>.download</code> extension in its file name) is found, program will resume the download from last session.</p>
<p>To enforce re-downloading of videos, use option <code>-f</code>: (this will overwrite any existing video or temporary file)</p>
<pre><code>$ you-get -f &#39;http://www.youtube.com/watch?v=sGwy8DsUJ4M&#39;</code></pre>
<p>Set the output directory for downloaded files:</p>
<pre><code>$ you-get -o ~/Downloads &#39;http://www.youtube.com/watch?v=sGwy8DsUJ4M&#39;</code></pre>
<p>Use a specific HTTP proxy for downloading:</p>
<pre><code>$ you-get -x 127.0.0.1:8087 &#39;http://www.youtube.com/watch?v=sGwy8DsUJ4M&#39;</code></pre>
<p>By default, the system proxy setting (i.e. environment variable <code>http_proxy</code> on *nix) is applied. To disable any proxy, use option <code>--no-proxy</code>:</p>
<pre><code>$ you-get --no-proxy &#39;http://www.youtube.com/watch?v=sGwy8DsUJ4M&#39;</code></pre>
<p>Watch a video in your media player of choice: (this is just a trick to let you get rid of annoying ads on the video site)</p>
<pre><code>$ you-get -p vlc &#39;http://www.youtube.com/watch?v=sGwy8DsUJ4M&#39;</code></pre>
<h2 id="faq">FAQ</h2>
<p><strong>Q</strong>: Some videos on Youku are restricted to mainland China visitors. Is it possible to bypass this restriction and download those videos?</p>
<p><strong>A</strong>: Thanks to <a href="https://github.com/zhuzhuor/Unblock-Youku">Unblock Youku</a>, it is now possible to access such videos from an oversea IP address. You can simply use <code>you-get</code> with option <code>-y proxy.uku.im:8888</code>.</p>
<p><strong>Q</strong>: Will you release an executable version / Windows Installer package?</p>
<p><strong>A</strong>: Yes, it's on my to-do list.</p>
<h2 id="command-line-options">Command-Line Options</h2>
<p>For a complete list of available options, see:</p>
<pre><code>$ you-get --help
Usage: you-get [OPTION]... [URL]...
Startup options:
-V | --version Display the version and exit.
-h | --help Print this help and exit.
Download options (use with URLs):
-f | --force Force overwriting existed files.
-i | --info Display the information of videos without downloading.
-u | --url Display the real URLs of videos without downloading.
-c | --cookies Load NetScape&#39;s cookies.txt file.
-n | --no-merge Don&#39;t merge video parts.
-F | --format &lt;STREAM_ID&gt; Video format code.
-o | --output-dir &lt;PATH&gt; Set the output directory for downloaded videos.
-p | --player &lt;PLAYER [options]&gt; Directly play the video with PLAYER like vlc/smplayer.
-x | --http-proxy &lt;HOST:PORT&gt; Use specific HTTP proxy for downloading.
-y | --extractor-proxy &lt;HOST:PORT&gt; Use specific HTTP proxy for extracting stream data.
--no-proxy Don&#39;t use any proxy. (ignore $http_proxy)
--debug Show traceback on KeyboardInterrupt.</code></pre>
<h2 id="license">License</h2>
<p>You-Get is licensed under the <a href="https://raw.github.com/soimort/you-get/master/LICENSE.txt">MIT license</a>.</p>
<h2 id="reporting-an-issue-contributing">Reporting an Issue / Contributing</h2>
<p>Please read <a href="https://github.com/soimort/you-get/blob/master/CONTRIBUTING.md">CONTRIBUTING.md</a> first.</p>
<a href="https://github.com/soimort/you-get"><img style="position: fixed; top: 0; right: 0; border: 0;" src="https://camo.githubusercontent.com/365986a132ccd6a44c23a9169022c0b5c890c387/68747470733a2f2f73332e616d617a6f6e6177732e636f6d2f6769746875622f726962626f6e732f666f726b6d655f72696768745f7265645f6161303030302e706e67" alt="Fork me on GitHub" data-canonical-src="https://s3.amazonaws.com/github/ribbons/forkme_right_red_aa0000.png"></a>
</body>
</html>