Skip to main content

A YouTube/Youku video downloader written in Python 3.

Project description

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), 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

Installation
------------

#) Install via `Pip <http://www.pip-installer.org/>`_::

$ pip install you-get

Check if the installation was successful::

$ you-get -V

#) Install via `EasyInstall <http://pypi.python.org/pypi/setuptools>`_::

$ easy_install you-get

Check if the installation was successful::

$ you-get -V

#) 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

#) 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

#) Install from `AUR <http://aur.archlinux.org/>`_ (Arch User Repository)::

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)::

>>> 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 <https://raw.github.com/soimort/you-get/master/LICENSE.txt>`_.


Changelog
=========

0.2.3
-----

*Date: 2012-09-18*

* Use FFmpeg for converting and joining of videos.
* Add '--url' and '--debug' options.

0.2.2
-----

*Date: 2012-09-17*

* Add danmaku support for AcFun and bilibili.
* Fix issue `#2 <https://github.com/soimort/you-get/issues/2>`_ and `#4 <https://github.com/soimort/you-get/issues/4>`_ for YouTube.
* Temporarily fix issue for iQIYI (use .ts instead of .f4v).

0.2.1
-----

*Date: 2012-09-02*

* Add support for:
- ifeng

0.2
---

*Date: 2012-09-02*

* Add support for:
- Vimeo
- AcFun
- bilibili
- CNTV
- iQIYI
- Ku6
- PPTV
- Sina
- Sohu
- 56

0.1.3
-----

*Date: 2012-09-01*

* Playlist URLs are now automatically handled. ('--playlist' option is no longer needed)
* Handle KeyboardInterrupt silently.
* Fix Unicode character display on code pages.

0.1
---

*Date: 2012-09-01*

* First PyPI release.
* Fix issue `#1 <https://github.com/soimort/you-get/issues/1>`_.

0.0.1
-----

*Date: 2012-08-21*

* Initial release, forked from `iambus/youku-lixian <https://github.com/iambus/youku-lixian>`_; add:
- YouTube support.
- Pausing and resuming of downloads.
- HTTP proxy settings.

Project details


Release history Release notifications

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
you_get-0.2.3-py3.2.egg (108.2 kB) Copy SHA256 hash SHA256 Egg 3.2
you-get-0.2.3.tar.gz (29.4 kB) Copy SHA256 hash SHA256 Source None

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page