---
id: infi-systray
version: "0.1.12.1"
license: BSD
license_treatment: permissive
maintenance: dormant
---

# infi.systray — Windows system tray icon

License: permissive · Maintenance: dormant · Downloads: 610.9K/mo

## What it is and what it does

infi.systray creates a Windows system tray icon that displays in the taskbar notification area with a customizable right-click context menu. It runs the tray in a background thread, allowing your main program to continue execution while the icon remains active. You define menu options as tuples specifying the label, optional icon path, and callback function; the package handles Windows integration and user interaction.

The package supports nested submenus, custom hover text, icon updates during runtime, and lifecycle callbacks for quit events. It can be used as a context manager to ensure clean shutdown, or managed manually with start() and shutdown() calls. A "Quit" option is automatically appended to the menu.

Use it for:

- Add a system tray presence to a background service or daemon running on Windows.
- Create a quick-access menu for common tasks without opening a main window.
- Monitor or control a long-running process via tray icon updates and menu callbacks.
- Build a Windows desktop utility with minimal UI footprint using the notification area.
- Implement graceful shutdown and status reporting through tray context menus.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Implements a Windows system tray icon with a right-click context menu and callback support for menu actions.

Yes, if you need a Windows system tray icon with menu support and accept the dormant maintenance status. The package is stable and has no known vulnerabilities, but expect no active development—use it for straightforward tray integration in Windows-only applications. Not suitable if you need cross-platform support or expect ongoing maintenance.

## Install

pip install infi-systray
uv add infi-systray
poetry add infi-systray

## Installing infi.systray

Before you install: Low install friction with a single runtime dependency (setuptools). Maintenance is dormant—last release was 580 days ago, though the repository remains active with a recent commit on 2023-10-22.

License in practice: BSD license is permissive, allowing commercial and private use with minimal restrictions.

Quickstart:

pip install infi.systray

from infi.systray import SysTrayIcon

def say_hello(systray):
    print("Hello, World!")

menu_options = (("Say Hello", None, say_hello),)
systray = SysTrayIcon("icon.ico", "Example tray icon", menu_options)
systray.start()

Windows-only; import will fail on non-Windows systems.

Verify before relying:

- Whether the package works reliably on modern Windows versions (last release 580 days ago).
- Python 3 compatibility beyond the listed 3.2 classifier—actual tested versions unknown.
- Whether threading model and context manager support are stable under heavy concurrent menu use.

## Package facts

- License: BSD (permissive)
- Python support: unspecified
- Install friction: low
- Maintenance: dormant
- Downloads: 610.9K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

windows system tray icon, taskbar notification area, system tray context menu, windows tray application, systray icon python, taskbar icon with menu, windows notification tray, windows-only, system-tray, gui-integration

[View on SkillFed](https://skillfed.io/packages/infi-systray) · [View on PyPI](https://pypi.org/project/infi-systray/)