Skip to content
Zonvie

Installation

Download the latest prebuilt binary from GitHub Releases.

Download

Section titled “Download”

Prebuilt binaries for macOS and Windows are attached to each release. Pick the asset that matches your platform, then unpack and run it.

You can also browse all releases to grab an earlier version.

Build from source

Section titled “Build from source”

macOS

Section titled “macOS”

Requires Xcode.

Terminal window
xcodebuild -project macos/zonvie.xcodeproj -scheme zonvie -configuration Release build

Windows

Section titled “Windows”

Requires Zig 0.15.x.

Terminal window
zig build windows -Dtarget=x86_64-windows-gnu -Doptimize=ReleaseFast

First run

Section titled “First run”

Run the first-launch setup and exit:

Terminal window
zonvie --install

What this does depends on your platform:

  • macOS — writes a default config.toml to your config directory.
  • Windows — writes the default config.toml and registers Zonvie’s file-association icon in the registry (HKEY_CURRENT_USER\Software\Classes\Applications\zonvie.exe\DefaultIcon). When you later set Zonvie as the default app for a file type (“Open with…”), Explorer uses that icon for those files.

See Configuration for the config file details.

Then open a file to check everything works:

Terminal window
zonvie file.txt