Install
curl -fsSL https://vanitty.dev/install.sh | shInstalls Vanitty.app in /Applications (or ~/Applications if you can’t write there). One universal build runs on Apple Silicon and Intel.
curl -fsSL https://vanitty.dev/install.sh | shInstalls the AppImage in ~/.local/share/vanitty, adds a menu entry and links a vanitty command in ~/.local/bin. No root needed. AppImages need FUSE, which most desktops have; install your distro’s fuse3 package if Vanitty doesn’t start. Builds are x86_64 only.
In PowerShell:
irm https://vanitty.dev/install.ps1 | iexRuns the per-user installer silently, so there’s no admin prompt. Vanitty then shows up in the Start menu.
The script downloads the latest release and checks its SHA-256 before installing. To install a specific version, set VANITTY_VERSION first:
curl -fsSL https://vanitty.dev/install.sh | VANITTY_VERSION=26.10.0 shUpdates
Section titled “Updates”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": trueBuilds from source (cargo install, the Arch package) never update themselves.
Uninstall
Section titled “Uninstall”curl -fsSL https://vanitty.dev/install.sh | sh -s -- --uninstallcurl -fsSL https://vanitty.dev/install.sh | sh -s -- --uninstallSettings > Apps > Installed apps > Vanitty > Uninstall.
Your settings in ~/.config/vanitty (%APPDATA%\Vanitty on Windows) are kept.
Manual download
Section titled “Manual download”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:
xattr -dr com.apple.quarantine /Applications/Vanitty.appArch Linux
Section titled “Arch Linux”Build the package from the repo:
git clone https://github.com/stasadance/vanittycd vanitty/packaging/archmakepkg -siFrom source
Section titled “From source”cargo install vanittyNeeds Rust and the Tauri prerequisites. See Develop to work on Vanitty itself.
Coming from Hyper
Section titled “Coming from Hyper”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.