YTDock v0.8.1

macOS 14+ / Apple Silicon. Python and QuickJS bundled; FFmpeg/ffprobe external.

Validated by automated tests and isolated package smoke checks. Online YouTube downloading and real cross-version self-upgrade are not verified by this workflow. Ad-hoc signed, not Apple-notarized.

Install/update: curl -fsSL https://raw.githubusercontent.com/GrahamQuan/ytdock/main/install.sh | bash

Full Changelog: v0.8.0...v0.8.1

YTDock v0.8.0

YTDock v0.8.0

macOS 14+ / Apple Silicon (arm64).

Install or update

curl -fsSL https://raw.githubusercontent.com/GrahamQuan/ytdock/main/install.sh | bash

Version 0.7.1 does not include --upgrade; use the installer above to update. Exit running YTDock instances first. Python and QuickJS are bundled; FFmpeg and ffprobe remain external dependencies.

Changes

• Add --version / -v, stable-release --upgrade, and visible startup checks.
• Tab / Shift+Tab now cycles focus; left/right switches pages only when navigation is focused. Current tabs have a green background; navigation focus uses a green outline.
• Download panels retain independent resolution and subtitle settings. Enter starts downloading only in the confirmation panel.
• Use consistent picture-stream timing for downloaded and local subtitles; report precise end-time corrections.
• Fix false duration verification failures caused by rounded YouTube metadata. Errors identify the failed check.

Packages and validation

ZIP and tar.gz contain identical files, each with a SHA256 checksum. Both support installation and removal without sudo. Validated locally on macOS arm64 with isolated installation, bundled version queries, terminal/launcher startup, language selection, compression, subtitles, cancellation, reinstall and uninstall checks.

Ad-hoc signed, not Developer ID signed or Apple-notarized. Intel and another Mac are not validated. Real cross-version --upgrade binary replacement is not yet validated; controlled updater/rollback tests and reinstall checks are covered.

---

新增版本查询、应用升级、启动检查反馈；统一 Tab 焦点与导航操作；修复字幕时长一致性和 YouTube 整秒时长造成的误拒绝。旧版 0.7.1 请重新运行上方一键安装命令升级。外部 FFmpeg 不会自动安装或修改，用户视频不受影响。

Release verification results

• 356 source tests passed; Ruff and formatting checks passed.
• Final frozen package passed isolated install, version queries, external-tool detection, interactive launch/language, compression, HEVC subtitle rendering, cancellation, reinstall and uninstall checks. Installed size: approximately 57 MiB.
• Online release smoke tests for jNQXAC9IVRw and A7MSwdXj86k were blocked by YouTube login-required responses. Source-mode extraction of the latter also failed during this release run. Fresh online downloading is therefore not verified for this release, despite earlier source-level successful checks. Login/cookie import remains unsupported.

本次发布验收期间两个视频均返回需要登录，源码模式也遇到同样响应，因此不将新版安装包的联网下载标记为通过；离线媒体处理、安装卸载及取消清理已通过。

Public post-release check passed: the documented curl installer downloaded v0.8.0 from GitHub, verified SHA256 and installed into an isolated HOME. --version reported 0.8.0, --upgrade correctly reported already current without reinstalling, and --uninstall removed only the test installation.

YTDock v0.7.1

YTDock 0.7.1 — first public macOS release.

Download a single YouTube video, compress a local video, or burn local SRT subtitles through a bilingual full-screen CLI. Includes task records, bidirectional Tab navigation and conservative audio-track selection.

Install

curl -fsSL https://raw.githubusercontent.com/GrahamQuan/ytdock/main/install.sh | bash

Then open a new terminal and run ytdock, or run ~/.local/bin/ytdock immediately. For manual installation, download the ZIP, extract it completely and open Install.command.

• macOS 14+ on Apple Silicon (arm64).
• Python, QuickJS, yt-dlp/ejs and UI dependencies are bundled.
• Compatible FFmpeg and ffprobe are external dependencies. With Homebrew: brew install ffmpeg.
• Uninstall with ytdock --uninstall; downloaded videos and external FFmpeg are retained.
• Ad-hoc signed; not Apple notarized. Intel and another Mac have not been validated.

Validation

304 source tests passed. The installed executable passed isolated installation, terminal/launcher and language checks, real YouTube download, compression, generated subtitle burning, cancellation and output protection, upgrade and uninstall checks. ZIP and tar.gz contain the same files; SHA256 files check archive integrity, not publisher identity or Apple notarization.