hyprwm/xdg-desktop-portal-hyprland
1
0
Fork 0
mirror of https://github.com/hyprwm/xdg-desktop-portal-hyprland.git synced 2024-11-05 00:05:58 +01:00
Code Issues Projects Releases Packages Wiki Activity

updated readme

Browse source
This commit is contained in:
Vaxry 2022-12-03 20:47:58 +00:00 committed by GitHub
parent 0a8bfa1460
commit f2e64940ae
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
1 changed files with 7 additions and 53 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

60
README.md
View file

@ -1,8 +1,12 @@
# xdg-desktop-portal-wlr
# xdg-desktop-portal-hyprland
[![builds.sr.ht status](https://builds.sr.ht/~emersion/xdg-desktop-portal-wlr/commits/master.svg)](https://builds.sr.ht/~emersion/xdg-desktop-portal-wlr/commits/master?)
[xdg-desktop-portal] backend for hyprland
[xdg-desktop-portal] backend for wlroots
## What and why?
Due to reasons explained in [hyprland-protocols](https://github.com/hyprwm/hyprland-protocols),
we have a separate desktop portal impl for Hyprland.
Although `-wlr` **does** work with Hyprland, `-hyprland` offers more features.
## Building
@ -19,58 +23,8 @@ ninja -C build
ninja -C build install
```
### Distro Packages
[![Packaging status](https://repology.org/badge/vertical-allrepos/xdg-desktop-portal-wlr.svg)](https://repology.org/project/xdg-desktop-portal-wlr/versions)
## Running
Make sure `XDG_CURRENT_DESKTOP` is set. Make sure `WAYLAND_DISPLAY` and
`XDG_CURRENT_DESKTOP` are imported into D-Bus. If you're running Sway, this
can be added to your config file:
exec dbus-update-activation-environment --systemd WAYLAND_DISPLAY XDG_CURRENT_DESKTOP=sway
When correctly installed, xdg-desktop-portal should automatically invoke
xdg-desktop-portal-wlr when needed.
### Configuration
See `man 5 xdg-desktop-portal-wlr`.
### Manual startup
At the moment, some command line flags are available for development and
testing. If you need to use one of these flags, you can start an instance of
xdpw using the following command:
```sh
xdg-desktop-portal-wlr -r [OPTION...]
```
To list the available options, you can run `xdg-desktop-portal-wlr --help`.
## FAQ
Check out or [FAQ] for answers to commonly asked questions.
Please see the [screencast compatibility] guide for more information on
compatible applications and how to get them working.
If you have a question or problem that is not mentioned in those documents,
please open an issue or come chat with us in #sway on Libera Chat.
## Contributing
If you're interested in testing or development, check out
[CONTRIBUTING.md] for more information.
## License
MIT
[xdg-desktop-portal]: https://github.com/flatpak/xdg-desktop-portal
[FAQ]: https://github.com/emersion/xdg-desktop-portal-wlr/wiki/FAQ
[screencast compatibility]: https://github.com/emersion/xdg-desktop-portal-wlr/wiki/Screencast-Compatibility
[CONTRIBUTING.md]: CONTRIBUTING.md