This is an open-source driver for the Fantech X9 Thor RGB gaming mouse targeted for linux systems (although it should work in any environment that supports gtk).
The project is written in python3 so that's a core requirement.
Gtk3 and gobject-introspection are required for the GUI to work, refer to your distro's documentation on how to get those installed, although a lot of popular distros will have it pre-installed so you can skip this if it is.
The following python module is also required:
pyusb
To install the module simply running pip install pyusb should suffice (if you don't have pip refer to your distro's documentation on how to get it).
Some distros (like arch) also provide standalone packages that will install pyusb to your system so search in your repos if you'd prefer your package manager to handle it for you instead of pip.
Simply clone the repo using git.
git clone https://github.com/GuessWhatBBQ/FantechX9ThorDriver.git
Run the file called driver_frontend.py using python
python driver_frontend.py
Since python needs access to the usb device, it might require appropriate UDEV rules to be set up (see here) or the program may need to be run as root (absolutely not recommended).
Running this should add the required UDEV rules for normal usage without sudo, a restart will most like be required for the changes to take effect.
echo "SUBSYSTEMS==\"usb\", ATTRS{idVendor}==\"18f8\", ATTRS{idProduct}==\"1086\", GROUP=\"users\", MODE=\"0660\"" | sudo tee /etc/udev/rules.d/50-fantechdriver.rules
This requires your system to have a group called users and your current user also needs to be added to the group. You could also modify the above command to add the permission to a group you're already a part of by modifiying "users" to the appropriate group name.
If you want to go the recommended route and dont have a group called users or are not added to the group then run:
sudo groupadd users
sudo usermod -a -G users your_user_name
After which you'll need to logout and log back in, or restart for good measure.
Another way is running it like this: sudo python driver_frontend.py (but again this is absolutely not recommended, use at your own risk).
Since the project is written in python you can simply download the 2 files (driver_backend.py and driver_frontend.py) to the same folder and achieve the same functionality.
The current configuration you have set will be saved when the save configuration button is pressed, in a file called driver.conf in the same folder the program is run from.
