Exceptions

Here is a list of Ignis exceptions. They may be raised by various components in the case of an error.

To access them, use the ignis.exceptions module.

from ignis.exceptions import SomeException

exception ignis.exceptions.WindowNotFoundError(window_name: str, *args) → None

Raised when a window is not found.

property window_name: str

• required, read-only

The name of the window.

exception ignis.exceptions.WindowAddedError(window_name: str, *args) → None

Raised when a window is already added to the application.

property window_name: str

• required, read-only

The name of the window.

exception ignis.exceptions.ServiceNotFoundError(service_name: str, *args: object) → None

Raised when a service with the given name is not found.

property service_name: str

• required, read-only

The name of the service.

exception ignis.exceptions.GvcNotFoundError(*args) → None

Raised when Gvc is not found.

exception ignis.exceptions.HyprlandIPCNotFoundError(*args: object) → None

Raised when Hyprland IPC is not found.

exception ignis.exceptions.NetworkManagerNotFoundError(*args: object) → None

Raised when NetworkManager is not found.

exception ignis.exceptions.OptionNotFoundError(option_name: str, *args) → None

Raised when an option is not found.

property option_name: str

• required, read-only

The name of the option.

exception ignis.exceptions.OptionExistsError(option_name: str, *args) → None

Raised when an option already exists.

property option_name: str

• required, read-only

The name of the option.

exception ignis.exceptions.OptionsGroupNotFoundError(options_group: str, *args) → None

Raised when an options group is not found.

property options_group: str

• required, read-only

The name of the options group.

exception ignis.exceptions.OptionsGroupExistsError(options_group: str, *args) → None

Raised when an options group exists.

property options_group: str

• required, read-only

The name of the options group.

exception ignis.exceptions.GstNotFoundError(*args: object) → None

Raised when GStreamer is not found.

exception ignis.exceptions.GstPluginNotFoundError(plugin_name: str, plugin_package: str, *args) → None

Raised when a GStreamer plugin is not found.

property plugin_name: str

• required, read-only

The name of the plugin.

property plugin_package: str

• required, read-only

The package name of the plugin.

exception ignis.exceptions.SassCompilationError(stderr: str, *args: object) → None

Raised when Dart Sass compilation fails.

property stderr: str

• required, read-only

The stderr output from Dart Sass.

exception ignis.exceptions.DartSassNotFoundError(*args: object) → None

Raised when Dart Sass is not found.

exception ignis.exceptions.MonitorNotFoundError(monitor_id: int, *args: object) → None

Raised when a monitor with the given ID is not found.

property monitor_id: int

• required, read-only

The ID of the monitor.

exception ignis.exceptions.LayerShellNotSupportedError(*args: object) → None

Raised when the Layer Shell protocol is not supported.

exception ignis.exceptions.IgnisNotRunningError(*args: object) → None

Raised when Ignis is not running.

exception ignis.exceptions.DBusMethodNotFoundError(method_name: str, *args: object) → None

Raised when a D-Bus method is not found or not registered.

property method_name: str

• required, read-only

The name of the D-Bus method.

exception ignis.exceptions.DBusPropertyNotFoundError(property_name: str, *args: object) → None

Raised when a D-Bus property is not found or not registered.

property property_name: str

• required, read-only

The name of the D-Bus property.

exception ignis.exceptions.DisplayNotFoundError(*args: object) → None

Raised when the display is not found (e.g., a Wayland compositor is not running).

exception ignis.exceptions.StylePathNotFoundError(style_path: str, *args: object) → None

Raised when the style path is not found / not applied to the application.

property style_path: str

• required, read-only

Path to the .css/.scss/.sass file.

exception ignis.exceptions.StylePathAppliedError(style_path: str, *args: object) → None

Raised when the style path is already applied to the application.

property style_path: str

• required, read-only

Path to the .css/.scss/.sass file.

exception ignis.exceptions.Gtk4LayerShellNotFoundError(*args: object) → None

Raised when GTK4 Layer Shell is not found.

exception ignis.exceptions.CssParsingError(section: gi.repository.Gtk.CssSection, gerror: gi.repository.GLib.GError, *args: object) → None

Raised when a CSS parsing error occurs.

property section: gi.repository.Gtk.CssSection

• required, read-only

The section the error happened in.

property gerror: gi.repository.GLib.GError

• required, read-only

The parsing error.

exception ignis.exceptions.AnotherNotificationDaemonRunningError(name: str, *args: object) → None

Raised when another notification daemon is running.

property name: str

• required, read-only

The name of the currenly running notification daemon.

exception ignis.exceptions.AnotherSystemTrayRunningError(name: str, *args: object) → None

Raised when another system tray is running.

property name: str

• required, read-only

The name of the currenly running system tray.

exception ignis.exceptions.UPowerNotRunningError(*args: object) → None

Raised when UPower is not running.