Installation

Download

Prebuilt binaries for all platforms are available on the GitHub Releases page.

Download the latest version for your operating system and follow the platform-specific instructions below.

If you installed Tray Link with Homebrew, keep using brew upgrade --cask tray-link as the canonical update path. The in-app updater is intended for native macOS app installs outside Homebrew ownership.

Manual Download

Go to the Releases page
Download the Tray-Link-macOS-universal.zip file
Extract and move Tray Link.app to your Applications folder
Open the app from your Applications folder

After installing manually, open Settings → Updates in Tray Link to check for a newer release and start the in-app update flow.

macOS Signing Disclaimer

Unsigned Application

Tray Link is not code-signed yet. macOS may block the app on first launch. You can bypass this verification using the following command:

xattr -d com.apple.quarantine /Applications/Tray\ Link.app

Alternatively, you can right-click the app and select Open from the context menu, then confirm the dialog.

If you prefer, you can also clone the repository and build Tray Link locally.

Installer

Go to the Releases page
Download the .exe installer for Windows
Run the installer — it uses Squirrel, which installs the app automatically
Tray Link will appear in your system tray after installation

Debian/Ubuntu (.deb)

# Download the .deb package from the Releases page, then:
sudo dpkg -i tray-link_<version>_amd64.deb

Fedora/RHEL (.rpm)

# Download the .rpm package from the Releases page, then:
sudo rpm -i tray-link-<version>.x86_64.rpm

After installation, Tray Link will be available in your system tray. You can also find it in your applications menu under the Utility category.

Installing the CLI

The tlink CLI can be installed directly from the Tray Link app:

Open Tray Link from your system tray/menu bar
Click Settings (gear icon)
In the CLI section, click Install CLI

This creates a symlink to the tlink binary so it's available in your terminal.

You can also uninstall the CLI from the same settings section.

See the CLI documentation for usage details.

In-App Updates on macOS

The native macOS build includes an in-app updater in Settings → Updates.

Check for updates fetches the latest published GitHub release metadata
Install update downloads the latest macOS .zip, prepares the replacement app, and restarts Tray Link
Release notes continue to live on the GitHub Releases page

If the automatic install cannot finish on your machine, use the latest release asset or reinstall via Homebrew.

Building from Source

If you prefer to build Tray Link yourself:

Requirements

Node.js >=20
Bun 1.x

Steps

# Clone the repository
git clone https://github.com/thejoaov/tray-link.git
cd tray-link

# Install dependencies
bun install

# Start development mode
bun run dev

# Or build for production
bun run build

See the README for more available scripts.