中国大学MOOC课程资料下载器完整使用教程

项目简介

mooc-dl 是一个专为中国大学MOOC平台设计的课程资料下载工具，能够帮助用户一键下载课程视频、文档和附件，实现真正的离线学习体验。该项目采用Python语言开发，支持多线程下载和灵活的配置选项。

环境准备

在开始使用之前，请确保您的系统满足以下要求：

• Python 3.6或更高版本
• 稳定的网络连接
• 已参加目标课程的中国大学MOOC账号

安装步骤

1. 获取项目代码

首先需要克隆项目到本地：

git clone https://gitcode.com/gh_mirrors/mo/mooc-dl
cd mooc-dl

2. 安装依赖包

使用pip安装项目所需的依赖：

pip install -r requirements.txt

3. 配置FFmpeg（可选）

如果需要视频合并功能，请自行安装FFmpeg并配置系统环境变量。

配置详解

配置文件结构

打开 config.json 文件，您可以看到以下配置选项：

{
  "username": "您的爱课程账号",
  "password": "您的爱课程账号密码",
  "resolution": 0,
  "root": "",
  "num_thread": 16,
  "overwrite": false,
  "file_path_template": "{base_dir}{sep}{cnt_1} {chapter_name}{sep}{cnt_2} {lesson_name}{sep}{cnt_3} {unit_name}",
  "range": {
    "start": [0, 0, 0],
    "end": [999, 999, 999]
  },
  "file_types": [1, 3, 4],
  "use_ffmpeg": false
}

关键配置说明

配置项	说明	推荐值
username	爱课程账号	您的实际账号
password	账号密码	您的实际密码
resolution	视频清晰度	0（最高清晰度）
num_thread	下载线程数	8-16
file_types	下载文件类型	[1,3,4]（全部类型）
use_ffmpeg	使用FFmpeg合并	false（默认）

账号安全提醒

重要提示：请务必使用自己的爱课程账号，不要使用共享账号。目前中国大学MOOC会验证账号是否参加课程，只有已报名课程的用户才能正常下载。

使用方法

基本下载命令

下载整个课程的所有资料：

python mooc-dl.py "课程URL"

例如：

python mooc-dl.py "https://www.icourse163.org/course/ZJU-93001"

高级参数使用

支持通过命令行参数覆盖配置文件：

python mooc-dl.py "课程URL" --range="1.2~5.4" --file-types="1,3" --use-ffmpeg --overwrite

参数说明：

• --range：指定下载范围（格式：起始章节~结束章节）
• --file-types：指定下载文件类型（1=视频，3=PDF，4=附件）
• --use-ffmpeg：启用FFmpeg视频合并
• --overwrite：强制覆盖已存在文件

文件路径定制

您可以根据需要自定义文件存储路径。例如，按文件类型分类存储：

{
  "file_path_template": "{base_dir}{sep}{type}{sep}{cnt_3} {unit_name}"
}

常见问题解答

Q: 下载进度显示异常怎么办？

A: 进度条显示问题不影响实际下载功能，所有文件都会正常下载完成。

Q: 为什么需要使用自己的账号？

A: 中国大学MOOC平台会验证账号是否参加课程，只有已报名用户才能访问课程资料。

Q: 支持哪些文件类型下载？

A: 支持三种文件类型：视频(1)、PDF文档(3)、附件(4)。

Q: 如何设置下载范围？

A: 可以通过配置文件或命令行参数设置起始和结束章节。

使用建议

1. 网络环境：建议在稳定的网络环境下使用，避免下载中断
2. 存储空间：确保有足够的磁盘空间存储课程资料
3. 版权遵守：下载的资料仅限个人学习使用，请勿用于商业用途
4. 定期更新：虽然项目已停止维护，但基本功能仍然可用

技术架构

mooc-dl 基于Python开发，主要功能模块包括：

• crawler.py：网络请求和内容抓取
• downloader.py：多线程下载管理
• config.py：配置管理
• utils模块：提供各种工具函数

通过合理的配置和使用，mooc-dl 能够帮助您高效地获取中国大学MOOC平台的优质学习资源，为您的学习之路提供有力支持。