release/0.22.1 v4.0.0
mercurjs/mercurAug 24, 2026 → Aug 25, 20261 day between releases
What's New
Major 4.0.0 jump rebuilds the app as an SPA with sidebar navigation, but the two release notes describe seemingly unrelated product areas, so the delta is uncertain.
Breaking Changes
- Version jumps from 0.22.1 to 4.0.0, a major-version boundary that signals incompatible changes.
- The UI is rearchitected as a Single Page Application with sidebar navigation, replacing the previous navigation model and redesigning many UI elements.
- Download/format handling now can rely on system-installed yt-dlp, ffmpeg and ffprobe, which may change behavior versus bundled binaries.
New Features
- Batch download support on the homepage, plus an auto-download option for media.
- Selective playlist mode for choosing which playlist items to fetch.
- Global hotkey support and UI zoom controls in preferences.
- Windows Arm build target added.
- Ability to view the underlying yt-dlp command and choose the yt-dlp release channel.
Improvements
- Faster download start speed and improved default format selection.
- Video bitrate now displayed in the format list, with an option to set output format.
- Updater UI and language selection reworked; update channels can be selected.
- Support for pasting individual site cookies and an improved output template setting.
- Compressor page and playlist download-item/menu UI optimized.
Bug Fixes
- Release notes list only a generic 'bug fixes' entry with no specifics, so individual fixes cannot be enumerated.
Upgrade Notes
Treat this as a major upgrade: expect a redesigned SPA interface and verify any workflow that depended on the old navigation. If you rely on bundled download tooling, confirm whether system yt-dlp/ffmpeg/ffprobe are now preferred and pin versions accordingly. The release notes for the two versions appear to cover different product surfaces, so validate behavior directly rather than relying on this diff.
The Two Releases
release/0.22.1
Aug 24, 2026· 2 months ago
Update focusing on macOS navigation, conflict resolution tools, CLI workflow enhancements, and TUI performance improvements.
Full release notesv4.0.0
Aug 25, 2026· 2 months ago
A major version release transforming the application into a Single Page Application with a sidebar, introducing batch downloads, selective playlist modes, and deep integration with system tools like yt-dlp and ffmpeg.
Full release notes