Skip to content

v1.7.0

Latest
Latest

Choose a tag to compare

View all tags
@github-actions github-actions released this 06 Sep 14:56
v1.7.0
This tag was signed with the committer’s verified signature.
mizorewww
GPG key ID: 0161BB7D23FB7918
Verified
Learn about vigilant mode.
6881a1b
This commit was signed with the committer’s verified signature.
mizorewww
GPG key ID: 0161BB7D23FB7918
Verified
Learn about vigilant mode.

v1.7.0：桌面课程库、首次引导与 Bilibili 扫码登录

  • 首次启动引导选择识别方式和笔记目录，缺少工具时提供安装帮助。
  • 课程库支持列表、卡片和文件夹分组，记住展示偏好；移动或删除逻辑文件夹不会删除笔记文件。
  • 在桌面设置或 Bilibili 来源页扫码登录、检查账号状态和恢复过期会话；CLI 与 GUI 共享登录状态。
  • 设置按用途分组并自动保存，改进导出格式校验、任务进度、控件对齐、无障碍名称和减少动态效果。
  • CLI 新增 GPU 卸载控制；修复 CPU 模式卸载保护、Bilibili 412 重试、文件锁和失败诊断记录。

先选 GUI 或 CLI

想用窗口操作，下载 GUI。想在终端或脚本中运行，安装 CLI。GUI 已内置同版本 CLI，无需另装 CLI 才能使用窗口；Homebrew Formula course2md、AUR course2md-bin 与 install.sh 安装的是独立 CLI，不会安装桌面应用，也不会由 GUI 自动添加终端命令。

GUI 安装

推荐包管理器（自动安装视频工具）：

  • macOS Apple Silicon：brew install --cask mizorewww/tap/course2md-gui
  • Arch Linux / CachyOS x86_64：yay -S course2md-gui-bin（也可使用 paru）

详细的 GUI 指南与 CLI 指南已分开维护。

系统 下载文件 安装与启动
macOS Apple Silicon（M 系列，建议 macOS 15+） course2md-gui-macos-arm64.dmg 打开 DMG，将 course2md.app 拖入「应用程序」，再从那里启动
Windows x64 course2md-desktop-windows-AMD64.zip 完整解压，打开其中的 course2md-desktop.exe；保留旁边的 course2md.exe
Linux x64（Ubuntu 24.04 构建） course2md-desktop-linux-x86_64.tar.gz 解压，在目录中运行 ./course2md-desktop；保留旁边的 course2md

macOS ZIP 是同一应用的备用分发格式。Intel Mac 与 Linux ARM64 本次提供独立 CLI，没有对应的预编译 GUI。GitHub 自动生成的 Source code 压缩包是源码，不能直接当应用打开。

GUI 和 CLI 都需要外部视频工具：ffmpeg（包含 ffprobe）；在线视频另需 yt-dlp。macOS 可运行 brew install ffmpeg yt-dlp；Windows 可运行 winget install --id Gyan.FFmpeg -e 与 winget install --id yt-dlp.yt-dlp -e；Ubuntu 可运行 sudo apt install ffmpeg yt-dlp。安装后重新打开应用或终端，让 PATH 更新生效。

首次打开 GUI：按引导选择笔记目录和识别方式 → 在「设置 → 运行环境」确认依赖 → 添加链接或本地视频 → 生成笔记。Bilibili 可从「设置 → 连接账号」扫码登录。Apple 原生识别首次下载模型；本地 GPU/CPU 识别需额外安装 llama-server 及模型；云端 API 需配置自己的端点、密钥与模型。有可用字幕时默认优先使用字幕。详细依赖见中文安装指南。

CLI 安装

  • macOS / Homebrew：brew install mizorewww/tap/course2md。升级使用 brew update && brew upgrade course2md。
  • Arch / CachyOS：yay -S course2md-bin（CLI 包）。
  • macOS / Linux 脚本安装：先按安装指南准备依赖，再运行 curl -fsSL https://raw.githubusercontent.com/mizorewww/course2md/v1.7.0/install.sh | bash。脚本下载最新正式版到 ~/bin，请将该目录加入 PATH；脚本检查依赖，非 Apple Silicon 平台还要求 llama-server。
  • Windows x64：下载 course2md-windows-x86_64.exe，改名为 course2md.exe，放入已加入 PATH 的目录。PowerShell 在当前目录执行时使用 ./course2md.exe。
  • 手动下载：macOS 提供 course2md-macos-arm64 / course2md-macos-x86_64；Linux 提供 course2md-linux-x86_64 / course2md-linux-aarch64。Unix 下载后改名为 course2md 并赋予执行权限。Apple Silicon 还需下载 mlx-macos-arm64.metallib，改名为 mlx.metallib，与 CLI 放在同一目录。

安装后验证并开始转换：

course2md --version
course2md doctor
course2md ./lecture.mp4

首次交互运行会引导配置识别后端。包管理器可能稍晚同步；如果版本仍旧，请用本 Release 的对应文件安装。

升级

退出旧 GUI 后替换应用或完整解压新版目录，避免混用新旧 GUI/CLI 文件。已有共享配置和课程输出继续使用；无需删除配置、登录凭据或模型缓存。独立 CLI 与 GUI 分别升级，并用 course2md --version 和 GUI「关于」确认版本。

English installation guide

Choose GUI for a desktop window, or CLI for terminals and scripts. GUI packages bundle the matching engine; the Homebrew course2md formula, AUR course2md-bin and install.sh install only the standalone CLI. Installing the GUI does not add course2md to your shell PATH.

  • GUI package managers: brew install --cask mizorewww/tap/course2md-gui (Apple Silicon) or yay -S course2md-gui-bin (Arch x64). These install the desktop app and video tools.
  • GUI manual downloads: use the platform download table above. On Apple Silicon, open the DMG and drag the app to Applications. On Windows/Linux, extract the entire archive and keep the desktop executable beside its bundled CLI. Intel Mac and Linux ARM64 have standalone CLI builds only. “Source code” archives are for developers.
  • Dependencies: install ffmpeg/ffprobe; online videos also need yt-dlp. Restart the app/terminal after installing tools. Local GPU/CPU recognition additionally needs llama-server and models; Apple-native recognition downloads models on first use; cloud recognition requires your API configuration.
  • First launch: complete the setup guide, check Settings → Runtime environment, add a URL or local video, then generate notes. Bilibili QR login is available in account settings.
  • CLI: brew install mizorewww/tap/course2md (macOS), yay -S course2md-bin (Arch), or use the standalone release binary for your OS/architecture. Rename it to course2md (course2md.exe on Windows) and add its directory to PATH. On Unix, make it executable. Apple Silicon manual installs also require mlx-macos-arm64.metallib, renamed to mlx.metallib, beside the CLI.
  • Verify: run course2md --version, course2md doctor, then course2md ./lecture.mp4. See the full installation guide for backend setup.
  • Upgrade: quit the old app and replace the whole app/archive. Upgrade standalone CLI separately. Existing settings, notes and model caches remain usable. Package-manager updates may follow the GitHub release with a short delay.

Full Changelog: v1.6.0...v1.7.0

Assets 12
Loading