.. _org.freedesktop.portal.DynamicLauncher:

======================================
 Dynamic Launcher
======================================



Portal for installing application launchers

The DynamicLauncher portal allows sandboxed (or unsandboxed) applications
to install launchers (.desktop files) which have an icon associated with them
and which execute a command in the application. The desktop environment
would display the launcher to the user in its menu of installed applications.
For example this can be used by a sandboxed browser to install web app
launchers. The portal also allows apps to uninstall the launchers, launch
them, and read the desktop file and icon data for them.

The standard way to install a launcher is to use the
:ref:`org.freedesktop.portal.DynamicLauncher.PrepareInstall` method
which results in a dialog being presented to the user so they can confirm
they want to install the launcher. Then, the token returned by
:ref:`org.freedesktop.portal.DynamicLauncher.PrepareInstall`
would be passed to the :ref:`org.freedesktop.portal.DynamicLauncher.Install`
method to complete the installation.

However, in the rare circumstance that an unsandboxed process such as a
system component needs to install a launcher without user interaction, this
can be accomplished by using the :ref:`org.freedesktop.portal.DynamicLauncher.RequestInstallToken`
method and passing the acquired token to :ref:`org.freedesktop.portal.DynamicLauncher.Install`.

This documentation describes version 1 of this interface.




.. include:: doc-org.freedesktop.portal.DynamicLauncher.properties.rst

.. include:: doc-org.freedesktop.portal.DynamicLauncher.methods.rst