A collection of several xdg-desktop-portal implementations to serve more lightweight wayland compositors like Hyprland
- App Chooser - choose an application
- Settings - control color scheme, accent color and appearance
Available via:
- nix: atomicptr/nix via pkgs.atomicptr.xdg-desktop-portal-zenzai
- cargo: xdg-desktop-portal-zenzai (use meson to properly install everything)
Edit $XDG_CONFIG_HOME/xdg-desktop-portal-zenzai/config.toml
# define your terminal here, this will be used by some services (AppChooser only right now)
terminal = "ghostty"
### App Chooser Portal Config
[appchooser]
enabled = true
[appchooser.runner]
type = "dmenu" # currently only dmenu style API is supported (list of files into stdin)
command = "wofi"
arguments = ["--dmenu"]
# list of content types -> app associations
[appchooser.defaults]
"text/plain" = { command = "ghostty", arguments = ["-e", "nvim"] } # run arbitrary commands
"image/jpeg" = "io.github.woelper.Oculante" # or execute desktop files
"image/webp" = ["io.github.woelper.Oculante.desktop", "com.brave.Browser.desktop"] # you can also always pick from a group
### Settings Portal Config
[settings]
enabled = true # portals have to be explicitly enabled
color-scheme = "dark" # set color scheme to dark/light
accent-color = "#b4befe" # define an accent color
# some apps query arbitrary data from the settings portal which you can set like this:
[settings.dict."org.gnome.SomeApp"]
some-key = "some value"
some-number = 1337To use zenzai you need to create ~/.config/xdg-desktop-portal/CURRENT_DESKTOP_NAME-portals.conf, for example, if you use Hyprland, you need to name it Hyprland-portals.conf.
[preferred]
default=hyprland;zenzai;gtk
org.freedesktop.impl.portal.AppChooser=zenzai
org.freedesktop.impl.portal.Settings=zenzai
The goal for me is to use this to replace xdg-desktop-portal-gtk completely on my Hyprland setup.
GPLv3
