Need help with edx-dl?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

coursera-dl
1.7K Stars 605 Forks GNU Lesser General Public License v3.0 691 Commits 201 Opened issues

Description

A simple tool to download video lectures from edx.org (and other openedx sites)

Services available

!
?

Need anything else?

Contributors list

Build Status Coverage Status Code Climate PyPI version

Description

edx-dl
is a simple tool to download videos and lecture materials from Open edX-based sites. It requires a Python interpreter (>= 2.7) and very few other dependencies. It is platform independent, and should work fine under Unix (Linux, BSDs etc.), Windows or Mac OS X.

We strongly recommend that, if you don't already have a Python interpreter installed, that you install Python >= 3.6, if possible, since it is better in general.

Installation (recommended)

To install edx-dl run:

pip install edx-dl

Manual Installation

To install all the dependencies please do:

pip install -r requirements.txt

youtube-dl

One of the most important dependencies of

edx-dl
is
youtube-dl
. The installation step listed above already pulls in the most recent version of
youtube-dl
for you.

Unfortunately, since many Open edX sites store their videos on Youtube and Youtube changes their layout from time to time, it may be necessary to upgrade your copy of

youtube-dl
. There are many ways to proceed here, but the simplest is to simply use:
pip install --upgrade youtube-dl

Quick Start

Once you have installed everything, to use

edx-dl.py
, let it discover the courses in which you are enrolled, by issuing:
edx-dl -u [email protected] --list-courses

From there, choose the course you are interested in, copy its URL and use it in the following command:

edx-dl -u [email protected] COURSE_URL

replacing

COURSE_URL
with the URL that you just copied in the first step. It should look something like: https://courses.edx.org/courses/edX/DemoX.1/2014/info

Your downloaded videos will be placed in a new directory called

Downloaded
, inside your current directory, but you can also choose another destination with the
-o
argument.

To see all available options and a brief description of what they do, simply execute:

edx-dl --help

Important Note: To use sites other than , you have to specify the site along with the

-x
option. For example,
-x stanford
, if the course that you want to get is hosted on Stanford's site.

Docker container

You can run this application via Docker if you want. Just install docker and run

docker run --rm -it \
       -v "$(pwd)/edx/:/Downloaded" \
       strm/edx-dl -u  -p 

Reporting issues

Before reporting any issue please follow the steps below:

  1. Verify that you are running the latest version of all the programs (both of

    edx-dl
    and of
    youtube-dl
    ). Use the following command if in doubt:
    pip install --upgrade edx-dl
    
  2. If you get an error like

    "YouTube said: Please sign in to view this
    video."
    , then we can't do much about it. You can try to pass your credentials to
    youtube-dl
    (see https://github.com/rg3/youtube-dl#authentication-options) with the use of
    edx-dl
    's option
    --youtube-dl-options
    . If it doesn't work, then you will have to tell
    edx-dl
    to ignore the download of that particular video with the option
    --ignore-errors
    .
  3. If the problem persists, feel free to open an issue in our bugtracker, please fill the issue template with as much information as possible.

Supported sites

These are the current supported sites:

This is the full list of sites powered by Open edX. Not all of them are supported at the moment, we welcome you to contribute support for them and send a pull request also via our issue tracker.

Authors

See the contributors to the project in the AUTHORS.md file. If you have contributed to the project, we would like to gladly credit you for your work. Just send us a note to be added to that list.

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.