Applications#

class ignis.services.applications.ApplicationsService(*args: Any, **kwargs: Any)#

Provides a list of applications installed on the system. It also allows "pinning" of apps and retrieving a list of pinned applications.

Properties:
  • apps (list[Application], read-only): A list of all installed applications.

  • pinned (list[Application], read-only): A list of all pinned applications.

Example usage:

from ignis.service.applications import ApplicationsService

applications = ApplicationsService.get_default()
for i in applications.apps:
    print(i.name)
search(query: str) list[Application]#

Filter applications by query.

Parameters:

query (str) -- the string to be searched for

Returns:

A list of applications filtered by provided query.

Return type:

list[Application]

class ignis.services.applications.Application(*args: Any, **kwargs: Any)#

An application object.

Signals:
  • "pinned": Emitted when the application has been pinned.

  • "unpinned": Emitted when the application has been unpinned.

Properties:
  • app (Gio.DesktopAppInfo, read-only): An instance of Gio.DesktopAppInfo. You typically shouldn't use this property.

  • id (str | None, read-only): The ID of the application.

  • name (str, read-only): The name of the application.

  • description (str | None, read-only): The description of the application.

  • icon (str, read-only): The icon of the application. If the app has no icon, "image-missing" will be returned.

  • keywords (list[str], read-only): Keywords of the application. Ususally, these are words that describe the application.

  • desktop_file (str | None, read-only): The full path to the .desktop file of the application.

  • executable (str | None, read-only): The executable of the application.

  • exec_string (str, read-only): The string that contains the executable with command line arguments, used to launch the application.

  • actions (list[Application], read-only): A list of actions.

  • is_pinned (bool, read-write): Whether the application is pinned.

pin() None#

Pin the application.

unpin() None#

Unpin the application.

launch() None#

Launch the application.

class ignis.services.applications.ApplicationAction(*args: Any, **kwargs: Any)#

Application action.

Properties:
  • action (str, read-only): ID of the action.

  • name (str, read-only): Human-readable name of the action.

launch() None#

Launch action.