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? ## How do I use this?
Before using this, make sure you have the `xdg-desktop-portal` package installed and running on your system. 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 - **GTK+3/4 applications**: environment variables `GDK_DEBUG=portals` or `GTK_USE_PORTAL=1`;
some Chromium-based browsers, e.g. Vivaldi). - **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, **WARNING!** Some Gtk+ applications don't respect the `GTK_USE_PORTAL=1` and `GDK_DEBUG=portals` environment variables (e.g. Inkscape).
if they are set to 2, set them to 1.
## 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) * Account - request user information (user ID, full name, user icon)
* Email - request to send an e-mail via the system e-mail client * Email - request to send an e-mail via the system e-mail client
* FileChooser - request a file dialog * FileChooser - request a file dialog
The following implementations are planned (listed in no particular order): The following implementations are considered (listed in alphabetical order):
* Screenshot - request a screenshot * Access - show a grant access dialog
* App Chooser - show a "Open with..." dialog for a file * App Chooser - show a "Open with..." dialog for a file
* Clipboard - request clipboard access (*) * 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 * Secret - integration with TDEWallet
* Access - show a grant access dialog
* Wallpaper - request to change the user's wallpaper * Wallpaper - request to change the user's wallpaper
* Print - request a file to be printed
(*) Needs Session interface implementation (*) 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