Module ashpd::desktop

source ·
Expand description

Interact with the user’s desktop such as taking a screenshot, setting a background or querying the user’s location.

Modules§

  • Access to the current logged user information such as the id, name or their avatar uri.
  • Request to run in the background or started automatically when the user logs in.
  • Check if a camera is available, request access to it and open a PipeWire remote stream.
  • Interact with the clipboard.
  • Request access to specific devices such as camera, speakers or microphone.
  • Examples
  • Compose an email.
  • Open/save file(s) chooser. The interface lets sandboxed applications ask the user for access to files outside the sandbox. The portal backend will present the user with a file chooser dialog.
  • Enable/disable/query the status of Game Mode.
  • Register global shortcuts Register global shortcuts
  • Inhibit the session from being restarted or the user from logging out.
  • Capture input events from physical or logical devices.
  • Query the user’s GPS location.
  • Monitor memory level.
  • Check the status of the network on a user’s machine. Note This portal doesn’t work for sandboxed applications.
  • Send/withdraw notifications.
  • Open a URI or a directory.
  • Power profile monitoring.
  • Print a document.
  • Proxy information. Note This portal doesn’t work for sandboxed applications.
  • Set threads to realtime.
  • Start a remote desktop session and interact with it.
  • Start a screencast session and get the PipeWire remote of it.
  • Take a screenshot or pick a color.
  • Retrieve a per-application secret used to encrypt confidential data inside the sandbox.
  • Read & listen to system settings changes.
  • Move a file to the trash.
  • Set a wallpaper on lockscreen, background or both.

Structs§

  • A color as a RGB tuple.
  • The Request interface is shared by all portal interfaces. When a portal method is called, the reply includes a handle (i.e. object path) for a Request object, which will stay alive for the duration of the user interaction related to the method call.
  • Shared by all portal interfaces that involve long lived sessions.

Enums§