https://github.com/robert-oleynik/xdg-desktop-portal-background

An desktop agnostic backend implementation of org.freedesktop.impl.portal.Background.
https://github.com/robert-oleynik/xdg-desktop-portal-background

Last synced: about 1 month ago
JSON representation

An desktop agnostic backend implementation of org.freedesktop.impl.portal.Background.

• Host: GitHub
• URL: https://github.com/robert-oleynik/xdg-desktop-portal-background
• Owner: robert-oleynik
• Created: 2024-03-03T10:53:18.000Z (11 months ago)
• Default Branch: main
• Last Pushed: 2024-03-05T15:30:37.000Z (11 months ago)
• Last Synced: 2024-11-09T18:05:30.823Z (3 months ago)
• Language: Rust
• Homepage:
• Size: 77.1 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# XDG Background Desktop Portal

> Note: this interface is early in development and is not stable yet.

This application provides a desktop agnostic implementation to register Autostart applications.

To do that, this program implements the `org.freedesktop.impl.portal.Background` portal, normally provided by GNOME or KDE.

# Usage

> **Important:** for an installation guide see [Wiki](https://github.com/robert-oleynik/xdg-desktop-portal-background/wiki/How-to-install-XDG-Background-Desktop-Portal)

This portal can be enabled in your current setup by adding `org.freedesktop.impl.portal.Background=background` to your `-portals.conf`.

For Hyprland this would look like:

```ini

# File: ~/.config/xdg-desktop-portal/hyprland-portals.conf or /usr/share/xdg-desktop-portal/hyprland-portals.conf

[preferred]

default=hyprland;gtk

org.freedesktop.impl.portal.Background=background

```

# Limitations

Can not track if an application has a visible or open window.

As a result it will always report applications as running in background.

In addition, this application does not start registered applications on startup.

This can be done by using [dex](https://github.com/jceb/dex) or similar applications.

# To-Do

- [ ] Send system notifications to request background execution.

- [x] Use autostart directory

- [ ] Handle D-Bus activatable applications (Handle Autostart flags)