NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
pub.dev
pub.dev, #815 most downloaded on pub.dev
This plugin allows Flutter desktop apps to define a system tray icon.
Latest stable
0.8.3
Last release 17 days ago
05 Nov 2026
Release timing varies
gaps range from 3 weeks to 7 months
Nearly every release is documented
notes for 29 of 30 stable releases
2 versions withdrawn
withdrawn after publishing
5 years old
32 releases · first in 2021
Drag across the ruler to compare, or tap a release to open it.
Release tray_manager 0.8.3
Release tray_manager 0.8.3
NIS_HIDDEN, so the icon shown after a switch still receives clicks
(#110).Fix Linux context menus when using the legacy API. trayManager.setContextMenu() now enables the menu trigger so StatusNotifierItem panels can display
Fix Linux context menus when using the legacy API. trayManager.setContextMenu() now enables the menu trigger so StatusNotifierItem panels can display the attached menu, including after menu replacement and icon recreation (#107).
The English and Chinese README native API examples now explicitly set ContextMenuTrigger.rightClicked and explain Linux panel-controlled menu behavior.
The menu export and callback regression checks pass on GNOME 46 and Hyprland.
Upgrade to tray_manager: ^0.8.2 and run flutter pub upgrade.
Your coding agent can read these notes before it upgrades. Set up the MCP server →
setContextMenu() enables the menu trigger so panels can
display the attached menu (#107). Replacing the menu retains that behavior.Windows: tray icons respond to left- and right-clicks when the app runs as administrator again (fixes #110). The native callback message is now allowe
Windows: tray icons respond to left- and right-clicks when the app runs as administrator again (fixes #110). The native callback message is now allowed through Windows UIPI.
Requires nativeapi and nativeapi_flutter 0.5.3. Update tray_manager to ^0.8.1 and run flutter pub upgrade.
Depends on nativeapi 0.5.1 and nativeapi_flutter 0.5.1. ImageAsset now comes from nativeapi_flutter; package:tray_manager/tray_manager.dart still expo
ImageAsset now
comes from nativeapi_flutter; package:tray_manager/tray_manager.dart still
exports it.kIsWeb.Id is stable across launches (#109). It is
the GApplication ID or the executable name, and TrayIcon.createWithIdentifier
sets one explicitly.setTitle shows the title next to the icon where the shell draws a
label (GNOME's AppIndicator extension) instead of in the tooltip.getBounds() no longer divides by the device pixel ratio; nativeapi
reports tray bounds in logical pixels.Existing apps change one import. It is a bridge: everything in it is @Deprecated and will be removed in a later release. The README lists the behaviou…
tray_manager is now built on nativeapi: the per-platform plugin code is gone, and one C++ core drives macOS, Windows and Linux.
package:tray_manager/tray_manager.dart exports the native API —
TrayIcon, Menu, MenuItem, Image and their events. Several tray icons at once,
double-click events, contextMenuTrigger, menu item icons, radio groups and
accelerators come with it.package:tray_manager/legacy.dart: trayManager,
TrayListener, and a Menu / MenuItem pair with the menu_base shape (menu_base
itself is no longer a dependency). Existing apps change one import. It is a bridge:
everything in it is @Deprecated and will be removed in a later release. The README
lists the behaviour differences and maps each old call to the native API.setToolTip works. Tray icon clicks
are not reported there — the panel keeps them and opens the menu itself, as it did
in 0.5.x. Builds need GTK 3, X11 and Xi development files; libayatana-appindicator3-dev
is not one of them (nativeapi 0.3.0 stopped requiring and linking it)..png icons work as well as .ico.MenuItem.label, toolTip, checked and disabled of the legacy API update the
visible menu when assigned; onClick runs once per click, with or without a
TrayListener. A native checkbox item is not toggled by a click.package:flutter/widgets.dart alone; the full one is nativeapi's
tray_icon_example.Change one import and existing code keeps working: package:tray_manager/legacy.dart carries the 0.5.x API (trayManager, TrayListener, and a Menu / MenuItem pair with the menu_base shape, without depending on menu_base). Everything in it is deprecated and goes away in a later release; the README maps each old call to its native counterpart.
On Linux, one behaviour differs and will not come back: tray icon clicks are not reported — the panel keeps them and opens the menu itself.
📦 https://pub.dev/packages/tray_manager/versions/0.7.0
Full Changelog: https://github.com/leanflutter/tray_manager/compare/v0.5.3...v0.7.0
Correct the 0.6.0 notes: tray icon clicks are not reported on Linux — the panel keeps them and opens the menu itself, as it did in 0.5.x.
Documentation only.
app_links known issue, which no longer applies (tray and menu
messages no longer go through Flutter's window message delegates); say what a Linux
desktop needs to show the icon; list the calls that stopped throwing
MissingPluginException per platform; note that a native checkbox item is not toggled
by a click; fix the table of contents; remove the visits badge.Existing apps change one import. It is a bridge: everything in it is @Deprecated and will be removed in a later release. The README lists the behaviou…
tray_manager is now built on nativeapi: the per-platform plugin code is gone, and one C++ core drives macOS, Windows and Linux.
package:tray_manager/tray_manager.dart exports the native API —
TrayIcon, Menu, MenuItem, Image and their events. Several tray icons at once,
double-click events, contextMenuTrigger, menu item icons, radio groups and
accelerators come with it.package:tray_manager/legacy.dart: trayManager,
TrayListener, and a Menu / MenuItem pair with the menu_base shape (menu_base
itself is no longer a dependency). Existing apps change one import. It is a bridge:
everything in it is @Deprecated and will be removed in a later release. The README
lists the behaviour differences and maps each old call to the native API.setToolTip works. Tray icon clicks
are still not reported there. Builds need GTK 3, X11 and Xi development files and, until the next nativeapi
release drops a leftover requirement, still libayatana-appindicator3-dev..png icons work as well as .ico.MenuItem.label, toolTip, checked and disabled of the legacy API update the
visible menu when assigned; onClick runs once per click, with or without a
TrayListener.package:flutter/widgets.dart alone; the full one is nativeapi's
tray_icon_example.feat(macos): add Swift Package Manager support
fix(windows): tray icon disappears after explorer restart #85
Fix: Resolved a memory leak when setting the icon multiple times on windows by @jovica-me in https://github.com/leanflutter/tray_manager/pull/76
Full Changelog: https://github.com/leanflutter/tray_manager/compare/v0.5.0...v0.5.1
docs: add "path" to use Git package correctly by @pzhlkj6612 in https://github.com/leanflutter/tray_manager/pull/72
Full Changelog: https://github.com/leanflutter/tray_manager/compare/v0.4.0...v0.5.0
fix: resolve memory leak issue when update menu on macOS by @anserme in https://github.com/leanflutter/tray_manager/pull/66
Full Changelog: https://github.com/leanflutter/tray_manager/compare/v0.3.2...v0.4.0
refactor: :pencil2: Rename TrayIconPositon to TrayIconPosition by @harimasora in https://github.com/leanflutter/tray_manager/pull/62
Full Changelog: https://github.com/leanflutter/tray_manager/compare/v0.3.1...v0.3.2
support setting the iconSize on macOS by @alkebuware in https://github.com/leanflutter/tray_manager/pull/60
Full Changelog: https://github.com/leanflutter/tray_manager/compare/v0.3.0...v0.3.1
Gives Option in popUpContextMenu() to Foreground App or Not by @EthanBarlow in https://github.com/leanflutter/tray_manager/pull/58
Full Changelog: https://github.com/leanflutter/tray_manager/compare/v0.2.4...v0.3.0
bringAppToFront param to popUpContextMenu method (#58)Add notes to the code comments of setToolTip by @MegatronKing in https://github.com/leanflutter/tray_manager/pull/54
Full Changelog: https://github.com/leanflutter/tray_manager/compare/v0.2.3...v0.2.4
fix(macos): Fix app will crash when closing the tray. #44
fix(linux): ensure icon works in sandboxed environments #43
[linux] Fix libayatana set icon deprecation
[macos] Implemented setIconPosition method.
setIconPosition method. (#25)Nothing published for this version
[windows] getBounds method returns null when not initialized
[macos] Optimize tray icon click event response
[macos] Implemented setTitle method.
setTitle method.setTitle method. #15[macos] Fixed onTrayIconMouseDown not triggered
[macos] Fix the problem that the tray highlight state is incorrect #4 #10
[windows] Implemented setToolTip Method.
setToolTip Method.[macos] Add isTemplate parameter to setIcon method
isTemplate parameter to setIcon method* [linux] Remove dependency
<uuid/uuid.h> dependency* Support sub menu.
Implemented setContextMenu Method.
destroy Method.setIcon Method.setContextMenu Method.popUpContextMenu Method.getBounds Method.* Initial release.
One column per quarter.