{"id":13630743,"url":"https://github.com/coursera-dl/edx-dl","last_synced_at":"2025-05-14T15:07:19.395Z","repository":{"id":4863357,"uuid":"6018162","full_name":"coursera-dl/edx-dl","owner":"coursera-dl","description":"A simple tool to download video lectures from edx.org (and other openedx sites)","archived":false,"fork":false,"pushed_at":"2023-10-11T19:00:53.000Z","size":835,"stargazers_count":1953,"open_issues_count":213,"forks_count":638,"subscribers_count":111,"default_branch":"master","last_synced_at":"2025-05-11T12:05:18.030Z","etag":null,"topics":["download-videos","downloader","edx","edx-dl","harvardx","mitx","python","stanford-online","university","videos","youtube"],"latest_commit_sha":null,"homepage":"","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":"orta/ARAnalytics","license":"lgpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/coursera-dl.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":"AUTHORS.md"}},"created_at":"2012-09-30T12:09:56.000Z","updated_at":"2025-04-23T21:02:57.000Z","dependencies_parsed_at":"2024-01-14T06:50:49.391Z","dependency_job_id":"c67a31bb-8520-4539-915b-376c48dae14c","html_url":"https://github.com/coursera-dl/edx-dl","commit_stats":{"total_commits":539,"total_committers":47,"mean_commits":11.46808510638298,"dds":0.6493506493506493,"last_synced_commit":"e9a5e9c06d90d459788f5032f58f297a7fb45cca"},"previous_names":[],"tags_count":11,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/coursera-dl%2Fedx-dl","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/coursera-dl%2Fedx-dl/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/coursera-dl%2Fedx-dl/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/coursera-dl%2Fedx-dl/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/coursera-dl","download_url":"https://codeload.github.com/coursera-dl/edx-dl/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254169582,"owners_count":22026213,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["download-videos","downloader","edx","edx-dl","harvardx","mitx","python","stanford-online","university","videos","youtube"],"created_at":"2024-08-01T22:01:58.133Z","updated_at":"2025-05-14T15:07:19.372Z","avatar_url":"https://github.com/coursera-dl.png","language":"HTML","funding_links":[],"categories":["HTML"],"sub_categories":[],"readme":"[![Build Status](https://github.com/coursera-dl/edx-dl/workflows/Run%20Unit%20Tests/badge.svg)](https://github.com/coursera-dl/edx-dl/workflows)\n[![Coverage Status](https://coveralls.io/repos/coursera-dl/edx-dl/badge.svg?branch=master\u0026service=github)](https://coveralls.io/github/coursera-dl/edx-dl?branch=master)\n[![Code Climate](https://codeclimate.com/github/coursera-dl/edx-dl/badges/gpa.svg)](https://codeclimate.com/github/coursera-dl/edx-dl)\n[![PyPI version](https://badge.fury.io/py/edx-dl.svg)](https://badge.fury.io/py/edx-dl)\n\n# Description\n\n`edx-dl` is a simple tool to download videos and lecture materials from Open\nedX-based sites.  It requires a [Python][python] interpreter (\u003e= 2.7) and\nvery few other dependencies.  It is platform independent, and should work\nfine under Unix (Linux, BSDs etc.), Windows or Mac OS X.\n\nWe strongly recommend that, if you don't already have a Python interpreter\ninstalled, that you [install Python \u003e= 3.6][python3], if possible, since it\nis better in general.\n\n[python]: https://www.python.org/\n[python3]: https://www.python.org/downloads/\n\n# Installation (recommended)\n\nTo install edx-dl run:\n\n    pip install edx-dl\n\n# Manual Installation\n\nTo install all the dependencies please do:\n\n    pip install -r requirements.txt\n\n## youtube-dl\n\nOne of the most important dependencies of `edx-dl` is `youtube-dl`. The\ninstallation step listed above already pulls in the most recent version of\n`youtube-dl` for you.\n\nUnfortunately, since many Open edX sites store their videos on Youtube and\nYoutube changes their layout from time to time, it may be necessary to\nupgrade your copy of `youtube-dl`.  There are many ways to proceed here, but\nthe simplest is to simply use:\n\n    pip install --upgrade youtube-dl\n\n# Quick Start\n\nOnce you have installed everything, to use `edx-dl.py`, let it discover the\ncourses in which you are enrolled, by issuing:\n\n    edx-dl -u user@user.com --list-courses\n\nFrom there, choose the course you are interested in, copy its URL and use it\nin the following command:\n\n    edx-dl -u user@user.com COURSE_URL\n\nreplacing `COURSE_URL` with the URL that you just copied in the first step.\nIt should look something like:\nhttps://courses.edx.org/courses/edX/DemoX.1/2014/info\n\nYour downloaded videos will be placed in a new directory called\n`Downloaded`, inside your current directory, but you can also choose another\ndestination with the `-o` argument.\n\nTo see all available options and a brief description of what they do, simply\nexecute:\n\n    edx-dl --help\n\n*Important Note:* To use sites other than \u003cedx.org\u003e, you **have** to specify the\nsite along with the `-x` option. For example, `-x stanford`, if the course\nthat you want to get is hosted on Stanford's site.\n\n# Docker container\n\nYou can run this application via [Docker](https://docker.com) if you want. Just install docker and run\n\n```\ndocker run --rm -it \\\n       -v \"$(pwd)/edx/:/Downloaded\" \\\n       strm/edx-dl -u \u003cUSER\u003e -p \u003cPASSWORD\u003e\n```\n\n# Reporting issues\n\nBefore reporting any issue please follow the steps below:\n\n1. Verify that you are running the latest version of all the programs (both\nof `edx-dl` and of `youtube-dl`).  Use the following command if in doubt:\n\n        pip install --upgrade edx-dl\n\n2. If you get an error like `\"YouTube said: Please sign in to view this\n   video.\"`, then we can't do much about it. You can try to pass your\n   credentials to `youtube-dl` (see\n   https://github.com/rg3/youtube-dl#authentication-options) with the use of\n   `edx-dl`'s option `--youtube-dl-options`. If it doesn't work, then you\n   will have to tell `edx-dl` to ignore the download of that particular\n   video with the option `--ignore-errors`.\n\n3. If the problem persists, feel free to [open an issue][issue] in our\nbugtracker, please fill the issue template with *as much information as\npossible*.\n\n[issue]: https://github.com/coursera-dl/edx-dl/issues\n\n# Supported sites\n\nThese are the current supported sites:\n\n- [edX](http://edx.org)\n- [Stanford](http://lagunita.stanford.edu/)\n- [University of Sydney](http://online.it.usyd.edu.au)\n- [France Université Numérique](https://www.france-universite-numerique-mooc.fr/)\n- [GW Online SEAS](http://openedx.seas.gwu.edu/) - George Washington University\n- [GW Online Open](http://mooc.online.gwu.edu/) - George Washington University\n\nThis is the full [list of sites powered by Open edX][sites]. Not all of them\nare supported at the moment, we welcome you to contribute support for them\nand send a pull request also via our [issue tracker][issue].\n\n[sites]: https://github.com/edx/edx-platform/wiki/Sites-powered-by-Open-edX\n\n# Authors\n\nSee the contributors to the project in the [AUTHORS.md][authors] file.  If\nyou have contributed to the project, we would like to gladly credit you for\nyour work. Just send us a note to be added to that list.\n\n[authors]: https://github.com/coursera-dl/edx-dl/blob/master/AUTHORS.md\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcoursera-dl%2Fedx-dl","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcoursera-dl%2Fedx-dl","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcoursera-dl%2Fedx-dl/lists"}