Download

# Download

The newest stable version is on the
[latest release](https://github.com/igor-alexandrov/tabletist/releases/latest)
page. Every version, pre-releases included, is on the
[releases page](https://github.com/igor-alexandrov/tabletist/releases).
Each release lists its files with a `checksums.txt`, which you can use to
check that a download was not damaged or changed, and `checksums.txt.sig`,
its signature by the Tabletist release key.

## macOS

Tabletist needs macOS 11 or later, on Apple Silicon or Intel. With
[Homebrew](https://brew.sh):

```sh
brew install --cask igor-alexandrov/tabletist/tabletist
```

Or download `tabletist-v<version>-macos-universal.dmg`, open it and drag
**Tabletist** to **Applications**.

To update, choose **Tabletist → Check for Updates…**, then **Download and
install**: the new version goes in when you restart. Tabletist updates
itself only when it runs from **Applications**, not from the disk image.
Installed with Homebrew, it updates itself the same way, and
`brew upgrade --greedy` updates it too.

To build the `tabletist` program from source with Homebrew's Rust instead,
install the formula of the same name, without `--cask`:

```sh
brew install igor-alexandrov/tabletist/tabletist
```

It installs the program, not the app in **Applications**.
`brew upgrade tabletist` updates it, and **Settings › Updates** shows that
command.

## Windows

Download and run `tabletist-v<version>-x86_64-pc-windows-msvc-setup.exe`, or
the `aarch64` one on an ARM PC. The installer does not need administrator
rights.

To run Tabletist without an installer, download the `.zip` for your PC,
extract it and open `tabletist.exe`.

**Settings › Updates** says when there is a newer version, with a link to
its release on GitHub. To update, run the new setup program, or extract
the new `.zip` in place of the old folder.

## Linux

### Arch Linux and Omarchy

The AUR packages (`tabletist-bin` and `tabletist`) are not published yet.
Until they are, use the AppImage to try Tabletist, and the release archive
to install it with an entry in the app launcher.

### Try it: the AppImage

Download `tabletist-<version>-x86_64.AppImage`, or the
`aarch64` one. It is one file that runs without installing anything. Make it
executable and run it:

```sh
chmod +x tabletist-<version>-x86_64.AppImage
./tabletist-<version>-x86_64.AppImage
```

An AppImage needs FUSE, which most desktops have. Without it, run it with
`--appimage-extract-and-run`.

The AppImage adds nothing to the app launcher. To start Tabletist from
there, install it from the release archive instead.

### Build it with Homebrew

With [Homebrew](https://brew.sh) on Linux, the formula builds Tabletist from
the release's source:

```sh
brew install igor-alexandrov/tabletist/tabletist
```

It adds nothing to the app launcher. `brew upgrade tabletist` updates it,
and **Settings › Updates** shows that command.

### Install it: the release archive

Download `tabletist-v<version>-x86_64-unknown-linux-gnu.tar.gz`, or the
`aarch64` one. It holds the `tabletist` binary, a `.desktop` file and the
icon. Unpack it and put the three where your desktop looks for them:

```sh
tar xzf tabletist-v<version>-x86_64-unknown-linux-gnu.tar.gz
cd tabletist-v<version>-x86_64-unknown-linux-gnu
install -Dm755 tabletist ~/.local/bin/tabletist
install -Dm644 packaging/linux/dev.tabletist.Tabletist.desktop -t ~/.local/share/applications
install -Dm644 packaging/linux/dev.tabletist.Tabletist.svg -t ~/.local/share/icons/hicolor/scalable/apps
```

With the `aarch64` archive, write `aarch64` for `x86_64` in the first two
lines.

Tabletist is then in the app launcher (Super+Space on Omarchy), with its
icon. The launcher entry runs `tabletist` from your `PATH`, which on Omarchy
holds `~/.local/bin`. On a desktop whose launcher does not look there, put
the binary in `/usr/local/bin` instead, which needs root:

```sh
sudo install -Dm755 tabletist /usr/local/bin/tabletist
```

To update, install the new binary the same way: **Settings › Updates**
(`:update` in the Omarchy look) checks GitHub for a newer version, every
day unless you choose every week or only when you ask, and says when
there is one. An AppImage, or `tabletist` run from the unpacked archive's
folder (beside the archive's `tabletist-portable.txt`), installs it
itself with **Download and install** (`U`) once you choose to restart; a
binary copied elsewhere, as above, is installed again the same way. To
remove Tabletist, delete the three files.

The Linux binaries are built on Ubuntu 24.04 and need glibc 2.39 or newer
(Ubuntu 24.04, Debian 13, Fedora 40 or later). On an older system,
[build from source](/tabletist/build-from-source/).

## Next

[Open Tabletist and make your first connection](/tabletist/getting-started/).

The newest stable version is on the latest release page. Every version, pre-releases included, is on the releases page. Each release lists its files with a checksums.txt, which you can use to check that a download was not damaged or changed, and checksums.txt.sig, its signature by the Tabletist release key.

macOS

Tabletist needs macOS 11 or later, on Apple Silicon or Intel. With Homebrew:

brew install --cask igor-alexandrov/tabletist/tabletist

Or download tabletist-v<version>-macos-universal.dmg, open it and drag Tabletist to Applications.

To update, choose Tabletist → Check for Updates…, then Download and install: the new version goes in when you restart. Tabletist updates itself only when it runs from Applications, not from the disk image. Installed with Homebrew, it updates itself the same way, and brew upgrade --greedy updates it too.

To build the tabletist program from source with Homebrew’s Rust instead, install the formula of the same name, without --cask:

brew install igor-alexandrov/tabletist/tabletist

It installs the program, not the app in Applications. brew upgrade tabletist updates it, and Settings › Updates shows that command.

Windows

Download and run tabletist-v<version>-x86_64-pc-windows-msvc-setup.exe, or the aarch64 one on an ARM PC. The installer does not need administrator rights.

To run Tabletist without an installer, download the .zip for your PC, extract it and open tabletist.exe.

Settings › Updates says when there is a newer version, with a link to its release on GitHub. To update, run the new setup program, or extract the new .zip in place of the old folder.

Linux

Arch Linux and Omarchy

The AUR packages (tabletist-bin and tabletist) are not published yet. Until they are, use the AppImage to try Tabletist, and the release archive to install it with an entry in the app launcher.

Try it: the AppImage

Download tabletist-<version>-x86_64.AppImage, or the aarch64 one. It is one file that runs without installing anything. Make it executable and run it:

chmod +x tabletist-<version>-x86_64.AppImage
./tabletist-<version>-x86_64.AppImage

An AppImage needs FUSE, which most desktops have. Without it, run it with --appimage-extract-and-run.

The AppImage adds nothing to the app launcher. To start Tabletist from there, install it from the release archive instead.

Build it with Homebrew

With Homebrew on Linux, the formula builds Tabletist from the release’s source:

brew install igor-alexandrov/tabletist/tabletist

It adds nothing to the app launcher. brew upgrade tabletist updates it, and Settings › Updates shows that command.

Install it: the release archive

Download tabletist-v<version>-x86_64-unknown-linux-gnu.tar.gz, or the aarch64 one. It holds the tabletist binary, a .desktop file and the icon. Unpack it and put the three where your desktop looks for them:

tar xzf tabletist-v<version>-x86_64-unknown-linux-gnu.tar.gz
cd tabletist-v<version>-x86_64-unknown-linux-gnu
install -Dm755 tabletist ~/.local/bin/tabletist
install -Dm644 packaging/linux/dev.tabletist.Tabletist.desktop -t ~/.local/share/applications
install -Dm644 packaging/linux/dev.tabletist.Tabletist.svg -t ~/.local/share/icons/hicolor/scalable/apps

With the aarch64 archive, write aarch64 for x86_64 in the first two lines.

Tabletist is then in the app launcher (Super+Space on Omarchy), with its icon. The launcher entry runs tabletist from your PATH, which on Omarchy holds ~/.local/bin. On a desktop whose launcher does not look there, put the binary in /usr/local/bin instead, which needs root:

sudo install -Dm755 tabletist /usr/local/bin/tabletist

To update, install the new binary the same way: Settings › Updates (:update in the Omarchy look) checks GitHub for a newer version, every day unless you choose every week or only when you ask, and says when there is one. An AppImage, or tabletist run from the unpacked archive’s folder (beside the archive’s tabletist-portable.txt), installs it itself with Download and install (U) once you choose to restart; a binary copied elsewhere, as above, is installed again the same way. To remove Tabletist, delete the three files.

The Linux binaries are built on Ubuntu 24.04 and need glibc 2.39 or newer (Ubuntu 24.04, Debian 13, Fedora 40 or later). On an older system, build from source.

Open Tabletist and make your first connection.