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.
- device
Deprecated Request access to specific devices such as camera, speakers or microphone. - Install launchers like Web Application from your browser or Steam.
- 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§
- A representation of an icon.
- Persistence mode for a screencast or remote desktop session.
- A typical response returned by the
Request::response
. of aRequest
. - An error returned a portal request caused by either the user cancelling the request or something else.