Skip to main content
Help us improve Python packaging – donate today!

A YouTube/Youku/Niconico video downloader written in Python 3.

Project Description

You-Get

https://api.travis-ci.org/soimort/you-get.png https://badge.fury.io/py/you-get.png

You-Get is a video downloader runs on Python 3. It aims at easing the download of videos on YouTube, Youku/Tudou (biggest online video providers in China), Niconico, 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)

Dependencies

  • Python 3
  • (Optional) FFmpeg
    • Used for converting and joining video files.

Installation

  1. Install via Pip:

    $ pip install you-get
    

    Check if the installation was successful:

    $ you-get -V
    
  2. Install via EasyInstall:

    $ 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
    

    Check if the installation was successful:

    $ you-get -V
    
  4. Direct download:

    $ 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
    

    Check if the installation was successful:

    $ you-get -V
    
  5. Install from AUR (Arch User Repository):

    Click here.

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.

Contributing

Please see CONTRIBUTING.md.

Changelog

0.3.22

Date: 2013-10-18

  • Fix issues for:
    • Baidu
    • Bilibili
    • JPopsuki TV
    • Niconico
    • PPTV
    • TED
    • Tumblr
    • YinYueTai
    • YouTube

0.3.21

Date: 2013-08-17

  • Fix issues for:
    • YouTube
    • YinYueTai
    • pan.baidu.com

0.3.20

Date: 2013-08-16

  • Add support for:
    • eHow
    • Khan Academy
    • TED
    • 5sing
  • Fix issues for:
    • Tudou

0.3.18

Date: 2013-07-19

  • Fix issues for:
    • Dailymotion
    • Youku
    • Sina
    • AcFun
    • bilibili

0.3.17

Date: 2013-07-12

  • Fix issues for:
    • YouTube
    • 163
    • bilibili
  • Code cleanup.

0.3.16

Date: 2013-06-28

  • Fix issues for:
    • YouTube
    • Sohu
    • Google+ (enable HTTPS proxy)

0.3.15

Date: 2013-06-21

  • Add support for:
    • Instagram

0.3.14

Date: 2013-06-14

  • Add support for:
    • Alive.in.th
  • Remove support of:
    • JPopsuki
  • Fix issues for:
    • AcFun
    • iQIYI

0.3.13

Date: 2013-06-07

  • Add support for:
    • Baidu Wangpan (video only)
  • Fix issue for:
    • Google+

0.3.12

Date: 2013-05-19

  • Fix issues for:
    • Google+
    • Mixcloud
    • Tudou

0.3.11

Date: 2013-04-26

  • Add support for:
    • Google Drive (Google Docs)

0.3.10

Date: 2013-04-19

  • Add support for:
    • SongTaste
  • Support Libav as well as FFmpeg.

0.3.9

Date: 2013-04-12

  • Add support for:
    • Freesound

0.3.8

Date: 2013-04-05

  • Add support for:
    • Coursera

0.3.7

Date: 2013-03-29

  • Add support for:
    • Baidu

0.3.6

Date: 2013-03-22

  • Add support for:
    • Vine
  • Fix issue for:
    • YouTube

0.3.5

Date: 2013-03-15

  • Default to use FFmpeg for merging .flv files.

0.3.4

Date: 2013-03-08

  • Add support for:
    • Blip
    • VID48

0.3.3

Date: 2013-03-01

  • Add support for:
    • Douban
    • MioMio
  • Fix issues for:
    • Tudou
    • Vimeo

0.3.2

Date: 2013-02-22

  • Add support for:
    • JPopsuki
  • Fix issue for Xiami.

0.3.1

Date: 2013-02-15

  • Fix issues for Google+ and Mixcloud.
  • API changed.

0.3.0

Date: 2013-02-08

  • Add support for:
    • Niconico

0.3dev-20130201

Date: 2013-02-01

  • Add support for:
    • Mixcloud
    • Facebook
    • Joy.cn

0.3dev-20130125

Date: 2013-01-25

  • Dailymotion: downloading best quality available now.
  • iQIYI: fix #77.

0.3dev-20130118

Date: 2013-01-18

  • YinYueTai: downloading best quality available now.
  • Sohu: fix #69.

0.3dev-20130111

Date: 2013-01-11

  • Add support for:
    • NetEase (v.163.com)
    • YouTube short URLs
  • Vimeo: downloading best quality available now.

0.3dev-20130104

Date: 2013-01-04

  • Sohu:
    • fix #53.
    • merge pull request #54; downloading best quality available now.

0.3dev-20121228

Date: 2012-12-28

  • Add support for:
    • Xiami
    • Tumblr audios

0.3dev-20121221

Date: 2012-12-21

  • YouTube: fix #45.
  • Merge pull request #46; fix title parsing issue on Tudou.

0.3dev-20121220

Date: 2012-12-20

  • YouTube: quick dirty fix to #45.

0.3dev-20121219

Date: 2012-12-19

  • Add support for:
    • Tumblr

0.3dev-20121217

Date: 2012-12-17

  • Google+: downloading best quality available now.
  • Fix issues #42, #43 for Google+.
  • Merge pull request #40; fix some issues for Ku6, Sina and 56.

0.3dev-20121212

Date: 2012-12-12

  • YouTube: fix some major issues on parsing video titles.

0.3dev-20121210

Date: 2012-12-10

  • YouTube: downloading best quality available now.
  • Add support for:
    • SoundCloud

