Skip to main content
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
```

Metadata

Release files for msikeys 0.0.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for msikeys 0.0.3
File Size Uploaded Provenance Actions
msikeys-0.0.3.tar.gz 5.0 kB Without provenance Details for msikeys-0.0.3.tar.gz

Release files / msikeys-0.0.3.tar.gz

Download URL msikeys-0.0.3.tar.gz
Size 5.0 kB
Tags Source
SHA-256 checksum
How to use checksums
69a86603f716fddfd1f86ccfbd14ac999b3f3c6c56ce9d2ddc3ebf5558a1b86a
BLAKE2b-256 checksum
How to use checksums
2f65246e8fa990283e74b5ea5ef3bee25693ed617e810532166264c272fbf767
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Security for msikeys 0.0.3

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page