Git Product home page Git Product logo

sidewinderd's Introduction

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 G105
  • Logitech G710
  • Logitech G710+

Install

Please check, if this project has already been packaged for your specific Linux distribution. Currently maintained packages:

If there are no packages available for your Linux distribution, please proceed with the manual installation from source:

  1. Install the following dependencies. Please refer to your specific Linux distribution, as package names might differ.
  • cmake 2.8.8 (make)
  • libconfig 1.4.9
  • tinyxml2 2.2.0
  • libudev 210
  1. Create a build directory in the toplevel directory:

    mkdir build
    
  2. Run cmake from within the new build directory:

    cd build
    cmake ..
    
  3. Compile and install:

    make
    make install
    

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.

Contribution

In order to contribute to this project, you need to read and agree the Developer Certificate of Origin, which can be found in the CONTRIBUTING file. Therefore, commits need to be signed-off. You can do this by adding the -s flag when commiting: git commit -s. Pseudonyms and anonymous contributions will not be accepted.

License

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

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.