Skip to content

南京大学 (Nanjing University) 在线教学平台 —— 教学立方的课件批量下载工具,基于Python + Requests.

License

Notifications You must be signed in to change notification settings

EricZhu-42/PedagogySquare_Downloader

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

92 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

GitHub GitHub last commit GitHub release (latest by date) GitHub code size in bytes GitHub top language
GitHub stars GitHub All Releases GitHub issues GitHub closed issues PRs welcome

教学立方课件下载器

在线教学平台——教学立方的课件批量下载脚本,基于Python + Requests

创建日期:2020-03-30
更新日期:2022-03-06

下载地址

更新日期:2021年6月21日

推荐通过Github release下载;若连接速度较慢,亦可通过国内镜像地址下载

版本更新日志

2021年6月21日:功能性更新

config.json 文件中增加了 cid_include_list 项,在非空时将仅下载指定的部分课程。

2021年4月26日:功能性更新

config.json 文件中增加了 keep_dirs 项,可选择下载时是否保持课件的文件夹结构(默认为 false

2021年3月5日:功能性更新

为了方便课件管理,当前版本的 config.json 文件中增加了 save_path 项(支持绝对路径/相对路径),可设置下载文件的保存目录。

请参照下文“配置文件说明”一节,调整下载目录(默认为空,表示下载到脚本的相同目录)

2021年3月1日:Windows平台下的工具封装

TLDR: 当前版本做了脚本封装,现在Windows平台下不安装Python环境也能用了

自2021年3月1日起,我们将在release中为Windows平台用户提供封装后的独立可执行程序(standalone executable)。无需安装配置Python环境即可使用封装后的课件下载工具,具体的使用方法为:

  1. 下载并解压最新的release文件包,并进入解压后的文件夹
  2. 参照下文“最简配置方案”一节,修改文件 config.json ,填入用户名、密码等信息
  3. 双击执行 run.bat,等待课件下载完成

此外,新版本脚本优化了 config.json 的配置逻辑,推荐参考下文“配置文件说明”一节重新进行配置。

如果更新后的脚本无法正常使用,请尝试回退至旧版本,观察问题是否解决,并联系开发者反馈问题,感谢!

程序特色

  1. 一键下载所有课程的全部课件,方便快捷
  2. 可下载未直接开放下载的课件,视频等内容
  3. 可深度配置的课程筛选/文件拓展名筛选功能

本程序旨在方便学生下载教学立方平台上的课件及相关教学资料,消除下载文件的重复劳动
请尊重教师的知识产权与劳动成果。除非获得教师许可,请勿将下载得到的文件在互联网上进行传播
如本程序损害了您的权益,请联系作者删除相关代码

运行环境

开发过程中使用的环境与第三方模块版本如下:

  • Python = 3.7.4

  • Requests = 2.22.0

为了正常运行脚本,请安装不低于以上版本的Python与Requests

另:经测试,该脚本可在移动端的终端模拟器中正常运行;安卓平台执行Python脚本可以参考@OrangeX4提供的工具与教程

使用方法

1. 配置环境(请参考其他教程)

  1. 安装对应版本的Python

  2. 安装对应版本的Python模块:Requests(推荐使用Anaconda进行管理)

2. 修改配置文件

修改文件 config.json ,填入用户名、密码等信息

关于如何修改配置文件,请参考“最简配置方案”一章
关于配置文件内各项参数的说明,请参考“配置文件说明”一章

3. 运行脚本

运行 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_usernameyour_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 是否保留文件的目录结构

注意事项与说明:

  1. 例如:若不需要下载课程ID为 12345 的课程,且不需要下载 pdf 文件与 mp4 文件,可设置为:
    • ext_expel_list = ["pdf", "mp4"]
    • cid_expel_list = [12345]
  2. 在修改下载目录 save_path 时,请先在对应的位置创建文件夹;如无法找到对应的文件夹,将会报错并在默认目录(程序根目录)保存下载得到的文件。
  3. 课程ID在课程主页地址中查看,例如:

    图中对应课程的ID为8261

版权信息

联系邮箱:[email protected]

本项目基于MIT协议开源

About

南京大学 (Nanjing University) 在线教学平台 —— 教学立方的课件批量下载工具,基于Python + Requests.

Topics

Resources

License

Stars

Watchers

Forks

Contributors 4

  •  
  •  
  •  
  •  

Languages