Baike.dev
All toolsOnline toolsAI codingTrendingOpen sourceNewsSubmit
Log in
< Back to tools
T

tray-icon

> 编程语言
Open source

Tray icons for Desktop Applications in Rust.

397 stars0 likes1 views
WebsiteGitHub

About

Tray icons for Desktop Applications in Rust.

tray-icon lets you create tray icons for desktop applications.

Platforms supported:

  • Windows
  • macOS
  • Linux (AppIndicator or KSNI)
  • FreeBSD (AppIndicator or KSNI)

Platform-specific notes:

  • On Windows and the Linux/FreeBSD AppIndicator backend, an event loop must be running on the thread. The KSNI backend manages its own worker thread.
  • On macOS, an event loop must be running on the main thread so you also need to create the tray icon on the main thread.

Cargo Features

  • libappindicator: Uses the GTK 3 AppIndicator backend on Linux and BSD. This is enabled by default and also enables muda-gtk3.
  • ksni: Uses the StatusNotifierItem D-Bus backend on Linux and BSD.
  • serde: Enables de/serializing derives.
  • muda-common-controls-v6: Forwards muda's common-controls-v6 feature.
  • muda-gtk3: Forwards muda's gtk3 feature.
  • muda-gtk4: Forwards muda's gtk4 feature.
  • muda-libxdo: Forwards muda's libxdo feature. This is enabled by default.
  • muda-serde: Forwards muda's serde feature. The serde feature also enables it.
  • muda-snapshot: Forwards muda's snapshot feature. The ksni feature also enables it.

When both libappindicator and ksni are enabled on Linux or BSD, tray-icon uses the ksni backend and emits a Cargo warning.

Dependencies (Linux/BSD)

The default Linux backend uses GTK 3, libxdo, and libappindicator or libayatana-appindicator. The ksni backend does not require these system libraries unless a muda GTK backend is also enabled.

Arch Linux / Manjaro:

bash
pacman -S gtk3 xdotool libappindicator-gtk3 #or libayatana-appindicator

Debian / Ubuntu:

bash
sudo apt install libgtk-3-dev libxdo-dev libappindicator3-dev #or libayatana-appindicator3-dev

Dependencies in FreeBSD

Install this dependencies in order to compile tray-icon. Instructions using pkg:

bash
pkg install -y rust glib pkgconf gtk3

Examples

Create a tray icon without a menu.

rust
use tray_icon::TrayIconBuilder;

let tray_icon = TrayIconBuilder::new()
    .with_tooltip("system-tray - tray icon library!")
    .with_icon(icon)
    .build()
    .unwrap();

Create a tray icon with a menu.

rust
use tray_icon::{TrayIconBuilder, menu::Menu};

let tray_menu = Menu::new();
let tray_icon = TrayIconBuilder::new()
    .with_menu(Box::new(tray_menu))
    .with_tooltip("system-tray - tray icon library!")
    .with_icon(icon)
    .build()
    .unwrap();

Processing tray events

You can use TrayIconEvent::receiver to get a reference to the TrayIconEventReceiver which you can use to listen to events when a click happens on the tray icon

rust
use tray_icon::TrayIconEvent;

if let Ok(event) = TrayIconEvent::receiver().try_recv() {
    println!("{:?}", event);
}

You can also listen for the menu events using MenuEvent::receiver to get events for the tray context menu.

rust
use tray_icon::{TrayIconEvent, menu::{MenuEvent}};

if let Ok(event) = TrayIconEvent::receiver().try_recv() {
    println!("tray event: {:?}", event);
}

if let Ok(event) = MenuEvent::receiver().try_recv() {
    println!("menu event: {:?}", event);
}

Note for winit or tao users:

You should use [TrayIconEvent::set_event_handler] and forward the tray icon events to the event loop by using EventLoopProxy so that the event loop is awakened on each tray icon event. Same can be done for menu events using [MenuEvent::set_event_handler].

rust
enum UserEvent {
  TrayIconEvent(tray_icon::TrayIconEvent)
  MenuEvent(tray_icon::menu::MenuEvent)
}

let event_loop = EventLoop::::with_user_event().build().unwrap();

let proxy = event_loop.create_proxy();
tray_icon::TrayIconEvent::set_event_handler(Some(move |event| {
    proxy.send_event(UserEvent::TrayIconEvent(event));
}));

let proxy = event_loop.create_proxy();
tray_icon::menu::MenuEvent::set_event_handler(Some(move |event| {
    proxy.send_event(UserEvent::MenuEvent(event));
}));

License

Apache-2.0/MIT

Issues· 38 open

View all issuesOpen on GitHub

No open issues yet, or sync has not completed.

> Tags

Rustguirustsystem-traytray

No comments yet. Be the first to share.

> Details

PublishedAug 1, 2026
UpdatedSep 17, 2026
Category编程语言
PricingOpen source

> Related tools

T
TypeScript
JavaScript 的超集,为前端与全栈提供静态类型
P
Python
通用编程语言,广泛用于 Web、数据与 AI
G
Go
Google 推出的简洁高效系统语言