2015-07-20 12:56:08 +03:00
<!-- sans mono theme (pandoc template) v0.1.1 -->
2015-07-12 11:55:47 +03:00
<!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" >
2015-07-20 12:56:08 +03:00
< meta name = "author" content = "soimort" >
< meta name = "dcterms.date" content = "2015-07-20" >
< title > You-Get< / title >
2015-07-12 11:55:47 +03:00
< 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}
2015-07-20 12:56:08 +03:00
/*! sans mono theme v0.1.1 | Public Domain */#TOC,header{position:fixed}body{width:60%;padding:5% 10%;background:ivory;font-family:Helvetica,'Liberation Sans',Arial,freesans,sans-serif}code{font-family:'Droid Sans Mono','Liberation Mono','DejaVu Sans Mono',Courier,FreeMono,monospace;font-size:.9em}a{color:maroon}header{visibility:hidden}#TOC{right:5%;width:20%;font-size:.8em}#TOC ul{padding-left:1em;list-style:none}
2015-07-12 11:55:47 +03:00
< / style >
< style type = "text/css" > code { white-space : pre ; } < / style >
<!-- [if lt IE 9]>
2015-07-20 12:56:08 +03:00
< script src = "https://html5shim.googlecode.com/svn/trunk/html5.js" > < / script >
2015-07-12 11:55:47 +03:00
<![endif]-->
< / head >
< body >
2015-07-20 12:56:08 +03:00
< header >
< h1 class = "title" > You-Get< / h1 >
< h2 class = "author" > soimort< / h2 >
< h3 class = "date" > 2015-07-20< / h3 >
< / header >
2015-07-12 11:55:47 +03:00
< 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&utm_medium=badge&utm_campaign=pr-badge&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 ' http://www.youtube.com/watch?v=sGwy8DsUJ4M' < / code > < / pre >
< p > Download a video:< / p >
< pre > < code > $ you-get ' http://www.youtube.com/watch?v=sGwy8DsUJ4M' < / code > < / pre >
< p > Download multiple videos:< / p >
< pre > < code > $ you-get ' http://www.youtube.com/watch?v=sGwy8DsUJ4M' ' http://www.youtube.com/watch?v=8bQlxQJEzLk' < / 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 ' http://www.youtube.com/watch?v=sGwy8DsUJ4M' < / code > < / pre >
< p > Set the output directory for downloaded files:< / p >
< pre > < code > $ you-get -o ~/Downloads ' http://www.youtube.com/watch?v=sGwy8DsUJ4M' < / code > < / pre >
< p > Use a specific HTTP proxy for downloading:< / p >
< pre > < code > $ you-get -x 127.0.0.1:8087 ' http://www.youtube.com/watch?v=sGwy8DsUJ4M' < / 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 ' http://www.youtube.com/watch?v=sGwy8DsUJ4M' < / 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 ' http://www.youtube.com/watch?v=sGwy8DsUJ4M' < / 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' s cookies.txt file.
-n | --no-merge Don' t merge video parts.
-F | --format < STREAM_ID> Video format code.
-o | --output-dir < PATH> Set the output directory for downloaded videos.
-p | --player < PLAYER [options]> Directly play the video with PLAYER like vlc/smplayer.
-x | --http-proxy < HOST:PORT> Use specific HTTP proxy for downloading.
-y | --extractor-proxy < HOST:PORT> Use specific HTTP proxy for extracting stream data.
--no-proxy Don' 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 >
