System Tray#

class ignis.services.system_tray.SystemTrayService(*args: Any, **kwargs: Any)#

A system tray, where application icons are placed.

Raises:

AnotherSystemTrayRunningError -- If another system tray is already running.

Example usage:

from ignis.services.system_tray import SystemTrayService

system_tray = SystemTrayService.get_default()

system_tray.connect("added", lambda x, item: print(item.title))
signal added#

Emitted when a new item is added.

Parameters:

item (SystemTrayItem) -- The instance of the system tray item.

gproperty items: list[SystemTrayItem]#

  • read-only

A list of system tray items.

class ignis.services.system_tray.SystemTrayItem(proxy: DBusProxy)#

A system tray item.

signal removed#

Emitted when the item is removed.

gproperty id: str | None#

  • read-only

The ID of the item.

gproperty category: str | None#

  • read-only

The category of the item.

gproperty title: str | None#

  • read-only

The title of the item.

gproperty status: str | None#

  • read-only

The status of the item.

gproperty window_id: int#

  • read-only

The window ID.

gproperty icon: str | GdkPixbuf.Pixbuf | None#

  • read-only

The icon name or a GdkPixbuf.Pixbuf.

gproperty item_is_menu: bool#

  • read-only

Whether the item has a menu.

gproperty menu: DBusMenu | None#

  • read-only

A DBusMenu or None.

Hint

To display the menu, add it to a container, and call the .popup() method on it.

Warning

If you want to add menu to several containers (e.g., make two status bars with a system tray), you must call the copy() method to obtain a copy of the menu. This is necessary because you can't add a single widget to multiple containers.

menu = item.menu.copy()
gproperty tooltip: str | None#

  • read-only

A tooltip, the text should be displayed when you hover cursor over the icon.

activate(x: int = 0, y: int = 0) → None#

Activate the application. Usually this causes an application window to appear.

Parameters:

  • x (int, default: 0) -- x coordinate.

  • y (int, default: 0) -- y coordinate.

Return type:

None

async activate_async(x: int = 0, y: int = 0) → None#

Asynchronous version of activate().

Parameters:

  • x (int, default: 0) -- x coordinate.

  • y (int, default: 0) -- y coordinate.

Return type:

None

secondary_activate(x: int = 0, y: int = 0) → None#

Activate a secondary and less important action compared to activate().

Parameters:

  • x (int, default: 0) -- x coordinate.

  • y (int, default: 0) -- y coordinate.

Return type:

None

async secondary_activate_async(x: int = 0, y: int = 0) → None#

Asynchronous version of secondary_activate().

Parameters:

  • x (int, default: 0) -- x coordinate.

  • y (int, default: 0) -- y coordinate.

Return type:

None

context_menu(x: int = 0, y: int = 0) → None#

Ask the item to show a context menu.

Parameters:

  • x (int, default: 0) -- x coordinate.

  • y (int, default: 0) -- y coordinate.

Return type:

None

async context_menu_async(x: int = 0, y: int = 0) → None#

Asynchronous version of context_menu().

Parameters:

  • x (int, default: 0) -- x coordinate.

  • y (int, default: 0) -- y coordinate.

Return type:

None

scroll(delta: int = 0, orientation: Literal['horizontal', 'vertical'] = 'horizontal') → None#

Ask for a scroll action.

Parameters:

  • delta (int, default: 0) -- The amount of scroll.

  • orientation (Literal['horizontal', 'vertical'], default: 'horizontal') -- The type of the orientation: horizontal or vertical.

Return type:

None

async scroll_async(delta: int = 0, orientation: Literal['horizontal', 'vertical'] = 'horizontal') → None#

Asynchronous version of scroll().

Parameters:

  • delta (int, default: 0) -- The amount of scroll.

  • orientation (Literal['horizontal', 'vertical'], default: 'horizontal') -- The type of the orientation: horizontal or vertical.

Return type:

None