From 28e9430bd21764b68023a0065b169ff03e12a395 Mon Sep 17 00:00:00 2001 From: Mavridis Philippe Date: Thu, 1 Feb 2024 16:57:06 +0200 Subject: [PATCH] Add README Signed-off-by: Mavridis Philippe --- README.md | 39 +++++++++++++++++++++++++++++++++++++++ 1 file changed, 39 insertions(+) create mode 100644 README.md diff --git a/README.md b/README.md new file mode 100644 index 0000000..9b09bad --- /dev/null +++ b/README.md @@ -0,0 +1,39 @@ +# xdg-desktop-portal-tde + +## What is this? + +This is an implementation of the [FreeDesktop Portals API](https://flatpak.github.io/xdg-desktop-portal). + +THIS IS AN EARLY PROTOTYPE. USE WITH CARE. + +This implementation exposes TDE APIs to applications which use the Portals API. As a result, these applications +can transparently use native APIs and dialogs. + +Read more about the portals API on its official [website](https://flatpak.github.io/xdg-desktop-portal/docs/introduction.html). + +## How do I use this? +Before using this, make sure you have the `xdg-desktop-portal` package installed and running on your system. + +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. + +## State of implementation + +Currently implemented are the following interfaces: +* FileChooser - request a file dialog + +The following implementations are planned (listed in no particular order): +* Screenshot - request a screenshot +* App Chooser - show a "Open with..." dialog for a file +* Clipboard - request clipboard access (*) +* Email - request to send an e-mail via the system e-mail client +* OpenURI - request to open a URL +* Secret - integration with TDEWallet +* Account - request user information (username, full name, user icon) +* 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).