Skip to content

Install

Terminal window
curl -fsSL https://vanitty.dev/install.sh | sh

Installs Vanitty.app in /Applications (or ~/Applications if you can’t write there). One universal build runs on Apple Silicon and Intel.

The script downloads the latest release and checks its SHA-256 before installing. To install a specific version, set VANITTY_VERSION first:

Terminal window
curl -fsSL https://vanitty.dev/install.sh | VANITTY_VERSION=26.10.0 sh

Vanitty checks for a new release in the background a few seconds after it starts and every six hours, and downloads it quietly. When it’s ready, a notice offers Restart to update. On macOS and with the AppImage the update is also applied when you quit, so the next launch is the new version.

To turn this off, add this to your settings:

"disableAutoUpdates": true

Builds from source (cargo install, the Arch package) never update themselves.

Terminal window
curl -fsSL https://vanitty.dev/install.sh | sh -s -- --uninstall

Your settings in ~/.config/vanitty (%APPDATA%\Vanitty on Windows) are kept.

Every GitHub release has:

Platform Files
Windows .exe (per-user setup), .msi
macOS (Apple Silicon and Intel) .dmg
Debian, Ubuntu .deb
Fedora, openSUSE .rpm
Any Linux .AppImage

The macOS build isn’t notarized yet, so macOS blocks a downloaded .dmg on first launch (the install script avoids this). After moving Vanitty to Applications, either open it once, then click Open Anyway in System Settings > Privacy & Security, or run:

Terminal window
xattr -dr com.apple.quarantine /Applications/Vanitty.app

Build the package from the repo:

Terminal window
git clone https://github.com/stasadance/vanitty
cd vanitty/packaging/arch
makepkg -si
Terminal window
cargo install vanitty

Needs Rust and the Tauri prerequisites. See Develop to work on Vanitty itself.

On first run, Vanitty imports your Hyper config (hyper.json or .hyper.js) if it finds one. Settings > Import Hyper Config does it again later.