README
¶
Systray
systray is a cross-platform Go library to place an icon and menu in the notification area. This repository is a fork of getlantern/systray removing the GTK dependency and support for legacy linux system tray.
Features
- Supported on Windows, macOS, Linux and many BSD systems
- Menu items can be checked and/or disabled
- Methods may be called from any Goroutine
API
package main
import "energye/systray"
import "energye/systray/icon"
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.
mQuit.SetIcon(icon.Data)
}
func onExit() {
// clean up here
}
Running in a Fyne app
This repository is designed to allow any toolkit to integrate system tray without any additional dependencies. It is maintained by the Fyne team, but if you are using Fyne there is an even easier to use API in the main repository that wraps this project.
In your app you can use a standard fyne.Menu
structure and pass it to SetSystemTrayMenu
when your app is a desktop app, as follows:
menu := fyne.NewMenu("MyApp",
fyne.NewMenuItem("Show", func() {
log.Println("Tapped show")
}))
if desk, ok := myApp.(desktop.App); ok {
desk.SetSystemTrayMenu(menu)
}
You can find out more in the toolkit documentation: System Tray Menu.
Run in another toolkit
Most graphical toolkits will grab the main loop so the Run
code above is not possible.
For this reason there is another entry point RunWithExternalLoop
.
This function of the library returns a start and end function that should be called
when the application has started and will end, to loop in appropriate features.
See full API as well as CHANGELOG.
Note: this package requires cgo, so make sure you set CGO_ENABLED=1
before building.
Try the example app!
Have go v1.12+ or higher installed? Here's an example to get started on macOS or Linux:
git clone https://github.com/fyne-io/systray
cd systray/example
go run .
On Windows, you should follow the instructions above, but use the followign run command:
go run -ldflags "-H=windowsgui" .
Now look for Awesome App in your menu bar!
Platform notes
Linux/BSD
This implementation uses DBus to communicate through the SystemNotifier/AppIndicator spec, older tray implementations may not load the icon.
If you are running an older desktop environment, or system tray provider, you may require a proxy app which can convert the new DBus calls to the old format. The recommended tool for Gnome based trays is snixembed, others are available. Search for "StatusNotifierItems XEmbedded" in your package manager.
Windows
- To avoid opening a console at application startup, use "fyne package" for your app or manually use these compile flags:
go build -ldflags -H=windowsgui
macOS
On macOS, you will need to create an application bundle to wrap the binary; simply use "fyne package" or add folders with the following minimal structure and assets:
SystrayApp.app/
Contents/
Info.plist
MacOS/
go-executable
Resources/
SystrayApp.icns
If bundling manually, 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.
Credits
Documentation
¶
Overview ¶
Package systray is a cross-platform Go library to place an icon and menu in the notification area. Package systray是一个跨平台的Go库,用于在通知区域放置图标和菜单。
Index ¶
- func AddSeparator()
- func CreateMenu()
- func Quit()
- func Register(onReady func(), onExit func())
- func ResetMenu()
- func Run(onReady, onExit func())
- func RunWithExternalLoop(onReady, onExit func()) (start, end func())
- func SetDClickTimeMinInterval(value int64)
- func SetIcon(iconBytes []byte)
- func SetMenuNil()
- func SetOnClick(fn func())
- func SetOnDClick(fn func())
- func SetOnRClick(fn func(menu IMenu))
- func SetTemplateIcon(templateIconBytes []byte, regularIconBytes []byte)
- func SetTitle(t string)
- func SetTooltip(tooltipTitle string)
- type IMenu
- type MenuItem
- func (item *MenuItem) AddSubMenuItem(title string, tooltip string) *MenuItem
- func (item *MenuItem) AddSubMenuItemCheckbox(title string, tooltip string, checked bool) *MenuItem
- func (item *MenuItem) Check()
- func (item *MenuItem) Checked() bool
- func (item *MenuItem) Click(fn func())
- func (item *MenuItem) Disable()
- func (item *MenuItem) Disabled() bool
- func (item *MenuItem) Enable()
- func (item *MenuItem) Hide()
- func (item *MenuItem) Remove()
- func (item *MenuItem) SetIcon(iconBytes []byte)
- func (item *MenuItem) SetTemplateIcon(templateIconBytes []byte, regularIconBytes []byte)
- func (item *MenuItem) SetTitle(title string)
- func (item *MenuItem) SetTooltip(tooltip string)
- func (item *MenuItem) Show()
- func (item *MenuItem) String() string
- func (item *MenuItem) Uncheck()
- type PX
- type UnimplementedStatusNotifierItem
- func (m *UnimplementedStatusNotifierItem) Activate(x int32, y int32) (err *dbus.Error)
- func (m *UnimplementedStatusNotifierItem) ContextMenu(x int32, y int32) (err *dbus.Error)
- func (m *UnimplementedStatusNotifierItem) Scroll(delta int32, orientation string) (err *dbus.Error)
- func (m *UnimplementedStatusNotifierItem) SecondaryActivate(x int32, y int32) (err *dbus.Error)
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func CreateMenu ¶
func CreateMenu()
CreateMenu 创建托盘菜单, 如果托盘菜单是空, 把菜单项添加到托盘 该方法主动调用后 如果托盘菜单已创建则添加进去, 之后鼠标事件失效
仅MacOSX平台
func Register ¶
func Register(onReady func(), onExit func())
Register initializes GUI and registers the callbacks but relies on the caller to run the event loop somewhere else. It's useful if the program needs to show other UI elements, for example, webview. To overcome some OS weirdness, On macOS versions before Catalina, calling this does exactly the same as Run().
func Run ¶
func Run(onReady, onExit func())
Run initializes GUI and starts the event loop, then invokes the onReady callback. It blocks until systray.Quit() is called.
func RunWithExternalLoop ¶
func RunWithExternalLoop(onReady, onExit func()) (start, end func())
RunWithExternalLoop allows the systemtray module to operate with other tookits. The returned start and end functions should be called by the toolkit when the application has started and will end.
func SetIcon ¶
func SetIcon(iconBytes []byte)
SetIcon sets the systray icon. iconBytes should be the content of .ico for windows and .ico/.jpg/.png for other platforms.
func SetMenuNil ¶
func SetMenuNil()
SetMenuNil 托盘菜单设置为nil, 如果托盘菜单不是空, 把菜单项设置为nil 该方法主动调用后 将移除托盘菜单, 之后鼠标事件生效
仅MacOSX平台
func SetOnRClick ¶
func SetOnRClick(fn func(menu IMenu))
设置托盘鼠标右键事件反馈回调 支持windows 和 macosx,不支持linux 设置事件,菜单默认将不展示,通过menu.ShowMenu()函数显示 未设置事件,默认右键显示托盘菜单 macosx ShowMenu()只支持OnRClick函数内调用
func SetTemplateIcon ¶
SetTemplateIcon sets the systray icon as a template icon (on macOS), falling back to a regular icon on other platforms. templateIconBytes and iconBytes should be the content of .ico for windows and .ico/.jpg/.png for other platforms.
func SetTitle ¶
func SetTitle(t string)
SetTitle sets the systray title, only available on Mac and Linux.
func SetTooltip ¶
func SetTooltip(tooltipTitle string)
SetTooltip sets the systray tooltip to display on mouse hover of the tray icon, only available on Mac and Windows.
Types ¶
type MenuItem ¶
type MenuItem struct {
// contains filtered or unexported fields
}
MenuItem is used to keep track each menu item of systray. Don't create it directly, use the one systray.AddMenuItem() returned
func AddMenuItem ¶
AddMenuItem adds a menu item with the designated title and tooltip. It can be safely invoked from different goroutines. Created menu items are checkable on Windows and OSX by default. For Linux you have to use AddMenuItemCheckbox
func AddMenuItemCheckbox ¶
AddMenuItemCheckbox adds a menu item with the designated title and tooltip and a checkbox for Linux. It can be safely invoked from different goroutines. On Windows and OSX this is the same as calling AddMenuItem
func (*MenuItem) AddSubMenuItem ¶
AddSubMenuItem adds a nested sub-menu item with the designated title and tooltip. It can be safely invoked from different goroutines. Created menu items are checkable on Windows and OSX by default. For Linux you have to use AddSubMenuItemCheckbox
func (*MenuItem) AddSubMenuItemCheckbox ¶
AddSubMenuItemCheckbox adds a nested sub-menu item with the designated title and tooltip and a checkbox for Linux. It can be safely invoked from different goroutines. On Windows and OSX this is the same as calling AddSubMenuItem
func (*MenuItem) Check ¶
func (item *MenuItem) Check()
Check a menu item regardless if it's previously checked or not
func (*MenuItem) Disable ¶
func (item *MenuItem) Disable()
Disable a menu item regardless if it's previously disabled or not
func (*MenuItem) Enable ¶
func (item *MenuItem) Enable()
Enable a menu item regardless if it's previously enabled or not
func (*MenuItem) SetIcon ¶
SetIcon sets the icon of a menu item. iconBytes should be the content of .ico/.jpg/.png
func (*MenuItem) SetTemplateIcon ¶
SetTemplateIcon sets the icon of a menu item as a template icon (on macOS). On Windows and Linux, it falls back to the regular icon bytes. templateIconBytes and regularIconBytes should be the content of .ico for windows and .ico/.jpg/.png for other platforms.
func (*MenuItem) SetTooltip ¶
SetTooltip set the tooltip to show when mouse hover
type UnimplementedStatusNotifierItem ¶
type UnimplementedStatusNotifierItem struct {
// contains filtered or unexported fields
}
func (*UnimplementedStatusNotifierItem) Activate ¶
func (m *UnimplementedStatusNotifierItem) Activate(x int32, y int32) (err *dbus.Error)
func (*UnimplementedStatusNotifierItem) ContextMenu ¶
func (m *UnimplementedStatusNotifierItem) ContextMenu(x int32, y int32) (err *dbus.Error)
func (*UnimplementedStatusNotifierItem) Scroll ¶
func (m *UnimplementedStatusNotifierItem) Scroll(delta int32, orientation string) (err *dbus.Error)
func (*UnimplementedStatusNotifierItem) SecondaryActivate ¶
func (m *UnimplementedStatusNotifierItem) SecondaryActivate(x int32, y int32) (err *dbus.Error)