edX Courseware Downloader

一个 edX 课程下载脚本，改自 edx-dl 项目 ( https://github.com/coursera-dl/edx-dl )。

看起来原来的项目已经无人维护了，按照 edX 官方提供的 API 修改了原来的代码。由于本人比较菜、没怎么写过 python 代码，也顺便删掉了一些看得不顺眼的功能（具体见下）。

使用方法

首先，你要有一个 edX 的账号，并且你要 enroll 进你想下载的课程里。

然后，在命令行里输入 python edxdlr.py，后面跟上命令。

两个常用命令：

• 查看所有课程 python edxdlr.py -u USERNAME -p PASSWORD --list-courses
• 下载某一门课 python edxdlr.py -u USERNAME -p PASSWORD COURSEID

其它命令可 python edxdlr.py --help 来查看。

COURSEID 即课程 ID。举个例子，如果你的课程链接是 https://learning.edx.org/course/course-v1:MichiganX+py4e101x+2T2021a/home ，那么课程 ID 就是中间的那一串 course-v1:MichiganX+py4e101x+2T2021a。

使用限制

• 目前只支持新链接格式，即 learning.edx.org 开头的课程。老课程链接，即链接以 courses.edx.org 开头，不支持下载（这个你可以用原来的edx-dl下载）。
• 目前能下载的包括网页、视频、视频字幕、超链接形式的 PDF、PPT 等课件，网页内图片暂时还下不了。
• 字幕下载功能基本沿用 edx-dl 的代码，尚未在新的 edx 上充分测试，可能会无法下载。

安装要求

需要 python 3.6 或更高环境，以及下列依赖：

• beautifulsoup4
• html5lib
• six
• requests
• tqdm

可用 pip install -r requirements.txt 安装。

与原 edx-dl 的不同之处

• 修改：选择课程时，不需要输入完整课程路径，只要输入课程 ID 即可。
• 修改：可使用多进程下载 (beta)，需要使用 --process k。
• 增加：网页下载功能。原来的 edx-dl 只下载视频、不下载网页，现在都会下载并放在文件夹里。目前还无法下载网页内图片。
• 移除：各种我看不懂的 filter 功能（x
• 移除：从 YouTube 下载视频的功能（现在 edX 的视频在 CDN 上基本都有，通用性更强）

特性说明：--download-m3u8 高清下载

• 程序默认下载的是默认清晰度的 mp4 视频。如需下载更高清晰度，请：

1. 前往 ffmpeg 官网 下载程序
2. 将其添加到系统的可执行路径中
3. 在 edxdlr 后面的参数中增加 --download-m3u8 选项

使用 m3u8 方式将下载最高清晰度的视频。如果没有 ffmpeg 来转码，文件夹内将会保留合并后尚未转码的 ts 文件，需使用可解码的播放器（如 VLC）才能播放。

特性说明：--short-names 短文件名

• 某些课程的章节/视频名称过长，可能会超出文件系统限制，出现 File Not Found 的问题，可使用此选项【截短】名称到32 chars
• 缺点是文件夹、文件名称就不完整了，有利有弊

特性说明：--process k 多进程下载 (testing)

• 可使用 --process k，其中 k 为建立的进程数量。该数值不建议过高，过高的进程数将占用大量内存，并可能有 IP 封禁的风险。
• 使用多进程下载时，所有待下载内容会先顺序读取，然后以多进程方式同步下载，能极大提高下载速度。
• 此功能尚不稳定，下载过程中可能无法中断。

常见问题

1. 这程序会不会记录我的密码？ 会，但只在运行时候记住。下次运行还要再输入一次。（你不给也没法登录啊）

2. 访问不了 edx？ 这我帮不了你。理论上，如果你网页能直接登录，这个脚本也可以访问。

3. 有课程下不了？ 在浏览器里登录账号后，在 dashboard 里确认你的课程符合上面说的课程链接格式，且是 Started 或 Archived。旧格式课程可使用原来的 edx-dl 下载。如果还是下载不了，发个 issue，带上课程链接和报错信息我看看。

4. 一些字幕无法下载？ 这是一个已知问题，新版的 edx 字幕的接口有些复杂，我需要更多时间来处理。如果遇到字幕错误导致无法下载，请先暂时不要在下载参数中加上 --download-subtitles，以确保其它内容正常下载。

5. 其它程序崩溃问题？ 任何出错，都先看看浏览器里自己的账号能不能登录、dashboard 能不能看到、课程链接对不对。如果都正常，请发个 issue，带上课程链接和报错信息我看看。

免责声明

本程序仅提供一种非浏览器方式访问 edX 网站的方法。使用者在使用本程序时需要满足 edX 的使用条款 (Terms of Service | edX)，限使用者本人出于个人学习目的使用。任何使用者的不当操作与本程序无关。