systray

package
v1.3.5 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Mar 13, 2023 License: MIT, Apache-2.0 Imports: 5 Imported by: 0

README

This project only needed Windows specific functionality which I wanted to expand a bit, so I forked "github.com/getlantern/systray" at 2c0986dda9aea361e925f90e848d9036be7b5367 and modified it slightly. I have no intention to submit PR (since my modifications are specific), so I will keep it here with all original licensing intact.

systray is a cross-platform Go library to place an icon and menu in the notification area.

Features

  • Supported on Windows, macOS, and Linux
  • Menu items can be checked and/or disabled
  • Methods may be called from any Goroutine

API

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 full API as well as CHANGELOG.

Try the example app!

Have go v1.12+ or higher installed? Here's an example to get started on macOS:

git clone https://github.com/getlantern/systray
cd example
env GO111MODULE=on go build
./example

On Windows, you should build like this:

env GO111MODULE=on go build -ldflags "-H=windowsgui"

The following text will then appear on the console:

go: finding github.com/skratchdot/open-golang latest
go: finding github.com/getlantern/systray latest
go: finding github.com/getlantern/golog latest

Now look for Awesome App in your menu bar!

Awesome App screenshot

The Webview example

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.

Platform notes

Linux

  • Building apps requires gcc as well as the gtk3 and libappindicator3 development headers to be installed. For Debian or Ubuntu, you may install these using:
sudo apt-get install gcc libgtk-3-dev libappindicator3-dev

On Linux Mint, libxapp-dev is also required .

To build webview_example, you also need to install libwebkit2gtk-4.0-dev and remove webview_example/rsrc.syso which is required on Windows.

Windows

  • To avoid opening a console at application startup, 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 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.

Credits

Documentation

Overview

Package systray is a cross-platform Go library to place an icon and menu in the notification area.

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

func AddSeparator 

func AddSeparator()

AddSeparator adds a separator bar to the menu.

func Quit 

func Quit()

Quit the systray.

func Register 

func Register(onReady func(), onExit func(), onSessionEvent func(SessionEvent))

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 func(), onExit func(), onSessionEvent func(SessionEvent))

Run initializes GUI and starts the event loop, then invokes the onReady callback. It blocks until systray.Quit() is called.

Types 

type MenuItem struct {
	// ClickedCh is the channel which will be notified when the menu item is clicked
	ClickedCh chan 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 

func AddMenuItem(title string, tooltip string) *MenuItem

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 

func AddMenuItemCheckbox(title string, tooltip string, checked bool) *MenuItem

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 (item *MenuItem) AddSubMenuItem(title string, tooltip string) *MenuItem

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 (item *MenuItem) AddSubMenuItemCheckbox(title string, tooltip string, checked bool) *MenuItem

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 (item *MenuItem) Check()

Check a menu item regardless if it's previously checked or not. 

func (item *MenuItem) Checked() bool

Checked returns if the menu item has a check mark. 

func (item *MenuItem) Disable()

Disable a menu item regardless if it's previously disabled or not. 

func (item *MenuItem) Disabled() bool

Disabled checks if the menu item is disabled. 

func (item *MenuItem) Enable()

Enable a menu item regardless if it's previously enabled or not. 

func (item *MenuItem) Hide()

Hide hides a menu item. 

func (item *MenuItem) SetTitle(title string)

SetTitle set the text to display on a menu item. 

func (item *MenuItem) SetTooltip(tooltip string)

SetTooltip set the tooltip to show when mouse hover. 

func (item *MenuItem) Show()

Show shows a previously hidden menu item. 

func (item *MenuItem) String() string
func (item *MenuItem) Uncheck()

Uncheck a menu item regardless if it's previously unchecked or not.

type SessionEvent 

type SessionEvent int32

SessionEvent describes WM_WTSSESSION_CHANGE wParam. 

const (
	SesConsoleConnect    SessionEvent = iota + 0x1 // WTS_CONSOLE_CONNECT (0x1)
	SesConsoleDisconnect                           // WTS_CONSOLE_DISCONNECT (0x2)
	SesRemoteConnect                               // WTS_REMOTE_CONNECT (0x3)
	SesRemoteDisconnect                            // WTS_REMOTE_DISCONNECT (0x4)
	SesLogon                                       // WTS_SESSION_LOGON (0x5)
	SesLogoff                                      // WTS_SESSION_LOGOFF (0x6)
	SesLock                                        // WTS_SESSION_LOCK (0x7)
	SesUnlock                                      // WTS_SESSION_UNLOCK (0x8)
	SesRemoteControl                               // WTS_SESSION_REMOTE_CONTROL (0x9)
)

SessionEvent values.

func (SessionEvent) String 

func (e SessionEvent) String() string

Source Files

View all Source files

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.