notsocheezy/sidewinderd

Description

#Sidewinder daemon#

This project provides support for gaming peripherals under Linux. It was originally designed for the Microsoft SideWinder X4, but we have extended support for more keyboards. Our goal is to create a framework-like environment for rapid driver development under Linux.

#Supported devices#

Microsoft SideWinder X4
Microsoft SideWinder X6
Logitech G103
Logitech G105
Logitech G710
Logitech G710+

#License#

This project is made available under the MIT License. For more information, please refer to the LICENSE file.

#Distribution#

This is an unofficial build not directly affiliated with the developers, provided for your (in?)convenience. Please do not report issues related to installation on the tolga9009/sidewinderd GitHub repository. Tested on Fedora 42.

Installation Instructions

#Usage#

Enable and start Sidewinder daemon:

systemctl enable sidewinderd.service
systemctl start sidewinderd.service

Configure /etc/sidewinderd.conf according to your needs. Please change the user, as the default user is root.

You can now use your gaming peripheral! Please note, that there is no graphical user interface. Some LEDs might light up, letting you know, that Sidewinder daemon has successfully recognized your keyboard.

#Record macros#

The macro keys are fully programmable, but there is no default event. You can add functions to them, by recording macros or key combinations:

1. Choose a profile. The profile LED on the device will show you, which profile is active.
2. Press record key. The record LED will light up.
3. Now, choose and press a macro key. On some devices, the record LED will begin to blink. You're now in macro mode. Please note, that existing macros may get overwritten.
4. Everything you type on the keyboard will get recorded. You can either record a single key combination or a long series of keypresses. Please note, that keypresses still send events to your operating system and your programs.
5. When done, press the record key again. This will stop recording and save the macro.
6. You've now created a macro. Use it by setting the chosen profile and pressing the chosen macro key.

#Known Issues#

See https://github.com/tolga9009/sidewinderd/issues/61 for a known bug on Fedora with GNOME and a workaround.

Active Releases

The following unofficial repositories are provided as-is by owner of this project. Contact the owner directly for bugs or issues (IE: not bugzilla).

Release	Architectures	Repo Download
Fedora 41	x86_64 (0)*	Fedora 41 (2 downloads)
Fedora 42	x86_64 (1)*	Fedora 42 (12 downloads)

* Total number of downloaded packages.