Install and update

Install Tatu for macOS or Linux, on arm64 or amd64 (Intel/AMD). You do not need root access.

curl -fsSL https://get.tatu.codes/install.sh | bash

The script downloads the binary for your system, verifies its SHA-256 against the release manifest, and installs it at ~/.local/bin/tatu. Run it without sudo.

In a terminal, the installer lists each step as it finishes: your platform, the version, the download with a progress bar, the checksum, and the install. When its output is not a terminal (a pipe, a log, CI), it prints the same steps as plain lines with no colors or redrawn lines. Set NO_COLOR=1 to keep the layout without colors.

If ~/.local/bin is not on your PATH, the installer prints a command for your shell. Run that command and open a new terminal. Then check your version:

tatu -version

Install a specific version

Pass a version after bash -s. For example:

curl -fsSL https://get.tatu.codes/install.sh | bash -s 0.2.0

Without a version, the script installs the latest release.

Update

tatu update

This replaces the binary you are running with the latest release and shows the same steps as the installer, including a progress bar for the download. If you already have the latest version, it prints tatu <version> is up to date. A failed checksum leaves the installed binary unchanged.

To switch to a specific release, use tatu update 0.2.0 with the version you want.

Update notices

Interactive sessions check for a newer release in the background. A successful check is cached for a day. When a newer version exists, Tatu shows a notice telling you to run tatu update; it does not install the update automatically.

To turn off this check, set updateCheck to false in ~/.tatu/settings.json:

{
  "updateCheck": false
}

You can also set TATU_NO_UPDATE_CHECK=1. See Settings for how to edit an existing settings file.

A local build made with make reports its version as dev and does not check for updates. Running tatu update explicitly still replaces that build with a release.

The desktop app on macOS

The desktop app also runs on a Mac with Apple Silicon, on macOS 12 or later. Download the disk image from the download page, open it and drag Tatu to Applications. It bundles the same tatu, so it needs nothing else, and it updates itself. See The desktop app.

The desktop app on Linux

The Tatu desktop app also runs on Linux (amd64 and arm64; Ubuntu 22.04, Debian 12, Fedora 36 or newer). It bundles the same tatu, so it needs nothing else.

curl -fsSL https://get.tatu.codes/app/install-linux.sh | bash

The script checks the download against the release manifest, installs the app under ~/.local/share/tatu-app, adds Tatu to your applications menu and a tatu-app command in ~/.local/bin. It needs no root. To install a specific version, pass it after bash -s; to remove the app, pass uninstall. Your sessions and settings in ~/.tatu are not touched.

curl -fsSL https://get.tatu.codes/app/install-linux.sh | bash -s uninstall

The app tells you when a newer version is out: an Update available row appears in the sidebar, and it leads back to this page. To update, run the install command again. The check follows the same settings as the terminal one: updateCheck: false or TATU_NO_UPDATE_CHECK=1 turns it off.

To pair a phone or another computer, the app keeps its keys in your system keyring (GNOME Keyring or KWallet). Without one it keeps them in ~/.tatu/app-pairing.json, readable only by you.