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)#

Raised when a window is not found.

Properties:
  • window_name (str, required, read-only): The name of the window.

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

Raised when a window is already added to the application.

Properties:
  • window_name (str, required, read-only): The name of the window.

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

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

Properties:
  • service_name (str, required, read-only): The name of the service.

exception ignis.exceptions.GvcNotFoundError(*args)#

Raised when Gvc is not found.

exception ignis.exceptions.HyprlandIPCNotFoundError(*args: object)#

Raised when Hyprland IPC is not found.

exception ignis.exceptions.NetworkManagerNotFoundError(*args: object)#

Raised when NetworkManager is not found.

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

Raised when an option is not found.

Properties:
  • option_name (str, required, read-only): The name of the option.

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

Raised when an option already exists.

Properties:
  • option_name (str, required, read-only): The name of the option.

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

Raised when an options group is not found.

Properties:
  • options_group (str, required, read-only): The name of the options group.

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

Raised when an options group exists.

Properties:
  • options_group (str, required, read-only): The name of the options group.

exception ignis.exceptions.GstNotFoundError(*args: object)#

Raised when GStreamer is not found.

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

Raised when a GStreamer plugin is not found.

Properties:
  • plugin_name (str, required, read-only): The name of the plugin.

  • plugin_package (str, required, read-only): The package name of the plugin.

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

Raised when Dart Sass compilation fails.

Properties:
  • stderr (str, required, read-only): The stderr output from Dart Sass.

exception ignis.exceptions.DartSassNotFoundError(*args: object)#

Raised when Dart Sass is not found.

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

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

Properties:
  • monitor_id (int, required, read-only): The ID of the monitor.

exception ignis.exceptions.LayerShellNotSupportedError(*args: object)#

Raised when the Layer Shell protocol is not supported.

exception ignis.exceptions.IgnisNotRunningError(*args: object)#

Raised when Ignis is not running.

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

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

Properties:
  • method_name (str, required, read-only): The name of the D-Bus method.

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

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

Properties:
  • property_name (str, required, read-only): The name of the D-Bus property.

exception ignis.exceptions.DisplayNotFoundError(*args: object)#

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

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

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

Properties:
  • style_path (str, required, read-only): Path to the .css/.scss/.sass file.

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

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

Properties:
  • style_path (str, required, read-only): Path to the .css/.scss/.sass file.

exception ignis.exceptions.Gtk4LayerShellNotFoundError(*args: object)#

Raised when GTK4 Layer Shell is not found.

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

Raised when a CSS parsing error occurs.

Properties:
  • section (Gtk.CssSection, required, read-only): Section the error happened in.

  • gerror (GLib.GError, required, read-only): The parsing error.

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

Raised when another notification daemon is running.

Properties:
  • name (str, required, read-only): The name of the currenly running notification daemon.

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

Raised when another system tray is running.

Properties:
  • name (str, required, read-only): The name of the currenly running system tray.