关于 XDUClassVideoDownloader 的开发

技术 · 07-07 · 348 人浏览

目录

写在前面

  • 其实是前段时间写的程序了,但是一直没有在博客上记录下来,现在终于想起来了就写一下。
  • 本文主要是记录一下这个程序的开发过程。
  • 纯纯流水账没啥好看的捏

项目简介

GitHub Tag GitHub Release Date GitHub Downloads (all assets, all releases) GitHub Repo stars

  • 本项目是一个用于下载西安电子科技大学录直播平台课程视频的工具。

  • 只需输入任意一节课的 liveId,即可自动下载 单节课 / 单集(半节课) / 该课程的所有视频

    liveId 是课程直播的唯一标识,可以在课程直播页面的 URL 中找到。如:http://newesxidian.chaoxing.com/live/viewNewCourseLive1?liveId=12345678 中的 12345678

  • 同时会保存选择下载的范围内所有视频的 m3u8 链接到对应的 csv 表格中,方便使用其他方式下载。

  • 下载时会自动检查之前是否下载过同一节课,如果已经下载则会跳过。所以可以在一学期中的多个时候随时下载新增的录播视频。

  • 下载的视频按照课程和时间整理,下载多个课程的视频也不会冲突。

  • 文件夹和 csv 表格命名规则:年份-课程号-课程名。

  • 课程视频命名规则:课程号-课程名-年月日-周次-节号-视频来源。、

项目地址

开发过程

开始是怎么想到做这个的呢?

  • 期末复习的时候,发现学校的录直播平台上有很多课程的录播视频,但是没有下载的按钮,只能在线观看。
  • 但是在线观看的时候经常会卡顿,而且有时候需要反复观看,所以想着能不能下载下来看。
  • 开始想到了 IDM 的视频下载功能,但是体验真不算好:
    • 首先需要打开每个视频的播放页面,等待漫长的加载时间,IDM 才能检测到视频。
    • 然后要在每个视频的角落里一个一个点用 IDM 下载,下完所有视频得累死。
    • 而且下载的视频文件名也是随机的一串数字,需要手动整理。
  • 碰巧看到群友提到录直播平台有能获取一节课所有视频链接的接口,于是就想着能不能写一个脚本来批量下载视频。