0.2.16

Date: 2012-12-01

  • Add support for:
    • QQ
  • Small fixes merged from youku-lixian.

0.2.15

Date: 2012-11-30

  • Fix issue #30 for bilibili.

0.2.14

Date: 2012-11-29

  • Fix issue #28 for Tudou.
  • Better support for AcFun.

0.2.13

Date: 2012-10-30

  • Nothing new.

0.2.12

Date: 2012-10-30

  • Fix issue #20 for AcFun.

0.2.11

Date: 2012-10-23

  • Move on to Python 3.3!
  • Fix issues:

0.2.10

Date: 2012-10-16

  • Add support for:
    • Google+

0.2.9

Date: 2012-10-09

  • Fix issue #16.

0.2.8

Date: 2012-10-02

  • Fix issue #15 for AcFun.

0.2.7

Date: 2012-09-28

  • Fix issue #6 for YouTube.

0.2.6

Date: 2012-09-26

  • Fix issue #5 for YinYueTai.

0.2.5

Date: 2012-09-25

  • Add support for:
    • Dailymotion

0.2.4

Date: 2012-09-18

  • Use FFmpeg for converting and joining video files.
  • Add ‘–url’ and ‘–debug’ options.

0.2.2

Date: 2012-09-17

  • Add danmaku support for AcFun and bilibili.
  • Fix issue #2 and #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.

0.0.1

Date: 2012-08-21

  • Initial release, forked from iambus/youku-lixian; add:
    • YouTube support.
    • Pausing and resuming of downloads.
    • HTTP proxy settings.

Release history Release notifications

History Node

0.4.1060

History Node

0.4.1040

History Node

0.4.1025

History Node

0.4.1011

History Node

0.4.995

History Node

0.4.990

History Node

0.4.985

History Node

0.4.964

History Node

0.4.939

History Node

0.4.915

History Node

0.4.909

History Node

0.4.900

History Node

0.4.803

History Node

0.4.775

History Node

0.4.750

History Node

0.4.715

History Node

0.4.652

History Node

0.4.648

History Node

0.4.626

History Node

0.4.595

History Node

0.4.575

History Node

0.4.555

History Node

0.4.536

History Node

0.4.523

History Node

0.4.486

History Node

0.4.455

History Node

0.4.424

History Node

0.4.390

History Node

0.4.365

History Node

0.4.350

History Node

0.4.330

History Node

0.4.324

History Node

0.4.306

History Node

0.4.293

History Node

0.4.272

History Node

0.4.266

History Node

0.4.245

History Node

0.4.236

History Node

0.4.232

History Node

0.4.217

History Node

0.4.210

History Node

0.4.192

History Node

0.4.176

History Node

0.4.167

History Node

0.4.156

History Node

0.4.136

History Node

0.4.125

History Node

0.4.111

History Node

0.3.36

History Node

0.3.35

History Node

0.3.34

History Node

0.3.33

History Node

0.3.32

History Node

0.3.31

History Node

0.3.30

History Node

0.3.30dev-20140907

History Node

0.3.30dev-20140820

History Node

0.3.30dev-20140812

History Node

0.3.30dev-20140806

History Node

0.3.30dev-20140730

History Node

0.3.30dev-20140723

History Node

0.3.30dev-20140716

History Node

0.3.30dev-20140629

History Node

0.3.29

History Node

0.3.28.3

History Node

0.3.28.2

History Node

0.3.28.1

History Node

0.3.28

History Node

0.3.27

History Node

0.3.26

History Node

0.3.25

History Node

0.3.24

History Node

0.3.23

This version
History Node

0.3.22

History Node

0.3.21

History Node

0.3.20

History Node

0.3.19

History Node

0.3.18

History Node

0.3.17

History Node

0.3.16

History Node

0.3.15

History Node

0.3.14

History Node

0.3.13

History Node

0.3.12

History Node

0.3.11

History Node

0.3.10

History Node

0.3.9

History Node

0.3.8

History Node

0.3.7

History Node

0.3.6

History Node

0.3.5

History Node

0.3.4

History Node

0.3.3

History Node

0.3.2

History Node

0.3.1

History Node

0.3.0

History Node

0.3dev-20130201

History Node

0.3dev-20130125

History Node

0.3dev-20130118

History Node

0.3dev-20130111

History Node

0.3dev-20130104

History Node

0.3dev-20121228

History Node

0.3dev-20121221

History Node

0.3dev-20121220

History Node

0.3dev-20121219

History Node

0.3dev-20121217

History Node

0.3dev-20121212

History Node

0.3dev-20121210

History Node

0.2.16

History Node

0.2.15

History Node

0.2.14

History Node

0.2.13

History Node

0.2.12

History Node

0.2.11

History Node

0.2.10

History Node

0.2.9

History Node

0.2.8

History Node

0.2.7

History Node

0.2.6

History Node

0.2.5

History Node

0.2.4

History Node

0.2.3

History Node

0.2.2

History Node

0.2.1

History Node

0.2

History Node

0.1.3

History Node

0.1.2

History Node

0.1.1

History Node

0.1

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.3.22-py3.3.egg (249.9 kB) Copy SHA256 hash SHA256 Egg 3.3 Oct 18, 2013
you-get-0.3.22.tar.gz (50.4 kB) Copy SHA256 hash SHA256 Source None Oct 18, 2013

Supported by

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