Skip to content

README.md

Latest commit

 

History

History
66 lines (40 loc) · 1.63 KB

README.md

File metadata and controls

66 lines (40 loc) · 1.63 KB

Fantech X9 Thor RGB Gaming Mouse Driver

This open-source driver, designed for Linux systems (also compatible with environments supporting GTK), enables enhanced control of the Fantech X9 Thor RGB gaming mouse.

Requirements

Ensure you have the following prerequisites:

  • Python 3
  • Gtk3 and gobject-introspection (check your distro's documentation)
  • Python module: pyusb (install with pip install pyusb)

Usage

Clone the repository:

git clone https://github.com/muharamdani/FantechX9ThorDriver.git

Run the driver frontend:

python3 driver_frontend.py

Configuration

Check your mouse's product ID and vendor ID using lsusb. Modify driver_backend.py if different from defaults. Example:

Bus 001 Device 007: ID 18f8:0fc0 [Maxxter] USB GAMING MOUSE

Vendor ID: 18f8, Product ID: 0fc0

USB Device Access

For proper USB device access:

  1. Set UDEV rules (recommended method):
echo "SUBSYSTEMS==\"usb\", ATTRS{idVendor}==\"18f8\", ATTRS{idProduct}==\"0fc0\", GROUP=\"users\", MODE=\"0660\"" | sudo tee /etc/udev/rules.d/50-fantechdriver.rules

Ensure your system has a group named users, and your user is part of this group.

  1. Alternative method (not recommended):

Run as root (not recommended for security reasons):

sudo python driver_frontend.py

Configuration Persistence

The current configuration is saved in driver.conf upon pressing the "Save Configuration" button.

Preview:

example

License

This project is licensed under the GNU General Public License v3.0 - see the LICENSE file for details.