System Tray Launcher

A cross-platform system tray application launcher.

Features

• Cross-platform support (Linux, macOS, Windows)
• System tray icon with menu
• Launch applications from the system tray
• Open file locations
• Configured via TOML manifest file

Dependencies

Linux

The following system libraries are required on Linux:

• libayatana-appindicator3-dev - System tray indicator support
• libgtk-3-dev - GTK3 library
• CMake 3.27 or higher
• Ninja build system
• C++20 compatible compiler

Installation

Ubuntu/Debian:

sudo apt-get update
sudo apt-get install -y cmake ninja-build libayatana-appindicator3-dev libgtk-3-dev

macOS

• CMake 3.27 or higher
• Ninja build system
• Xcode Command Line Tools

brew install cmake ninja

Windows

• CMake 3.27 or higher
• Ninja build system
• Visual Studio 2022 or later (with C++ development tools)

choco install cmake ninja

Building

Configure

cmake --preset Debug    # or Release

Build

cmake --build --preset Debug    # or Release

Test

ctest --preset Debug --output-on-failure    # or Release

Usage

Create a SystemTrayLauncher.toml file in your Documents folder to define your system tray menu items:

# Example manifest.toml
[[entry]]
type = "launch"
label = "Terminal"
command = "/usr/bin/gnome-terminal"
arguments = []

[[entry]]
type = "location"
label = "Home Directory"
path = "/home/username"

Run the application:

./build/Debug/SystemTrayLauncher

Documentation

• Architecture & Design Decisions - In-depth explanation of design choices, trade-offs, and comparisons

License

See LICENSE file for details.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.