UXPlay Control

UXPlay Control is an extension for GNOME Shell that allows users to start and configure the UXPlay command-line interface through a simple GUI on the top bar and comprehensive settings within the GNOME Extensions app.

Starting from version 8, UXPlay Control no longer relies on command-line flags to configure UXPlay. Instead, it generates a native UXPlay configuration file.

• The file is automatically generated and stored at: ~/.config/uxplay-control/uxplayrc
• Please do not edit this file manually, as the extension will overwrite your changes whenever you adjust settings via the UI.
• All existing settings from v7 have been automatically migrated.

You can make UXPlay start automatically at login without keeping the extension panel menu open. Open the General preferences page and enable Start UXPlay on login. The extension then writes a standard XDG autostart entry to:

~/.config/autostart/uxplay-control.desktop

The entry uses the same ~/.config/uxplay-control/uxplayrc that the extension manages, so any settings you change in Preferences apply to the auto-launched instance. You can also configure a startup delay (in seconds) on the same page, useful if your network or audio services need a moment to come up.

To disable the autostart entirely, either toggle the switch off in Preferences or delete the .desktop file. Disabling the extension itself does not remove the autostart entry — your choice to autostart UXPlay is preserved.

If for some reason you don't want to use the official GNOME Extensions site, you can install the extension manually.
Don't forget that you need to have uxplay, gnome-tweaks, and gnome-extensions installed on your system to actually use the extension.

1. Clone this repository:

   git clone https://github.com/xxanqw/uxplay-control.git
   cd uxplay-control

2. Run the packaging script:

   ./package.sh <<<'y' # 'y' to install automatically, 'n' to install manually

3. Restart GNOME Shell (Alt+F2, type r, press Enter) and enable the extension.

To set up a development environment, follow these steps:

1. Fork this repository, then clone your fork:

   git clone https://github.com/your-username/uxplay-control.git
   cd uxplay-control

2. Do your changes.

3. Run the packaging script:

   ./package.sh <<<'y' # 'y' to install automatically, 'n' to install manually

4. Create a pull request if you want to contribute your changes.

This extension serves as a companion to UXPlay, developed by FDH2. Please note that UXPlay must be installed independently as a prerequisite for this extension to operate correctly.

gnome-tweaks: Available on your distro repositories.
gnome-extensions: Available on Flathub