Dynamic Launcher


Dynamic launcher portal backend interface

This documentation describes version 1 of this interface.



SupportedLauncherTypes readable u

A bitmask of available launcher types. Currently defined types are:

  • 1: Application. A launcher that represents an application.

  • 2: Webapp. A launcher that represents a web app.


version readable u



PrepareInstall (
  IN handle o,
  IN app_id s,
  IN parent_window s,
  IN name s,
  IN icon_v v,
  IN options a{sv},
  OUT response u,
  OUT results a{sv}

Presents a dialog to the user to allow them to see the icon, potentially change the name, and confirm installation of the launcher.

Supported keys in the options vardict:

  • modal (b)

    Whether to make the dialog modal. Defaults to yes.

  • launcher_type (u)

    The type of launcher being created. For supported values see the SupportedLauncherTypes property. Defaults to “Application”.

  • target (s)

    For a launcher of type “Webapp”, this is the URL of the web app being installed. This is displayed in the user-facing dialog. For other launcher types, this is not needed.

  • editable_name (b)

    If true, the user will be able to edit the name of the launcher. Defaults to true.

  • editable_icon (b)

    If true, the user will be able to edit the icon of the launcher, if the implementation supports this. Defaults to false.

The following results get returned via the results vardict:

  • name (s)

    The name chosen by the user for the launcher (or the default if the editable_name option was false).

  • icon (v)

    The icon chosen by the user for the launcher (or the default if the editable_icon option was false).


Object path for the Request object representing this call


App id of the application


Identifier for the application window, see Window Identifiers


The default name for the launcher


A #GBytesIcon as returned by g_icon_serialize()


Vardict with optional further information


Numeric response (0 == success)


Vardict with the results of the call


RequestInstallToken (
  IN app_id s,
  IN options a{sv},
  OUT response u

The response returned by this method is used to determine whether to give an install token to the caller, which can be used to avoid the need for a confirmation dialog; the token can be passed to the org.freedesktop.portal.DynamicLauncher.Install method just as if it were acquired via the org.freedesktop.portal.DynamicLauncher.PrepareInstall method.

It is up to the portal implementation to decide whether this method is allowed based on the app_id of the caller.

The options vardict currently has no supported entries.


App id of the application


Vardict with optional further information


0 if the caller should be allowed to do non-interactive launcher installation, a nonzero number otherwise