Skip to main content

Python MSI Keys

Project description

Python MSI Keys
===============
Neat-O python app to control your fancy MSI steelseries keyboard backlight. I learned the protocol by reading the
code in this node project https://github.com/wearefractal/msi-keyboard.

Note that you must have permission to talk to your hid devices. Otherwise, you have to run this code with ```sudo```

Installing
----------
```
sudo pip install msikeys
```

You'll likely have to create a new udev rule in /etc/udev/rules.d/10-msikeys.rules so that your user can talk to this device
```
SUBSYSTEM=="usb", ATTR{idVendor}=="1770", ATTR{idProduct}=="ff00", GROUP="input", SYMLINK+="msikeyboard_backlight"
```
Note that your user must be a member of the group in the above rule.

Then reboot or do something like
```
sudo udevadm control --reload-rules && sudo udevadm trigger
```

Running
-------
To initialize your config:
```
msikeys-config.py
```

To apply your config at startup:
```
msikeys-init.py
```

Examples
--------
Green keyboard:
```
import msikeys

kb = msikeys.get_keyboard()
kb.colors = msikeys.Color.GREEN
kb.commit()
```

Team amurica keyboard:
```
import msikeys

kb = msikeys.get_keyboard()
kb.colors = [msikeys.Color.RED, msikeys.Color.WHITE, msikeys.Color.BLUE]
kb.commit()
```

Load keyboard at login (in your ~/.bash_profile):
```
msikeys-init.py
```

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

msikeys-0.0.3.tar.gz (5.0 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page