Bazzite Portal

Demo - KDE Plasma

Demo - GNOME

A GTK4 interface for the Bazzite Portal, providing quick access to various useful scripts, fixes, and QOL tweaks for the terminal averse. Supports mouse, keyboard, and gamepad.

On installed systems, the default configuration file is located at:

/usr/share/yafti/yafti.yml

Installing

Bazzite includes the Portal by default.

On Fedora/Fedora based systems, install the Terra repository. Then, run the following command:

sudo dnf install bazzite-portal

Running

The application requires a YAML configuration file path as a command-line argument.

One-shot actions open commands in your system's default terminal through xdg-terminal-exec. Actions with options can define a modal with explicit buttons and a headless status check.

On Bazzite (default config)

yafti_gtk.py /usr/share/yafti/yafti.yml

With Custom Config

yafti_gtk.py /path/to/custom/yafti.yml

Desktop Shortcut

The installed desktop file automatically launches with the default Bazzite config path. You can find it in your application menu as "Bazzite Portal".

Controller support

The app uses SDL3 (3.2+) for gamepad navigation, with no additional Python package. All connected SDL-recognized gamepads can control the app using SDL's default filtering. Controller support starts automatically; mouse and keyboard remain available if SDL3 is missing.

• D-pad / stick up and down: navigate actions.
• A / Cross: select. B / Circle: back or clear search.
• LB / RB: switch tabs.
• X / Square: focus search and request Steam's keyboard in Gaming Mode.
• Y / Triangle: toggle Launch at startup.

Button glyphs appear when a controller is used. For Steam Gaming Mode, add the app as a non-Steam game.

Configuration

The app reads a yafti.yml configuration file to populate tabs and actions.

One-shot actions launch directly in a terminal:

screens:
  - title: "Category Name"
    actions:
      - title: "Action Title"
        description: "Optional description"
        script: "command to run"

Managed actions open a modal instead. The modal runs status_script headlessly, then shows the configured buttons:

screens:
  - title: "Category Name"
    actions:
      - id: "sunshine"
        title: "Sunshine"
        description: "A self-hosted game stream host for Moonlight"
        status_script: |
          if systemctl is-enabled --user app-dev.lizardbyte.app.Sunshine.service >/dev/null 2>&1; then
            echo enable
          else
            echo disable
          fi
        options:
          - id: "enable"
            label: "Enable"
            script: "ujust setup-sunshine enable"
          - id: "disable"
            label: "Disable"
            script: "ujust setup-sunshine disable"

Rules:

• Actions with options or status_script use the modal flow.
• Actions with only script launch directly in a terminal.
• status_script should print a short stable status string such as enable, disable, or install-beta.
• Modal button highlighting matches the returned status string against the option id.

Development

Run controller tests:

python3 -m unittest discover -s tests -v

Check scrolling on Linux with GTK4 and Xvfb:

xvfb-run -a python3 tests/gtk_scroll_smoke.py

Distribution packages should include the native SDL3 dependency.