course2md README

The project's README from github.com/mizorewww/course2md. As one markdown file: README.md.

course2md

Turn YouTube, Bilibili, or local videos into illustrated Markdown / HTML notes. Add a video in the desktop app, generate notes, then organize and read them in your course library.

English · 中文 · GitHub Wiki

Try 2.0 RC2: 2.0.0-rc.2 release notes and installation. Use the course2md-gui@rc Homebrew cask; the default installation options below provide the stable release.

Features

Install the desktop app (GUI)

Choose one installation method for your system below. The GUI includes its conversion engine; no separate CLI install is needed.

macOS: Apple Silicon, macOS 15 or later

If you have Homebrew: run this in Terminal to install the app and the video tools ffmpeg and yt-dlp:

brew install --cask mizorewww/tap/course2md-gui

After installation, open course2md from Finder → Applications.

Manual installation: download the macOS installer (DMG), open it, and drag course2md.app to Applications. This installs only the app; install video tools separately using the macOS installation guide.

Arch Linux / CachyOS: x86_64

If you have yay, run this to install the desktop app, video tools and required graphics libraries:

yay -S course2md-gui-bin

With paru, run paru -S course2md-gui-bin. Open course2md from your applications menu. Your graphics hardware needs a working Vulkan driver; see the Linux installation guide.

Windows: x64

  1. Download the Windows portable package (ZIP) and extract everything to a permanent folder.

  2. Install video tools in PowerShell:

    winget install --id Gyan.FFmpeg -e
winget install --id yt-dlp.yt-dlp -e

  3. Open course2md-desktop.exe from the extracted folder. Keep course2md.exe beside it: this is the bundled engine. If the app was already open, quit and reopen it after installing tools.

Ubuntu / other Linux distributions: x86_64

Download the Linux desktop package (tar.gz), install video tools and graphics libraries using the Linux installation guide, then extract everything. Enter the extracted folder and run ./course2md-desktop. Keep the course2md engine in the same folder.

The prebuilt package is based on Ubuntu 24.04. Intel Mac and Linux ARM64 do not yet have prebuilt GUIs; use the CLI version. GitHub's Source code archives are developer sources, not app installers.

First use

  1. Open course2md and follow the setup guide to choose a notes folder and speech recognition method.
  2. Check Settings → Runtime environment. ffmpeg (including ffprobe) processes video; yt-dlp handles online videos.
  3. Add a video URL or local file and start conversion. Open the finished notes in your library.

Local recognition downloads models on first use. GPU / CPU recognition also needs llama-server; cloud recognition requires your own API configuration. The app provides setup controls; see the first-launch guide for details.

Install the CLI

The CLI and the desktop app share one configuration file and can be installed side by side.

macOS / Linux (prebuilt binary):

curl -fsSL https://raw.githubusercontent.com/mizorewww/course2md/main/install.sh | bash

This installs course2md into ~/bin (override with COURSE2MD_BIN_DIR) and checks dependencies. Also available: Homebrew brew install mizorewww/tap/course2md; Arch Linux yay -S course2md-bin (x86_64, aarch64); or from source with cargo install --path . (Rust stable).

ffmpeg (including ffprobe) is always required, yt-dlp for online links, and llama-server for GPU/CPU recognition — except on the macOS Apple-Silicon package, whose CoreML backend needs no extra runtime. Run course2md doctor to check everything.

Quick start

course2md ./lecture.mp4                        # local file
course2md https://www.youtube.com/watch?v=…    # or a Bilibili link
course2md ./lecture.mp4 -o ./notes             # choose the output root

The first conversion in a terminal offers interactive setup; scripts should pass options explicitly. Each note is created under the output root as platform/title/ID/, containing course.md, course.html and the screenshots.

Common commands

Command Purpose
course2md <URL or file> Convert a video into notes
course2md --login bilibili / --logout bilibili Scan a QR code to log in to Bilibili / remove the saved login
course2md doctor Check tools, speech backends and settings
course2md config init / config show Create a configuration template / show the config path and settings
course2md models list / models prepare Check downloaded models / pre-download a model
course2md llm setup / llm status / llm disable Configure, inspect or turn off AI proofreading
course2md summarize ./notes Add AI summaries to existing notes
course2md run-task Execute a saved task from stdin JSON (used by the GUI engine)

Use <command> --help for each command's options.

Configuration

