Update README

Signed-off-by: Mavridis Philippe <mavridisf@gmail.com>
pull/6/head
Mavridis Philippe 2 months ago
parent 53725cd5c9
commit 1cc658900d
No known key found for this signature in database
GPG Key ID: F8D2D7E2F989A494

@ -12,29 +12,31 @@ Read more about the portals API on its official [website](https://flatpak.github
## How do I use this?
Before using this, make sure you have the `xdg-desktop-portal` package installed and running on your system.
Some applications respect the `GTK_USE_PORTAL=1` and `GDK_DEBUG=portals` environment variables (most GTK applications and
some Chromium-based browsers, e.g. Vivaldi).
- **GTK+3/4 applications**: environment variables `GDK_DEBUG=portals` or `GTK_USE_PORTAL=1`;
- **Chromium-based browsers**: see GTK+ applications
- **Mozilla Firefox**: In about:config set `widget.use-xdg-desktop-portal.file-picker` to 1 (also check out any options that start with widget.use-xdg-desktop-portal.* to enable more portals).
- **Pale Moon**: [https://forum.palemoon.org/viewtopic.php?t=22985]
- **Qt applications**: unknown
To make Firefox use the Portals API, go to `about:config`, search for options that start with "widget.use-xdg-desktop-portal" and,
if they are set to 2, set them to 1.
**WARNING!** Some Gtk+ applications don't respect the `GTK_USE_PORTAL=1` and `GDK_DEBUG=portals` environment variables (e.g. Inkscape).
## State of implementation
## State of the implementation
Currently implemented are the following interfaces:
Currently implemented are the following interfaces (listed in alphabetical order):
* Account - request user information (user ID, full name, user icon)
* Email - request to send an e-mail via the system e-mail client
* FileChooser - request a file dialog
The following implementations are planned (listed in no particular order):
* Screenshot - request a screenshot
The following implementations are considered (listed in alphabetical order):
* Access - show a grant access dialog
* App Chooser - show a "Open with..." dialog for a file
* Clipboard - request clipboard access (*)
* OpenURI - request to open a URL
* Notification - show a notification
* Print - request a file to be printed
* Screenshot - request a screenshot
* Secret - integration with TDEWallet
* Access - show a grant access dialog
* Wallpaper - request to change the user's wallpaper
* Print - request a file to be printed
(*) Needs Session interface implementation
Additionaly, it must be noted that the implementation does not currently support the Documents portal API (and therefore sandboxed applications).
Additionally, it must be noted that the implementation does not currently support the Documents portal API (and therefore sandboxed applications).

Loading…
Cancel
Save