gx52
WARNING: This is a mirror of the GitLab repository. Please go there to open new issues or Pull Requests.
GPL-3.0 License
GX52
GX52 is a GTK application designed to provide control for the LEDs and MFD of Logitech X52 and X52 Pro H.O.T.A.S.
💡 Features
- Set LEDs color (X52 Pro only)
- Turn on/off individual LEDs (X52 Pro only)
- Set LEDs brightness
- Set MFD brightness
- Update MFD date and time
- Show on MFD which button is currently pressed
- Save and restore multiple profiles
📦 How to get GX52
Install from Flathub
This is the preferred way to get GX52 on any major distribution (Arch, Fedora, Linux Mint, openSUSE, Ubuntu, etc).
If you don't have Flatpak installed you can find step by step instructions here.
Make sure to have the Flathub remote added to the current user:
flatpak --user remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo
Install
flatpak --user install flathub com.leinardi.gx52
Run
flatpak run com.leinardi.gx52
Install from source code
Build time dependencies
| Distro | pkg-config | Python 3.6+ | gobject-introspection | meson | ninja-build | appstream-util | libusb-1.0-0 | libudev | gtk3+ |
|---|---|---|---|---|---|---|---|---|---|
| Arch Linux | pkg-config | python | gobject-introspection | meson | ninja | appstream-glib | libusb | libudev0 | libgtk-3 |
| Fedora | pkgconf-pkg-config | python3 | gobject-introspection-devel | meson | ninja-build | appstream-util | libusbx-devel | libudev-devel | libgtk-3-dev |
| Ubuntu | pkg-config | python3 | libgirepository1.0-dev | meson | ninja-build | appstream-util | libusb-1.0-0-dev | libudev-dev | libgtk-3-dev |
Run time dependencies
| Distro | Python 3.6+ | pip | gobject-introspection | libappindicator | gnome-shell-extension-appindicator |
|---|---|---|---|---|---|
| Arch Linux | python | python-pip | gobject-introspection | libappindicator3 | gnome-shell-extension-appindicator |
| Fedora | python3 | python3-pip | gobject-introspection-devel | libappindicator-gtk3 | gnome-shell-extension-appindicator |
| Ubuntu | python3 | python3-pip | libgirepository1.0-dev | gir1.2-appindicator3-0.1 | gnome-shell-extension-appindicator |
plus all the Python dependencies listed in requirements.txt
Clone project and install
If you have not installed GX52 yet:
git clone --recurse-submodules -j4 https://gitlab.com/leinardi/gx52.git
cd gx52
git checkout release
sudo -H pip3 install -r requirements.txt
meson . build --prefix /usr
ninja -v -C build
sudo ninja -v -C build install
Update old installation
If you installed GX52 from source code previously and you want to update it:
cd gx52
git fetch
git checkout release
git reset --hard origin/release
git submodule init
git submodule update
sudo -H pip3 install -r requirements.txt
meson . build --prefix /usr
ninja -v -C build
sudo ninja -v -C build install
Run
Once installed, to start it you can simply execute on a terminal:
gx52
Running the app
To start the app you have to run the command gx52 in a terminal. The app needs to access the USB interface of the X52 that, normally,
is not available to unprivileged users.
To allow normal users to access the X52's USB interface you can create a custom udev rule
Adding Udev rule
Using GX52
Simply run:
gx52 --add-udev-rule
It will automatically refresh also the udev rules.
Manually
Create a new file in /lib/udev/rules.d/60-gx52.rules containing this text:
SUBSYSTEMS=="usb", ATTRS{idVendor}=="06a3", ATTRS{idProduct}=="0762", MODE="0666"
SUBSYSTEMS=="usb", ATTRS{idVendor}=="06a3", ATTRS{idProduct}=="0255", MODE="0666"
SUBSYSTEMS=="usb", ATTRS{idVendor}=="06a3", ATTRS{idProduct}=="075c", MODE="0666"
After that, run the following commands
sudo udevadm control --reload-rules
sudo udevadm trigger --subsystem-match=usb --attr-match=idVendor=06a3 --action=add
Command line options
| Parameter | Description | Source | Flatpak |
|---|---|---|---|
| -v, --version | Show the app version | x | x |
| --debug | Show debug messages | x | x |
| --hide-window | Start with the main window hidden | x | x |
| --add-udev-rule | Add udev rule to allow execution without root permission | x | x |
| --remove-udev-rule | Remove udev rule that allow execution without root permission | x | x |
| --autostart-on | Enable automatic start of the app on login | x | |
| --autostart-off | Disable automatic start of the app on login | x |
🖥️ Build, install and run with Flatpak
If you don't have Flatpak installed you can find step by step instructions here.
Make sure to have the Flathub remote added to the current user:
flatpak --user remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo
Clone the repo
git clone --recurse-submodules -j4 https://gitlab.com/leinardi/gx52.git
It is possible to build the local source or the remote one (the same that Flathub uses)
Local repository
./build.sh --flatpak-local --flatpak-install
Remote repository
./build.sh --flatpak-remote --flatpak-install
Run
flatpak run com.leinardi.gx52 --debug
❓ FAQ
The Flatpak version of GX52 is not using my theme, how can I fix it?
To fix this issue install a Gtk theme from Flathub. This way, Flatpak applications will automatically pick the installed Gtk theme and use that instead of Adwaita.
Use this command to get a list of all the available Gtk themes on Flathub:
flatpak --user remote-ls flathub | grep org.gtk.Gtk3theme
And then just install your preferred theme. For example, to install Yaru:
flatpak install flathub org.gtk.Gtk3theme.Yaru
Where are the settings and profiles stored on the filesystem?
| Installation type | Location |
|---|---|
| Flatpak | $HOME/.var/app/com.leinardi.gx52/ |
| Source code |
$XDG_CONFIG_HOME (usually $HOME/.config/gx52) |
💚 How to help the project
Discord server
If you want to help testing or developing it would be easier to get in touch using the discord server of the project: https://discord.gg/HTCrmU8 Just write a message on the general channel saying how you want to help (test, dev, etc) and quoting @leinardi. If you don't use discor but still want to help just open a new issue here.
Can I support this project some other way?
Something simple that everyone can do is to star it on both GitLab and GitHub. Feedback is always welcome: if you found a bug or would like to suggest a feature, feel free to open an issue on the issue tracker.
License
This file is part of gx52.
Copyright (c) 2019 Roberto Leinardi
gx52 is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
gx52 is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with gx52. If not, see <http://www.gnu.org/licenses/>.