Package: simplesystray
simplesystrayThis module implements a Windows system tray icon with a right-click context menu.InstallationTo install simplesystray, run:pip install simplesystrayUsageCreating an icon with one option in the context menu:fromsimplesystrayimportSysTrayIcondefsay_hello(systray):print("Hello, World!")menu_options=(("Say Hello","hello.ico",say_hello),)systray=SysTrayIcon("icon.ico","Example tray icon",menu_options)systray.start()The first parameter to SysTrayIcon is a path to the icon to show in the systray. If the icon is not found, or
if None is specified, a default system icon will be displayed.
The second parameter is the hover text to show when the mouse is hovered over the systray icon.
The traybar will run in its own thread, so the using script can continue to run.For the parameters ofmenu_options: cf the sectionMenubelowUpdating : icon, hover text and/or menu optionsThe icon and/or hover text and/or menu options can be updated using the update() method with the appropriatehover_textoriconormenu_optionskeyword argument:Updating the hover_text:foritemin['item1','item2','item3']:systray.update(hover_text=item)do_something(item)Updating the menu options:defsay_hello(systray):systray.update(menu_options=menu_optionsbye)defsay_bye(systray):systray.update(menu_options=menu_optionshello)menu_optionshello=(("Say Hello","hello.ico",say_hello),)menu_optionsbye=(("Say Bye","bye.ico",say_bye),)systray=SysTrayIcon("icon.ico","Hello/Bye",menu_optionshello)systray.start()Shutting downTo destroy the icon when the program ends, callsystray.shutdown()SysTrayIcon can be used as a context manager to start and shutdown the tray, which also prevents hung tray threads should the parent thread fail or otherwise not close the tray process:withSysTrayIcon(icon,hover_text)assystray:foritemin['item1','item2','item3']:systray.update(hover_text=item)do_something(item)A "Quit" command is always appended to the end of the icon context menu, after the menu options specified by the user.
To perform operations when Quit is selected, pass "on_quit=callback" as a parameter, e.g.:defon_quit_callback(systray):program.shutdown()systray=SysTrayIcon("icon.ico","Example tray icon",menu_options,on_quit=on_quit_callback)When the user double-clicks the systray icon, the first option specified in menu_options will be executed. The default
command may be changed to a different option by setting the parameter "default_menu_index", e.g.:systray=SysTrayIcon("icon.ico","Example tray icon",menu_options,default_menu_index=2)menu_options must be a list of 3-tuples. Each 3-tuple specifies a context menu options. The first value in each tuple
is the context menu string.
Some versions of Windows can show icons next to each option in the context menu. This icon can be specified in
the second value of the tuples. If None is passed, no icon is displayed for the option.
The third value is the command to execute when the context menu is selected by the user.It is possible to create sub-menus in the context menu by recursively passing a list of 3-tuple options as the third
value of an option, instead of passing a callback function. e.g.fromsimplesystrayimportSysTrayIconhover_text="SysTrayIcon Demo"defhello(sysTrayIcon):print("Hello World.")defsimon(sysTrayIcon):print("Hello Simon.")defbye(sysTrayIcon):print('Bye, then.')defdo_nothing(sysTrayIcon):passmenu_options=(('Say Hello',"hello.ico",hello),('Do nothing',None,do_nothing),('A sub-menu',"submenu.ico",(('Say Hello to Simon',"simon.ico",simon),('Do nothing',None,do_nothing),)))sysTrayIcon=SysTrayIcon("main.ico",hover_text,menu_options,on_quit=bye,default_menu_index=1)sysTrayIcon.start()Note that in the previous examples, if no code is executed after calling systray.start(), the main thread will
exit and the icon thread will continue to exist until the Quit option is selected. In order to catch keyboard
interrupts, some code must be written that will call systray.shutdown when the program should quit.
Using SysTrayIcon as a context manager automates the start and shutdown of the tray.This module can only be used in Windows systems, otherwise the import statement will fail.CreditThis module is adapted from an implementation by Infinidat Ltd. this was a clone on Simon Brunning's version, which in turn was adapted from Mark Hammond's
win32gui_taskbar.py and win32gui_menu.py demos from PyWin32.This work is licensed under aCreative Commons Attribution 4.0 International License.