The configuration file is ~/.config/course2md/config.toml (%APPDATA%\course2md\config.toml on Windows; XDG_CONFIG_HOME is respected). Precedence: command-line arguments > config.toml > built-in defaults. course2md config init writes a template to get started. AI proofreading is optional and off by default: course2md llm setup saves the endpoint, key and model, and course2md remove clears saved AI service settings.

Frequently asked questions

Conversion fails with a missing ffmpeg. Install ffmpeg (it includes ffprobe) and yt-dlp for online links — for example brew install ffmpeg yt-dlp on macOS — then run course2md doctor to confirm.

A Bilibili video fails or comes back in low quality. Run course2md --login bilibili and scan the QR code; --logout bilibili removes the saved login.

How large are the model downloads? The first local recognition downloads the model automatically: about 1–2.3 GB for macOS CoreML models (cached in ~/Library/Caches/qwen3-speech/) and about 2.4 GB for the llama.cpp GGUF (cached in ~/.cache/course2md/models/). Pre-download with course2md models prepare, or inspect the cache with course2md models inspect.

Documentation and help

All documentation (GitHub Wiki) · CLI installation and usage · Upgrade and uninstall · Troubleshooting · Report a problem

For developers: desktop build guide · development discipline · architecture · benchmarks · packaging and releases · Changelog · MIT license

course2md (mizorewww/course2md)

Searching Database…

427 ·GitHub
Course2md
Что это?course2md превращает записи курсов и встреч с YouTube, Bilibili или локальные в конспекты лекций в Markdown и HTML с иллюстрациями-слайдами: при каждой смене слайда делается скриншот, а под ним размещается расшифровка.
Это десктопное приложение или инструмент командной строки?И то, и другое. Есть десктопное GUI-приложение со встроенным движком конвертации и отдельный CLI; они используют один файл конфигурации и могут быть установлены рядом.
Как его запустить?На Mac с Apple Silicon установите cask через Homebrew или скачайте DMG; на Windows скачайте портативный ZIP и запустите course2md-desktop.exe; на Arch Linux используйте yay/paru, на других Linux — пакет tar.gz. CLI также можно установить через скрипт с готовым бинарником, Homebrew, yay или 'cargo install --path .'.
Нужно ли отдельно устанавливать ffmpeg и yt-dlp?Да — ffmpeg (включая ffprobe) нужен всегда, yt-dlp — для ссылок на онлайн-видео, а llama-server — для распознавания речи на GPU/CPU; исключение — пакет для macOS Apple Silicon, чьему бэкенду CoreML не нужен дополнительный runtime.
Работает ли он на Intel Mac или Linux ARM64?Пока нет готовой GUI-сборки — на этих платформах придётся использовать CLI-версию, пока не появится сборка с GUI.
Куда деваются мои видео/аудио-данные при распознавании речи?Локальное распознавание речи (бэкенды CoreML, Intel NPU или llama.cpp) оставляет все данные на вашей машине; ничего не покидает устройство, если вы явно не настроите облачный API-бэкенд.
Как устроен формат конспектов со слайдами?course2md делает скриншот при каждом изменении визуального содержимого видео и раскладывает расшифровку абзацами под каждым скриншотом, экспортируя всё в course.md и course.html (опционально JSON с --formats).
Может ли он логиниться в Bilibili, чтобы починить неудачные или низкокачественные загрузки?Да, 'course2md --login bilibili' показывает QR-код для сканирования при входе, а '--logout bilibili' удаляет сохранённую сессию; это решение для видео Bilibili, которые не скачиваются или скачиваются в низком качестве.
Есть ли встроенная ИИ-вычитка или суммаризация?Опциональные ИИ-вычитка и суммаризация работают через любой OpenAI-совместимый endpoint и настраиваются командой 'course2md llm setup'; функция по умолчанию выключена, поэтому API-ключ не нужен, пока вы её не включите.
Что происходит, если конвертацию прервать?Конвертацию можно продолжить благодаря чекпоинтам речи и флагу --resume, а CLI также поддерживает вывод прогресса в NDJSON и тихий режим для скриптов.
What are similar projects?stemkit, omarchy-meeting-recorder, pickoo-your-favorites, parrot, better-voice, phorminx, pyvideotrans, autoclip
Which topics is it in?linux-app, transcription, speech-to-text, youtube, speech-recognition, note-taking, video-processing, ffmpeg, macos-app, homebrew, windows-app, apple-silicon
Creator
mizorewww
Size
41.7 MB
Stars
427
Updated
CommitOct 15Releasev1.7.0Sep 06
Age
1mo
Commits · 90 Days