在线教学平台——教学立方的课件批量下载脚本，基于Python + Requests
创建日期：2020-03-30
更新日期：2022-03-06
更新日期：2021年6月21日
推荐通过Github release下载；若连接速度较慢，亦可通过国内镜像地址下载。
在 config.json 文件中增加了 cid_include_list 项，在非空时将仅下载指定的部分课程。
在 config.json 文件中增加了 keep_dirs 项，可选择下载时是否保持课件的文件夹结构（默认为 false）
为了方便课件管理，当前版本的 config.json 文件中增加了 save_path 项（支持绝对路径/相对路径），可设置下载文件的保存目录。
请参照下文“配置文件说明”一节，调整下载目录（默认为空，表示下载到脚本的相同目录）
TLDR: 当前版本做了脚本封装，现在Windows平台下不安装Python环境也能用了
自2021年3月1日起，我们将在release中为Windows平台用户提供封装后的独立可执行程序（standalone executable）。无需安装配置Python环境即可使用封装后的课件下载工具，具体的使用方法为：
- 下载并解压最新的release文件包，并进入解压后的文件夹
- 参照下文“最简配置方案”一节，修改文件
config.json，填入用户名、密码等信息 - 双击执行
run.bat，等待课件下载完成
此外，新版本脚本优化了 config.json 的配置逻辑，推荐参考下文“配置文件说明”一节重新进行配置。
如果更新后的脚本无法正常使用，请尝试回退至旧版本，观察问题是否解决，并联系开发者反馈问题，感谢！
- 一键下载所有课程的全部课件，方便快捷
- 可下载未直接开放下载的课件，视频等内容
- 可深度配置的课程筛选/文件拓展名筛选功能
本程序旨在方便学生下载教学立方平台上的课件及相关教学资料，消除下载文件的重复劳动
请尊重教师的知识产权与劳动成果。除非获得教师许可，请勿将下载得到的文件在互联网上进行传播
如本程序损害了您的权益，请联系作者删除相关代码
开发过程中使用的环境与第三方模块版本如下：
-
Python = 3.7.4
-
Requests = 2.22.0
为了正常运行脚本，请安装不低于以上版本的Python与Requests
另：经测试，该脚本可在移动端的终端模拟器中正常运行；安卓平台执行Python脚本可以参考@OrangeX4提供的工具与教程。
-
安装对应版本的Python
-
安装对应版本的Python模块：Requests（推荐使用Anaconda进行管理）
修改文件 config.json ，填入用户名、密码等信息
关于如何修改配置文件，请参考“最简配置方案”一章
关于配置文件内各项参数的说明，请参考“配置文件说明”一章
运行 download.py
注：若运行过程中出现下载速度过慢等现象，可能是由于与教学立方网站连接不稳定，请尝试重新运行脚本。
| 文件名 | 功能 |
|---|---|
| figure/ | 脚本说明中用到的图片文件 |
| download.py | 脚本运行入口 |
| config.json | 执行参数的配置文件 |
| config_example.json | 供参考的样例配置文件 |
{
"username": "your_username",
"password": "your_password",
"ext_expel_list": [],
"cid_expel_list": [],
"cid_include_list": [],
"save_path": "",
"keep_dirs": false
}将 your_username 与 your_password （注意保留外部的双引号）替换成你的手机号和教学立方登录密码即可，其他参数无需修改。
请确保json文件格式正确，可参考提供的
config_example.json进行配置。
以下对 config.json 内各项参数进行简要说明：
| 参数名 | 类型 | 含义 |
|---|---|---|
| username | str | 教学立方登录用户名（一般为手机号） |
| password | str | 教学立方登录密码 |
| ext_expel_list | list | 排除文件的类型列表 |
| cid_expel_list | list | 排除课程的课程ID列表 |
| cid_include_list | list | 保留课程的ID列表 |
| save_path | str | 下载目录（支持绝对路径或相对路径） |
| keep_dirs | bool | 是否保留文件的目录结构 |
- 例如：若不需要下载课程ID为
12345的课程，且不需要下载pdf文件与mp4文件，可设置为：ext_expel_list = ["pdf", "mp4"]cid_expel_list = [12345]
- 在修改下载目录
save_path时，请先在对应的位置创建文件夹；如无法找到对应的文件夹，将会报错并在默认目录（程序根目录）保存下载得到的文件。 - 课程ID在课程主页地址中查看，例如：
图中对应课程的ID为8261
本项目基于MIT协议开源