Install

tmnl ships native binaries for macOS, Linux, and Windows via cargo-dist.

Version: 0.1.5 · Release notes

Start here

Pick your OS — each row jumps to the installer that works best for that platform.

| OS | Recommended install | | --- | --- | | macOS | .dmg (Apple Silicon or Intel) · or brew install --cask | | Linux | .deb · .rpm · AppImage · curl \| sh · source | | Windows | .msi · or PowerShell one-liner · source |

Already installed? Jump to Verify.

Mac

First launch on macOS

The macOS build isn’t notarized yet (gated on an EV signing cert), so Gatekeeper will block the first launch with “tmnl can’t be opened because Apple cannot check it for malicious software.”

Two ways past it:

• Right-click tmnl.app → Open in Finder, then click Open in the dialog. macOS remembers the approval.
• Or from a terminal: xattr -d com.apple.quarantine /Applications/tmnl.app

This warning will go away once notarization ships.

.dmgmacOS 11+

brew install --cask chris-mclennan/tap/tmnl

• .dmgx64ARM64
• .pkgx64ARM64
• .tar.xzx64ARM64

Linux

.tar.xzStatic binary · x64 / ARM64

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/chris-mclennan/tmnl/releases/latest/download/tmnl-rs-installer.sh | sh

• .debDebian, Ubuntux64ARM64
• .rpmRed Hat, Fedora, SUSEx64ARM64
• AppImageportable GUI bundlex64ARM64
• .tar.xzportablex64ARM64
• installer.shcurl | shscript

Windows

.msiWindows 10/11 · x64

irm https://github.com/chris-mclennan/tmnl/releases/latest/download/tmnl-rs-installer.ps1 | iex

• .msix64
• .zipportablex64

Build from source

git clone https://github.com/chris-mclennan/tmnl
cd tmnl
cargo build --release
./target/release/tmnl

Build deps:

• macOS: Xcode command-line tools (xcode-select --install)
• Linux: X11 + Wayland + GTK headers — sudo apt install libx11-dev libxcursor-dev libxrandr-dev libxi-dev libxkbcommon-dev libgl1-mesa-dev libwayland-dev libudev-dev libfontconfig1-dev libglib2.0-dev libgtk-3-dev libxdo-dev
• Windows: MSVC build tools (included with Visual Studio 2022 or the standalone Build Tools installer)

For Linux you’ll need a working OpenGL / Vulkan stack for wgpu to render. Most modern distros have this; check with glxinfo or vulkaninfo if tmnl fails to launch.

Verify

tmnl --version

If your shell can’t find tmnl, you may need to restart it (the installer puts tmnl on PATH via your shell profile).