开干!(超级流水账环节!)

  • 根据群友提供的链接,使用 Curl 尝试了一下,确实能得到所有视频链接。

    • 这个链接能使用一节课的 liveId 获取到这门课所有视频的信息,包括课程号、课程名称、教师名称、上课教室、上课时间、liveId 等信息,群友提供的链接参数非常复杂,我筛选测试之后发现只保留以下参数就能工作:
      • 接口链接:http://newesxidian.chaoxing.com/live/listSignleCourseSingle 拼成了 Signle,程序员扣大分)
      • URL 参数:liveId=12345678(随便一节课就行,不一定要第一节课)
      • User-Agent: Mozilla/5.0(UA 感觉是黑名单制度,curl 不定义 UA 能正常工作,但 Python 的 requests 就不行,所以我就随便填了这个,能用就行)
      • Cookie: UID=2(非空就行,随便给个数字,这鉴权太草率了吧)
    • 这个链接能使用一节课的 liveId 获取到这节课的录播查看页面链接,返回链接的 URL 参数是一段 URL 编码后的 Json,解码后能得到三个视频的 m3u8 链接,包括 pptVideo teacherTrack studentFull,分别是投影仪画面、教师画面(自动追踪)和教室学生画面(黑板左上角的摄像头对着整个教室拍,但这个视频下载下来大多是破碎的,也没啥用,网页上播放的时候是隐藏的)。同样是筛选清理之后的参数:
      • 接口链接:http://newesxidian.chaoxing.com/live/getViewUrlHls
      • URL 参数:liveId=12345678&status=2status=2 好像是需要的,但我忘记为什么了)
      • User-Agent: Mozilla/5.0(同上)
      • Cookie: UID=2(同上)
  • 然后我直接把这一堆请求、返回值、解析处理的逻辑发给 ChatGPT,让它实现获取一门课所有视频的 m3u8 链接和时间等信息并保存到一个 csv 表格里的功能。多亏了 GPT-4o,给我提供了一段非常完美的 Python 代码。

    展开查看 ChatGPT 给出的代码(那时候请求参数还没清理)
    import subprocess
    import json
    import csv
    import urllib.parse
    
    def get_initial_data():
        curl_command = [
            "curl", "http://newesxidian.chaoxing.com/live/listSignleCourse",
            "--compressed",
            "-X", "POST",
            "-H", "User-Agent: Mozilla/5.0 (Wayland; Linux x86_64; rv:120.1) Gecko/20100101 Firefox/120.1",
            "-H", "Accept: application/json, text/javascript, */*; q=0.01",
            "-H", "Accept-Language: en-US,en;q=0.7,ja;q=0.3",
            "-H", "Accept-Encoding: gzip, deflate",
            "-H", "Content-Type: application/x-www-form-urlencoded; charset=UTF-8",
            "-H", "X-Requested-With: XMLHttpRequest",
            "-H", "Origin: http://newesxidian.chaoxing.com",
            "-H", "DNT: 1",
            "-H", "Sec-GPC: 1",
            "-H", "Connection: keep-alive",
            "-H", "Referer: http://newesxidian.chaoxing.com/live/viewNewCourseLive1?isStudent=1",
            "-H", "Cookie: UID=9876",
            "--data-raw", "liveId=11740668"
        ]
    
        result = subprocess.run(curl_command, capture_output=True, text=True)
        return json.loads(result.stdout)
    
    def get_m3u8_links(live_id):
        curl_command = [
            "curl", f"http://newesxidian.chaoxing.com/live/getViewUrlHls?liveId={live_id}&status=2&jie=&isStudent=",
            "--compressed",
            "-H", "User-Agent: Mozilla/5.0",
            "-H", "Accept: */*",
            "-H", "Accept-Language: en-US,en;q=0.7,ja;q=0.3",
            "-H", "Accept-Encoding: gzip, deflate",
            "-H", "X-Requested-With: XMLHttpRequest",
            "-H", "DNT: 1",
            "-H", "Sec-GPC: 1",
            "-H", "Connection: keep-alive",
            "-H", "Referer: http://newesxidian.chaoxing.com/live/viewNewCourseLive1?isStudent=1",
            "-H", "Cookie: UID=2"
        ]
    
        result = subprocess.run(curl_command, capture_output=True, text=True)
        response = result.stdout
    
        url_start = response.find('info=')
        if url_start == -1:
            raise ValueError("info parameter not found in the response")
    
        encoded_info = response[url_start + 5:]
        decoded_info = urllib.parse.unquote(encoded_info)
        info_json = json.loads(decoded_info)
    
        video_paths = info_json.get('videoPath', {})
        ppt_video = video_paths.get('pptVideo', '')
        teacher_track = video_paths.get('teacherTrack', '')
        student_full = video_paths.get('studentFull', '')
    
        return ppt_video, teacher_track, student_full
    
    def main():
        data = get_initial_data()
    
        rows = []
        for entry in data:
            live_id = entry["id"]
            month = entry["startTime"]["month"]
            date = entry["startTime"]["date"]
            day = entry["startTime"]["day"]
            jie = entry["jie"]
            days = entry["days"]
    
            ppt_video, teacher_track, student_full = get_m3u8_links(live_id)
    
            row = [month, date, day, jie, days, ppt_video, teacher_track, student_full]
            rows.append(row)
    
        with open('m3u8.csv', mode='w', newline='') as file:
            writer = csv.writer(file)
            writer.writerow(['month', 'date', 'day', 'jie', 'days', 'pptVideo', 'teacherTrack', 'studentFull'])
            writer.writerows(rows)
    
        print("m3u8.csv 文件已创建并写入数据。")
    
    if __name__ == "__main__":
        main()
    
  • 我之前并没有写过 Python 程序,于是按照习惯让 ChatGPT 在 Python 中调用 Curl 命令行。之后经群友提醒换成了 Python 的 requests 库,这样代码更简洁,无需调用外部程序。

    展开查看改用 requests 库的第一段请求代码
    def get_initial_data():
    url = "http://newesxidian.chaoxing.com/live/listSignleCourse"
    headers = {
        "User-Agent": "Mozilla/5.0 (Wayland; Linux x86_64; rv:120.1) Gecko/20100101 Firefox/120.1",
        "Accept": "application/json, text/javascript, */*; q=0.01",
        "Accept-Language": "en-US,en;q=0.7,ja;q=0.3",
        "Accept-Encoding": "gzip, deflate",
        "Content-Type": "application/x-www-form-urlencoded; charset=UTF-8",
        "X-Requested-With": "XMLHttpRequest",
        "Origin": "http://newesxidian.chaoxing.com",
        "DNT": "1",
        "Sec-GPC": "1",
        "Connection": "keep-alive",
        "Referer": "http://newesxidian.chaoxing.com/live/viewNewCourseLive1?isStudent=1",
        "Cookie": "UID=9876"
    }
    data = {
        "liveId": "11740668"
    }
    
    response = requests.post(url, headers=headers, data=data)
    response.raise_for_status()
    return response.json()
    
  • 程序一动不动地在那里默默干活肯定不行,我们也需要知道它有没有死,于是使用 tqdm 加了一个进度条。

    展开查看使用 tqdm 的代码
    for entry in tqdm(data, desc="Processing entries"):
        live_id = entry["id"]
        month = entry["startTime"]["month"]
        date = entry["startTime"]["date"]
        day = entry["startTime"]["day"]
        jie = entry["jie"]
        days = entry["days"]
    
        ppt_video, teacher_track, student_full = get_m3u8_links(live_id)
    
        row = [month, date, day, jie, days, ppt_video, teacher_track, student_full]
        rows.append(row)
    
  • 获取到 m3u8 链接之后,就可以让它调用下载程序下载视频了。这里我使用了 N_m3u8DL-RE,因为 m3u8 是一种索引文件,里面包含了视频的分段链接,N_m3u8DL-RE 可以自动下载并合并这些分段视频。

    展开查看使用 subprocess 调用 N_m3u8DL-RE 的代码
    command = f'N_m3u8DL-RE.exe "{url}" --save-dir "m3u8" --save-name "{filename}"'
    subprocess.run(command, shell=True, check=True)
    
  • 为了让文件名信息丰富易于整理,按照“courseCodecourseNamex年x月x日第days周星期day第jie节-pptVideo/teacherTrack”的格式命名,星期几转换成更加符合习惯的汉字。

    展开查看文件名命名代码
    def day_to_chinese(day):
        days = ["日", "一", "二", "三", "四", "五", "六"]
        return days[day]
    
    for row in tqdm(rows, desc="Downloading videos"):
        month, date, day, jie, days, ppt_video, teacher_track, student_full = row
        day_chinese = day_to_chinese(day)
    
        if ppt_video:
            filename = f"{course_code}{course_name}{year}年{month1}月{date1}日第{days1}周星期{day_chinese1}第{jie1}节-pptVideo"
            download_m3u8(ppt_video, filename)
    
        if teacher_track:
            filename = f"{course_code}{course_name}{year}年{month1}月{date1}日第{days1}周星期{day_chinese1}第{jie1}节-teacherTrack"
            download_m3u8(teacher_track, filename)
    
  • 接口提供的信息没有年份,倒是有时间戳。如果是重修的话一门课就会上不止一次,为了可以收藏不同学年的同一节课,改成用时间戳转换得到年月日。

    展开查看时间戳转换代码
    start_time_unix = start_time / 1000
    start_time_struct = time.gmtime(start_time_unix)
    month = start_time_struct.tm_mon
    date = start_time_struct.tm_mday
    
  • 判断是否存在已经下载的视频,存在就跳过下载。

    展开查看更新后的代码
    for row in tqdm(rows, desc="Downloading videos"):
        month, date, day, jie, days, ppt_video, teacher_track = row
        day_chinese = day_to_chinese(day)
    
        if ppt_video:
            filename = f"{course_code}{course_name}{year}年{month}月{date}日第{days}周星期{day_chinese}第{jie}节-pptVideo"
            filepath = os.path.join(save_dir, f"{filename}.ts")
            if os.path.exists(filepath):
                print(f"{filepath} 已存在,跳过下载。")
            else:
                download_m3u8(ppt_video, filename, save_dir)
    
        if teacher_track:
            filename = f"{course_code}{course_name}{year}年{month}月{date}日第{days}周星期{day_chinese}第{jie}节-teacherTrack"
            filepath = os.path.join(save_dir, f"{filename}.ts")
            if os.path.exists(filepath):
                print(f"{filepath} 已存在,跳过下载。")
            else:
                download_m3u8(teacher_track, filename, save_dir)
    
  • 感谢群友 chi(Waylandhater 提出的添加命令行使用方法和单个视频下载模式,并且十分贴心地发了 pull request,直接帮我搞定了。

    展开查看添加命令行使用方法的代码
    from argparse import ArgumentParser
    
    def main(liveid_from_cli=None, command=''):
    while True:
        if liveid_from_cli:
            input_live_id = liveid_from_cli
            liveid_from_cli = None
        else:
            input_live_id = input("请输入 liveId:")
    ......
    
    def parse_arguments():
        parser = ArgumentParser(description='用于下载西安电子科技大学录直播平台课程视频的工具')
        parser.add_argument('liveid', nargs='?', default=None, help='直播ID,不输入则采用交互式方式获取')
        parser.add_argument('-c', '--command', default='', help='自定义下载命令,使用 {url}, {save_dir}, {filename} 作为替换标记')
    
        args = parser.parse_args()
        return args
    
    if __name__ == "__main__":
        args = parse_arguments()
        main(liveid_from_cli=args.liveid, command=args.command)
    
    展开查看添加单个视频下载模式的代码
    def main(liveid_from_cli=None, command='', single=False):
    while True:
        if liveid_from_cli:
            input_live_id = liveid_from_cli
    ......
    
    for entry in tqdm(data, desc="Processing entries"):
        live_id = entry["id"]
        if single and str(live_id) != input_live_id:
            continue
    ......
    
        parser.add_argument('-s', '--single', default=False, action='store_true', help='仅下载单集视频')
    ......
    
    if __name__ == "__main__":
    args = parse_arguments()
    main(liveid_from_cli=args.liveid, command=args.command, single=args.single)
    
  • 群友说代码开头要加一行 shebang,我就加了一行 shebang。这 shebang 有啥用呢?我也不知道,但网上一搜说是在 Linux 上运行要用的,指定执行这个代码的程序路径。这行一加,看起来代码没啥变化,结果 Windows 上双击运行不起来了,按说是行注释吧,但是双击之后就是闪退。你们 Linux 真的是(指指点点)。

    展开查看添加的 shebang
    #!/usr/bin/env python3
    
  • 那行吧,为了照顾 Linux 用户,这 shebang 就留着了。那 Windows 怎么办?我加了一个 bat 文件,双击这个 bat 文件就能正常运行了。

    展开查看添加的 windows_run.bat 文件
    @echo off
    python XDUClassVideoDownloader.py %*
    pause
    
  • 非常美丽脚本,这使我的运行环境旋转。我突然觉得每个用户在使用之前都照着 Readme 配一遍运行环境也太麻烦了,而且对小白用户来说也不友好,于是想到了把运行环境打包进去,这样用户只需要下载一个文件就能直接运行了。使用 pyinstaller 打包之后就能得到一个 XDUClassVideoDownloader.exe 文件,不用配环境,双击就能运行了。

    展开查看打包命令
    pip install pyinstaller
    python -m venv .venv
    .venv\Scripts\activate
    pip install requests tqdm
    pyinstaller --onefile --add-data "N_m3u8DL-RE.exe;." --add-data "ffmpeg.exe;." XDUClassVideoDownloader.py
    
  • 打包用的脚本最后需要添加一行,使它在执行结束之后不会自己关闭窗口,等按回车之后才会关闭。

    展开查看等待输入的代码
    input("按回车退出...")
    
  • 因为添加了 FFmpeg 这个庞然大物,打包之后的 exe 文件有好几十 MB,这可太大了。但是 N_m3u8DL-RE 需要 FFmpeg,执行的时候会检测 FFmpeg 是否存在,不存在就不能正常用了。我还尝试把 FFmpeg 从 BtbN 编译的版本换成了 gyan.dev 编译的 essentials 版本,但是打包体积也就稍微小了一点,准确来说是从 58.5 MB 减小到了 43.9 MB,至少是个进步吧。

  • 然后我又转念一想,这不对劲。我在 N_m3u8DL-RE 的命令行参数里指定了使用二进制合并模式,也就是把下载的分段 ts 文件直接按照二进制编码拼接起来,理论上没有用到 FFmpeg 重新封装。于是我想出了一个神奇的糊弄方案:我用 c 写了个什么用都没有的程序,编译成 exe 文件,改名成 FFmpeg.exe 放到文件夹里。这样 N_m3u8DL-RE 就能检测到 FFmpeg 了,但是实际上并没有用到 FFmpeg。这个程序的代码如下:

    展开查看什么用都没有的代码
    int main() {
        return 0;
    }
    

    没用的代码你也看?😠

  • 什么用都没有的 FFmpeg.exe 编译出来是 15 KB,换上去 N_m3u8DL-RE 确实能正常运行。但我还是不满意。然后我突然想到可以用 UPX 压缩 exe。结果是 8 KB。嗯,满意了。替换掉原来的 FFmpeg.exe,打包之后的 exe 从 43.9 MB 减小到了 14.4 MB。

    展开查看使用 UPX 压缩的命令
    upx --ultra-brute ffmpeg.exe
    
  • N_m3u8DL-RE 调用 FFmpeg 的时候如果 FFmpeg 不在 Path 中会找不到。但它也提供了一个命令行参数 --ffmpeg-binary-path <PATH> 来指定 FFmpeg 的路径。

    展开查看添加 FFmpeg 路径参数的代码
    def resource_path(relative_path):
        base_path = getattr(sys, '_MEIPASS', os.path.dirname(os.path.abspath(__file__)))
        return os.path.join(base_path, relative_path)
    
    def download_m3u8(url, filename, save_dir, command=''):
        n_m3u8dl_re_path = resource_path('N_m3u8DL-RE.exe')
        ffmpeg_path = resource_path('ffmpeg.exe')
    
        if not command:
            command = f'./{n_m3u8dl_re_path} "{url}" --save-dir "{save_dir}" --save-name "{filename}" --check-segments-count False --binary-merge True --ffmpeg-binary-path "{ffmpeg_path}"'
        else:
            command = command.format(url=url, filename=filename, save_dir=save_dir, ffmpeg_path=ffmpeg_path)
    ......
    
  • 这时候群友向我推荐了另一个 m3u8 下载器 vsd。它是用 Rust 写的 (我超,原!) 。它的二进制合并模式不需要 FFmpeg。我试了一下,感觉体验不错,于是换成了这个。它的二进制文件比 N_m3u8DL-RE 大一点,但是我发现它没有经过压缩,于是用 UPX 压缩了一下,体积从 13.3 MB 减小到了 3.5 MB,打包体积 11.9 MB。

    展开查看使用 vsd 下载视频的代码
    command = f'vsd-upx.exe save {url} -o {save_dir}\{filename} --retry-count 32 -t 16'
    
  • 换成 vsd 之后,有一个功能也可以实现了,那就是下载视频之后自动合并上下半节课。录直播平台的视频是上下半节课分开的,但这两段视频在时间上是连续的,合并在一起更方便看,也方便整理。于是使用 vsdmerge 参数实现了这个功能。

    展开查看合并视频的函数(因为这个功能可以开关所以代码里到处都改了一点点,就不全部放上来了)
    def merge_videos(files, output_file):
        if sys.platform.startswith('win32'):
            command = f'vsd-upx.exe merge -o {output_file} {" ".join(files)}'
        else:
            command = f'./vsd-upx merge -o {output_file} {" ".join(files)}'
    
        try:
            subprocess.run(command, shell=True, check=True)
            print(f"合并完成:{output_file}")
            for file in files:
                os.remove(file)
        except subprocess.CalledProcessError:
            print(f"合并 {output_file} 失败:\n{traceback.format_exc()}")
    
  • 添加合并视频功能涉及到了一大堆逻辑改动。

    • 命名的时候,比如合并前文件名是 xxx第5节xxxxxx第6节xxx,合并后的文件名就叫作 xxx第5-6节xxx,文件名的其他部分保持不变。

    • 合并的时候考虑到有些时候数据源会丢失几条视频数据,要正确处理视频链接或者视频文件不存在的错误,如果无法下载上下两个半节课或者其中一个半节课就跳过合并。

    • 在判断视频是否存在的逻辑中加入检查合并了的文件,也就是:

      • 如果上下半节合并的视频存在就跳过下载上下半节课
      • 如果上下半节没有合并的两个视频都存在就尝试合并
      • 如果只存在其中半节就尝试下载另外半节并且如果下载成功就尝试合并
    • 合并成功后删除合并前的单个视频文件。

    • 这个合并视频的功能作为可选项在交互式操作和命令行使用中都提供,默认合并。

    • 选择不合并的命令行参数为 --no-merge

    • 不合并的话上面描述的逻辑都不生效,效果和之前的代码保持相同。

    • 在交互模式中,如果选择只下载半节课视频,就不询问是否合并,也不执行合并功能。

      展开查看修改后的 main 函数,这简直是一大坨,希望逻辑上没出错
      def main(liveid=None, command='', single=0, merge=True):
          if not liveid:
              liveid = int(user_input_with_check(
                  "请输入 liveId:",
                  lambda liveid: liveid.isdigit() and len(liveid) <= 10
              ))
      
              single = user_input_with_check(
                  "是否仅下载单节课视频?输入 y 下载单节课,n 下载这门课所有视频,s 则仅下载单集(半节课)视频,直接回车默认单节课 (Y/n/s):",
                  lambda single: single.lower() in ['', 'y', 'n', 's']
              ).lower()
              if single in ['', 'y']:
                  single = 1
              elif single == 's':
                  single = 2
              else:
                  single = 0
      
              if single != 2:
                  merge = user_input_with_check(
                      "是否自动合并上下半节课视频?输入 y 合并,n 不合并,直接回车默认合并 (Y/n):",
                      lambda merge: merge.lower() in ['', 'y', 'n']
                  ).lower() != 'n'
          else:
              if single > 2:
                  single = 2
      
          data = get_initial_data(liveid)
      
          if not data:
              print("没有找到数据,请检查 liveId 是否正确。")
              return
      
          if single:
              matching_entry = next(
                  filter(lambda entry: entry["id"] == liveid, data))
      
              if not matching_entry:
                  raise ValueError("No matching entry found for the specified liveId")
      
              if single == 1:
                  start_time = matching_entry["startTime"]
                  data = list(filter(
                      lambda entry: entry["startTime"]["date"] == start_time["date"] and
                      entry["startTime"]["month"] == start_time["month"],
                      data))
              else:
                  data = [matching_entry]
      
          first_entry = data[0]
          start_time = first_entry["startTime"]["time"]
          course_code = first_entry["courseCode"]
          course_name = first_entry["courseName"]
      
          start_time_unix = start_time / 1000
          start_time_struct = time.gmtime(start_time_unix)
          year = start_time_struct.tm_year
      
          save_dir = f"{year}年{course_code}{course_name}"
          os.makedirs(save_dir, exist_ok=True)
      
          csv_filename = f"{year}年{course_code}{course_name}.csv"
      
          rows = []
          for entry in tqdm(data, desc="获取视频链接"):
              live_id = entry["id"]
              days = entry["days"]
              day = entry["startTime"]["day"]
              jie = entry["jie"]
      
              start_time = entry["startTime"]["time"]
              start_time_unix = start_time / 1000
              start_time_struct = time.gmtime(start_time_unix)
              month = start_time_struct.tm_mon
              date = start_time_struct.tm_mday
      
              ppt_video, teacher_track = get_m3u8_links(live_id)
      
              row = [month, date, day, jie, days, ppt_video, teacher_track]
              rows.append(row)
      
          with open(csv_filename, mode='w', newline='') as file:
              writer = csv.writer(file)
              writer.writerow(['month', 'date', 'day', 'jie', 'days', 'pptVideo', 'teacherTrack'])
              writer.writerows(rows)
      
          print(f"{csv_filename} 文件已创建并写入数据。")
      
          def process_rows(rows):
              for i in range(0, len(rows), 2):
                  row1 = rows[i]
                  month1, date1, day1, jie1, days1, ppt_video1, teacher_track1 = row1
                  day_chinese1 = day_to_chinese(day1)
      
                  row2 = rows[i + 1] if i + 1 < len(rows) else None
                  if row2:
                      month2, date2, day2, jie2, days2, ppt_video2, teacher_track2 = row2
                      day_chinese2 = day_to_chinese(day2)
      
                  ppt_video_files = []
                  if ppt_video1:
                      filename1 = f"{course_code}{course_name}{year}年{month1}月{date1}日第{days1}周星期{day_chinese1}第{jie1}节-pptVideo.ts"
                      filepath1 = os.path.join(save_dir, filename1)
                      if not os.path.exists(filepath1):
                          download_m3u8(ppt_video1, filename1, save_dir, command=command)
                      ppt_video_files.append(filepath1)
      
                  if ppt_video2:
                      filename2 = f"{course_code}{course_name}{year}年{month2}月{date2}日第{days2}周星期{day_chinese2}第{jie2}节-pptVideo.ts"
                      filepath2 = os.path.join(save_dir, filename2)
                      if not os.path.exists(filepath2):
                          download_m3u8(ppt_video2, filename2, save_dir, command=command)
                      ppt_video_files.append(filepath2)
      
                  if len(ppt_video_files) == 2 and merge:
                      ppt_merged_filename = f"{course_code}{course_name}{year}年{month1}月{date1}日第{days1}周星期{day_chinese1}第{jie1}-{jie2}节-pptVideo.ts"
                      ppt_merged_filepath = os.path.join(save_dir, ppt_merged_filename)
                      merge_videos(ppt_video_files, ppt_merged_filepath)
      
                  teacher_track_files = []
                  if teacher_track1:
                      filename1 = f"{course_code}{course_name}{year}年{month1}月{date1}日第{days1}周星期{day_chinese1}第{jie1}节-teacherTrack.ts"
                      filepath1 = os.path.join(save_dir, filename1)
                      if not os.path.exists(filepath1):
                          download_m3u8(teacher_track1, filename1, save_dir, command=command)
                      teacher_track_files.append(filepath1)
      
                  if teacher_track2:
                      filename2 = f"{course_code}{course_name}{year}年{month2}月{date2}日第{days2}周星期{day_chinese2}第{jie2}节-teacherTrack.ts"
                      filepath2 = os.path.join(save_dir, filename2)
                      if not os.path.exists(filepath2):
                          download_m3u8(teacher_track2, filename2, save_dir, command=command)
                      teacher_track_files.append(filepath2)
      
                  if len(teacher_track_files) == 2 and merge:
                      teacher_merged_filename = f"{course_code}{course_name}{year}年{month1}月{date1}日第{days1}周星期{day_chinese1}第{jie1}-{jie2}节-teacherTrack.ts"
                      teacher_merged_filepath = os.path.join(save_dir, teacher_merged_filename)
                      merge_videos(teacher_track_files, teacher_merged_filepath)
      
          if single == 1:
              process_rows(rows[:2])
          elif single == 2:
              row = rows[0]
              month, date, day, jie, days, ppt_video, teacher_track = row
              day_chinese = day_to_chinese(day)
      
              if ppt_video:
                  filename = f"{course_code}{course_name}{year}年{month}月{date}日第{days}周星期{day_chinese}第{jie}节-pptVideo.ts"
                  filepath = os.path.join(save_dir, filename)
                  if not os.path.exists(filepath):
                      download_m3u8(ppt_video, filename, save_dir, command=command)
      
              if teacher_track:
                  filename = f"{course_code}{course_name}{year}年{month}月{date}日第{days}周星期{day_chinese}第{jie}节-teacherTrack.ts"
                  filepath = os.path.join(save_dir, filename)
                  if not os.path.exists(filepath):
                      download_m3u8(teacher_track, filename, save_dir, command=command)
      
          else:
              process_rows(rows)
      
          print("所有视频下载和处理完成。")
      
  • 几百行代码好长,我小小的脑子要看不过来了,于是我把代码拆分成了几个文件,分别是 XDUClassVideoDownloader.pydownloader.pyapi.pyutils.py。这样代码结构更清晰,也方便维护。

    XDUClassVideoDownloader.py:主程序,用户交互和命令行参数解析
    #!/usr/bin/env python3
    
    import os
    import csv
    import time
    from argparse import ArgumentParser
    from tqdm import tqdm
    import traceback
    from utils import day_to_chinese, user_input_with_check, create_directory
    from downloader import download_m3u8, merge_videos
    from api import get_initial_data, get_m3u8_links
    
    def main(liveid=None, command='', single=0, merge=True):
        if liveid and not isinstance(liveid, int):
            liveid = int(liveid)
        elif not liveid:
            liveid = int(user_input_with_check(
                "请输入 liveId:",
                lambda liveid: liveid.isdigit() and len(liveid) <= 10
            ))
    
            single = user_input_with_check(
                "是否仅下载单节课视频?输入 y 下载单节课,n 下载这门课所有视频,s 则仅下载单集(半节课)视频,直接回车默认单节课 (Y/n/s):",
                lambda single: single.lower() in ['', 'y', 'n', 's']
            ).lower()
            if single in ['', 'y']:
                single = 1
            elif single == 's':
                single = 2
            else:
                single = 0
    
            if single != 2:
                merge = user_input_with_check(
                    "是否自动合并上下半节课视频?输入 y 合并,n 不合并,直接回车默认合并 (Y/n):",
                    lambda merge: merge.lower() in ['', 'y', 'n']
                ).lower() != 'n'
        else:
            if single > 2:
                single = 2
    
        data = get_initial_data(liveid)
    
        if not data:
            print("没有找到数据,请检查 liveId 是否正确。")
            return
    
        if single:
            matching_entry = next(
                filter(lambda entry: entry["id"] == liveid, data))
    
            if not matching_entry:
                raise ValueError("No matching entry found for the specified liveId")
    
            if single == 1:
                start_time = matching_entry["startTime"]
                data = list(filter(
                    lambda entry: entry["startTime"]["date"] == start_time["date"] and
                    entry["startTime"]["month"] == start_time["month"],
                    data))
            else:
                data = [matching_entry]
    
        first_entry = data[0]
        start_time = first_entry["startTime"]["time"]
        course_code = first_entry["courseCode"]
        course_name = first_entry["courseName"]
    
        start_time_unix = start_time / 1000
        start_time_struct = time.gmtime(start_time_unix)
        year = start_time_struct.tm_year
    
        save_dir = f"{year}年{course_code}{course_name}"
        create_directory(save_dir)
    
        csv_filename = f"{year}年{course_code}{course_name}.csv"
    
        rows = []
        for entry in tqdm(data, desc="获取视频链接"):
            live_id = entry["id"]
            days = entry["days"]
            day = entry["startTime"]["day"]
            jie = entry["jie"]
    
            start_time = entry["startTime"]["time"]
            start_time_unix = start_time / 1000
            start_time_struct = time.gmtime(start_time_unix)
            month = start_time_struct.tm_mon
            date = start_time_struct.tm_mday
    
            ppt_video, teacher_track = get_m3u8_links(live_id)
    
            row = [month, date, day, jie, days, ppt_video, teacher_track]
            rows.append(row)
    
        with open(csv_filename, mode='w', newline='') as file:
            writer = csv.writer(file)
            writer.writerow(['month', 'date', 'day', 'jie', 'days', 'pptVideo', 'teacherTrack'])
            writer.writerows(rows)
    
        print(f"{csv_filename} 文件已创建并写入数据。")
    
        def process_rows(rows):
            for i in range(0, len(rows), 2):
                row1 = rows[i]
                month1, date1, day1, jie1, days1, ppt_video1, teacher_track1 = row1
                day_chinese1 = day_to_chinese(day1)
    
                row2 = rows[i + 1] if i + 1 < len(rows) else None
                if row2:
                    month2, date2, day2, jie2, days2, ppt_video2, teacher_track2 = row2
                    day_chinese2 = day_to_chinese(day2)
    
                ppt_video_files = []
                if ppt_video1:
                    filename1 = f"{course_code}{course_name}{year}年{month1}月{date1}日第{days1}周星期{day_chinese1}第{jie1}节-pptVideo.ts"
                    filepath1 = os.path.join(save_dir, filename1)
                    if not os.path.exists(filepath1):
                        download_m3u8(ppt_video1, filename1, save_dir, command=command)
                    ppt_video_files.append(filepath1)
    
                if ppt_video2:
                    filename2 = f"{course_code}{course_name}{year}年{month2}月{date2}日第{days2}周星期{day_chinese2}第{jie2}节-pptVideo.ts"
                    filepath2 = os.path.join(save_dir, filename2)
                    if not os.path.exists(filepath2):
                        download_m3u8(ppt_video2, filename2, save_dir, command=command)
                    ppt_video_files.append(filepath2)
    
                if len(ppt_video_files) == 2 and merge:
                    ppt_merged_filename = f"{course_code}{course_name}{year}年{month1}月{date1}日第{days1}周星期{day_chinese1}第{jie1}-{jie2}节-pptVideo.ts"
                    ppt_merged_filepath = os.path.join(save_dir, ppt_merged_filename)
                    merge_videos(ppt_video_files, ppt_merged_filepath)
    
                teacher_track_files = []
                if teacher_track1:
                    filename1 = f"{course_code}{course_name}{year}年{month1}月{date1}日第{days1}周星期{day_chinese1}第{jie1}节-teacherTrack.ts"
                    filepath1 = os.path.join(save_dir, filename1)
                    if not os.path.exists(filepath1):
                        download_m3u8(teacher_track1, filename1, save_dir, command=command)
                    teacher_track_files.append(filepath1)
    
                if teacher_track2:
                    filename2 = f"{course_code}{course_name}{year}年{month2}月{date2}日第{days2}周星期{day_chinese2}第{jie2}节-teacherTrack.ts"
                    filepath2 = os.path.join(save_dir, filename2)
                    if not os.path.exists(filepath2):
                        download_m3u8(teacher_track2, filename2, save_dir, command=command)
                    teacher_track_files.append(filepath2)
    
                if len(teacher_track_files) == 2 and merge:
                    teacher_merged_filename = f"{course_code}{course_name}{year}年{month1}月{date1}日第{days1}周星期{day_chinese1}第{jie1}-{jie2}节-teacherTrack.ts"
                    teacher_merged_filepath = os.path.join(save_dir, teacher_merged_filename)
                    merge_videos(teacher_track_files, teacher_merged_filepath)
    
        if single == 1:
            process_rows(rows[:2])
        elif single == 2:
            row = rows[0]
            month, date, day, jie, days, ppt_video, teacher_track = row
            day_chinese = day_to_chinese(day)
    
            if ppt_video:
                filename = f"{course_code}{course_name}{year}年{month}月{date}日第{days}周星期{day_chinese}第{jie}节-pptVideo.ts"
                filepath = os.path.join(save_dir, filename)
                if not os.path.exists(filepath):
                    download_m3u8(ppt_video, filename, save_dir, command=command)
    
            if teacher_track:
                filename = f"{course_code}{course_name}{year}年{month}月{date}日第{days}周星期{day_chinese}第{jie}节-teacherTrack.ts"
                filepath = os.path.join(save_dir, filename)
                if not os.path.exists(filepath):
                    download_m3u8(teacher_track, filename, save_dir, command=command)
    
        else:
            process_rows(rows)
    
        print("所有视频下载和处理完成。")
    
    def parse_arguments():
        parser = ArgumentParser(description="用于下载西安电子科技大学录直播平台课程视频的工具")
        parser.add_argument('liveid', nargs='?', default=None, help="课程的 liveId,不输入则采用交互式方式获取")
        parser.add_argument('-c', '--command', default='', help="自定义下载命令,使用 {url}, {save_dir}, {filename} 作为替换标记")
        parser.add_argument('-s', '--single', action='count', default=0, help="仅下载单节课视频(-s:单节课视频,-ss:半节课视频)")
        parser.add_argument('--no-merge', action='store_false', help="不合并上下半节课视频")
    
        return parser.parse_args()
    
    if __name__ == "__main__":
        args = parse_arguments()
        try:
            main(liveid=args.liveid, command=args.command, single=args.single, merge=args.no_merge)
        except Exception as e:
            print(f"发生错误:{e}")
            print(traceback.format_exc())
    
    downloader.py:下载视频和合并视频的函数
    #!/usr/bin/env python3
    
    import subprocess
    import sys
    import os
    import traceback
    
    def download_m3u8(url, filename, save_dir, command=''):
        if not command:
            if sys.platform.startswith('win32'):
                command = f'vsd-upx.exe save {url} -o {save_dir}\{filename} --retry-count 32 -t 16'
            else:
                command = f'./vsd-upx save {url} -o {save_dir}/{filename} --retry-count 32 -t 16'
        else:
            command = command.format(url=url, filename=filename, save_dir=save_dir)
    
        MAX_ATTEMPTS = 2
    
        for attempt in range(MAX_ATTEMPTS):
            try:
                subprocess.run(command, shell=True, check=True)
                break
            except subprocess.CalledProcessError:
                print(f"第 {attempt+1} 次下载 {filename} 出错:\n{traceback.format_exc()}\n重试中...")
                if attempt == MAX_ATTEMPTS - 1:
                    print(f"下载 {filename} 失败。")
    
    def merge_videos(files, output_file):
        if sys.platform.startswith('win32'):
            command = f'vsd-upx.exe merge -o {output_file} {" ".join(files)}'
        else:
            command = f'./vsd-upx merge -o {output_file} {" ".join(files)}'
    
        try:
            subprocess.run(command, shell=True, check=True)
            print(f"合并完成:{output_file}")
            for file in files:
                os.remove(file)
        except subprocess.CalledProcessError:
            print(f"合并 {output_file} 失败:\n{traceback.format_exc()}")
    
    api.py:获取课程数据和 m3u8 链接的函数
    #!/usr/bin/env python3
    
    import requests
    import urllib.parse
    import json
    
    def get_initial_data(liveid):
        url = "http://newesxidian.chaoxing.com/live/listSignleCourse"
        headers = {
            "User-Agent": "Mozilla/5.0",
            "Cookie": "UID=2"
        }
        data = {
            "liveId": liveid
        }
    
        response = requests.post(url, headers=headers, data=data)
        response.raise_for_status()
        return response.json()
    
    def get_m3u8_links(live_id):
        url = f"http://newesxidian.chaoxing.com/live/getViewUrlHls?liveId={live_id}&status=2"
        headers = {
            "User-Agent": "Mozilla/5.0",
            "Cookie": "UID=2"
        }
    
        response = requests.get(url, headers=headers)
        response.raise_for_status()
        response_text = response.text
    
        url_start = response_text.find('info=')
        if url_start == -1:
            raise ValueError("info parameter not found in the response")
    
        encoded_info = response_text[url_start + 5:]
        decoded_info = urllib.parse.unquote(encoded_info)
        info_json = json.loads(decoded_info)
    
        video_paths = info_json.get('videoPath', {})
        ppt_video = video_paths.get('pptVideo', '')
        teacher_track = video_paths.get('teacherTrack', '')
    
        return ppt_video, teacher_track
    
    utils.py:一些工具函数,包含日期汉字转换、输入数据检查、目录创建
    #!/usr/bin/env python3
    
    import os
    
    def day_to_chinese(day):
        days = ["日", "一", "二", "三", "四", "五", "六"]
        return days[day]
    
    def user_input_with_check(prompt, check_func):
        while True:
            user_input = input(prompt)
            if check_func(user_input):
                return user_input
            else:
                print("输入错误,请重新输入:")
    
    def create_directory(directory):
        os.makedirs(directory, exist_ok=True)
    
  • 为了方便打包版本同步主分支代码,我新建了一个 windows-pack 分支,时不时 rebase 一下。和主分支区别如下:

    • XDUClassVideoDownloader.py 末尾添加了等待输入,防止窗口自己关闭。
    • downloader.py 中的 download_m3u8 函数使用绝对路径而不是相对路径来调用 vsd-upx.exe
    • utils.py 中增加 resource_path 函数,用于获取二进制文件路径。

使用演示

  • 打开最新 Release 页面,下载最新版本的 XDUClassVideoDownloader.exe 文件。
  • 双击运行 XDUClassVideoDownloader.exe,按照提示输入 liveId,选择是否下载单节课视频,选择是否合并上下半节课视频。
  • 等待下载完成,下载的视频在当前目录下的 年份+课程代码+课程名称 文件夹中,下载用到的 m3u8 链接和对应的课程时间信息保存在同名 csv 表格中。

2024-07-07T14:48:24.png

写在后面

  • 最新的版本是 v1.0.0-beta,感觉基本上功能完善了,没啥需要改的了。
  • 以后要是想到什么新功能再加吧,不过现在这个版本已经够用了。
  • 大家要是有什么问题或者建议可以发 Issue 或者直接 QQ 找我。
  • 我第一次在 GitHub 上有一个这么多 Star 的项目,开心捏。😋
  • 编了这么多话可真是辛苦我了呢,那就写到这里吧~
关于 XDUClassVideoDownloader 的开发

https://blog.lsy223622.com/archives/56/

作者

木生睡不着

发布时间

2024-07-07

经验 ChatGPT GitHub Python 脚本 开发
  1. NanCunChild 07-17

    Linux执行python脚本也可以不需要Shebang 还有怎么不提一下写了JAVA脚本的我?差评取关(恼

    1. 木生睡不着 (作者)  07-25
      @NanCunChild

      好像确实是说不一定要有 shebang,但是既然可能有用那就还是加着吧。 你的 java 版和我的 py 脚本有什么关系😋要不把我后面的更新内容也同步一下

Theme Jasmine