systray is a cross-platform Go library to place an icon and menu in the notification area.
- Supported on Windows, macOS, and Linux
- Menu items can be checked and/or disabled
- Most functions may be called from any goroutine
func main() {
systray.Run(onReady, onExit)
}
func onReady() {
systray.SetIcon(icon.Data)
systray.SetTitle("Awesome App")
systray.SetTooltip("Pretty awesome超级棒")
mQuit := systray.AddMenuItem("Quit", "Quit the whole app")
// Sets the icon of a menu item. Only available on Mac and Windows.
mQuit.SetIcon(icon.Data)
}
func onExit() {
// clean up here
}See 
Note: this package requires cgo, so make sure you set CGO_ENABLED=1 before building.
Have go v1.12+ or higher installed? Here's an example to get started on macOS:
git clone https://github.com/getlantern/systray
cd systray/example
env GO111MODULE=on go build
./exampleOn Windows, you should build like this:
env GO111MODULE=on go build -ldflags "-H=windowsgui"
Now look for Awesome App in your menu bar!
The code under webview_example is to demostrate how it can co-exist with other UI elements. Note that the example doesn't work on macOS versions older than 10.15 Catalina.
- Building apps requires gcc as well as the
gtk3andlibayatana-appindicator3development headers to be installed. For Debian or Ubuntu, you may install these using:
sudo apt-get install gcc libgtk-3-dev libayatana-appindicator3-devOn Linux Mint, libxapp-dev is also required.
If you need to support the older libappindicator3 library instead, you can pass the build flag legacy_appindicator
when building. For example:
go build -tags=legacy_appindicator
To build webview_example, you also need to install libwebkit2gtk-4.0-dev and remove webview_example/rsrc.syso which is required on Windows.
- To avoid opening a console at application startup, use these compile flags:
go build -ldflags -H=windowsguiOn macOS, you will need to create an application bundle to wrap the binary; simply folders with the following minimal structure and assets:
SystrayApp.app/
Contents/
Info.plist
MacOS/
go-executable
Resources/
SystrayApp.icns
When running as an app bundle, you may want to add one or both of the following to your Info.plist:
<!-- avoid having a blurry icon and text -->
<key>NSHighResolutionCapable</key>
<string>True</string>
<!-- avoid showing the app on the Dock -->
<key>LSUIElement</key>
<string>1</string>Consult the Official Apple Documentation here.
On macOS, it's possible to set the underlying
NSStatusItemBehavior
with systray.SetRemovalAllowed(true). When enabled, the user can cmd-drag the
icon off the menu bar.
![dependabot[bot] avatar](https://avatars.githubusercontent.com/in/29110?v=4 "dependabot[bot]")
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent