Skip to main content
Pre-release

This release is a pre-release and may not be stable for production use.

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

Installation

  1. Install via Pip:

    $ [sudo] pip install you-get

    Check if the installation was successful:

    $ you-get -V
  2. 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
  3. 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
  4. Install from your distro’s repo:

Upgrading

Using Pip:

$ [sudo] pip install --upgrade you-get

Examples

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
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.
    -n | --no-merge                          Don't merge video parts.
    -F | --format <STREAM_ID>                Video format code.
    -c | --cookies                           Load NetScape's cookies.txt file.
    -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.

License

You-Get is licensed under the MIT license.

Contributing

Please see CONTRIBUTING.md.

Changelog

0.3.30dev-20140812

Date: 2014-08-12

  • Bug fixes:
    • Youku

  • New site support:
    • VideoBam (by @cnbeining)

0.3.30dev-20140806

Date: 2014-08-06

  • Bug fixes:
    • Youku

    • Nicovideo

    • Bilibili

    • Letv

  • New site support:
    • Tucao.cc

  • Use FFmpeg concat demuxer to join video segments (ffmpeg>=1.1)

0.3.30dev-20140730

Date: 2014-07-30

  • YouTube: support fixed

  • Youku: password-protected video support

0.3.30dev-20140723

Date: 2014-07-23

  • YouTube: (experimental) video format selection

  • Youku: playlist support

  • NetEase Music: high quality download (by @farseer90718)

  • PPTV: support fixed (by @jackyzy823)

  • Catfun.tv: new site support (by @jackyzy823)

  • AcFun.tv: domain name fixed

0.3.30dev-20140716

Date: 2014-07-16

0.3.30dev-20140629

Date: 2014-06-29

  • Bug fix release for:
    • Youku

    • YouTube

    • TED

    • Bilibili

  • (Experimental) Video format selection (for Youku only)

0.3.29

Date: 2014-05-29

  • Bug fix release

0.3.28.3

Date: 2014-05-18

  • New site support:
    • CBS.com

0.3.28.2

Date: 2014-04-13

  • Bug fix release

0.3.28.1

Date: 2014-02-28

  • Bug fix release

0.3.28

Date: 2014-02-21

  • New site support:
    • Magisto.com

    • VK.com

0.3.27

Date: 2014-02-14

  • Bug fix release

0.3.26

Date: 2014-02-08

  • New features:
    • Play video in players (#286)

    • LeTV support (#289)

    • Youku 1080P support

  • Bug fixes:
    • YouTube (#282, #292)

    • Sina (#246, #280)

    • Mixcloud

    • NetEase

    • QQ

    • Vine

0.3.25

Date: 2013-12-20

  • Bug fix release

0.3.24

Date: 2013-10-30

  • Experimental: Sogou proxy server

  • Fix issues for:
    • Vimeo

0.3.23

Date: 2013-10-23

  • Support YouTube playlists

  • Support general short URLs

  • Fix issues for:
    • Sina

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.

Metadata

Release files for you-get 0.3.30dev-20140812

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for you-get 0.3.30dev-20140812
File Size Uploaded
you-get-0.3.30dev-20140812.tar.gz 68.1 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for you-get 0.3.30dev-20140812
File Interpreter ABI Platform
you_get-0.3.30dev_20140812-py3.4.egg Legacy Egg format - - Details

Total release size: 283.5 kB

Release files / you-get-0.3.30dev-20140812.tar.gz

Download URL you-get-0.3.30dev-20140812.tar.gz
Size 68.1 kB
Tags Source
SHA-256 checksum
How to use checksums
0cdb7aeb971724594f9114db969583c16d22fb77451591dce263ce0d14bc4567
BLAKE2b-256 checksum
How to use checksums
00bea1ccfc4c2b2bae98dcd4ae7eb4d8c532354276e8de2759350ad18f30d58c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Release files / you_get-0.3.30dev_20140812-py3.4.egg

Download URL you_get-0.3.30dev_20140812-py3.4.egg
Size 215.4 kB
Tags Egg
SHA-256 checksum
How to use checksums
d1d347fdb25ea60afd3ddf7b484b44e5cc15e611738ad54e9c8c5152d561695a
BLAKE2b-256 checksum
How to use checksums
b2e24b99953bc50025ccd1624d84ac9d931521ec840ea7868ac92194165570cc
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Release history Release notifications | RSS feed

0.3.35

2 release files

0.3.34

2 release files

0.3.33

2 release files

0.3.32

2 release files

0.3.30

2 release files

This release

0.3.29

2 release files

0.3.28

2 release files

0.3.27

2 release files

0.3.25

2 release files

0.3.24

2 release files

0.3.23

2 release files

0.3.22

2 release files

0.3.21

2 release files

0.3.20

2 release files

0.3.19

2 release files

0.3.18

2 release files

0.3.17

2 release files

0.3.16

2 release files

0.3.15

2 release files

0.3.14

2 release files

0.3.12

2 release files

0.3.11

2 release files

0.3.10

2 release files

0.3.9

2 release files

0.3.8

2 release files

0.3.7

2 release files

0.3.6

2 release files

0.3.5

2 release files

0.3.4

2 release files

0.3.3

2 release files

0.3.2

2 release files

0.3.1

2 release files

0.3.0

2 release files

0.2.15

2 release files

0.2.14

2 release files

0.2.13

2 release files

0.2.12

2 release files

0.2.11

2 release files

0.2.10

2 release files

0.2.9

2 release files

0.2.8

2 release files

0.2.7

2 release files

0.2.6

2 release files

0.2.5

2 release files

0.2.4

2 release files

0.2.3

2 release files

0.2.2

2 release files

0.2.1

2 release files

0.2

2 release files

0.1.3

3 release files

0.1.2

2 release files

0.1.1

2 release files

0.1

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page