razer-osx-led-gui

This is an agent status bar app that controls keyboard leds on a Razer Blade laptop running on MacOS.

It's basically a wrapper for the command-line application osx-razer-led originally developed by @DocSystem, building upon work by @kprinssu and @dylanparker, and the linux driver code by @terrycain. With some special glue.

Usage

Download the latest release. Just drop the app into your applications folder. You don't need to install the original razer-osx-led script, it's baked in. You can add it to your startup items to have the saved settings apply after startup.

NOTE: You can force the color pickers to appear using Alt+click on the color wells. I don't know why the color wells don't always bring up the color pickers. Not closing the color picker before dismissing the window causes this to happen immediately, but no idea how to force a new instance directly from the code. If anyone can help, it would be awesome.

The currently supported effects are the same as in the original command line app, with some adaptations. Your device might not support all of them.

info: Used internally to show detected device
static: Accepts optional color. Set all keys to color (or green default if not specified)
breathe: Accepts 2 optional colors. Pulse keys with color, or between both colors specified (or random colors if none specified)
starlight: Accepts optional color. Twinkle effect with custom color. Speed not implemented, defaults to 2. NT
reactive: Accepts optional color. Keys light up with color and fade when pressed. Defaults to green. Speed not implemented, defaults to 2. NT
spectrum: Cycles through color spectrum
wave: Spectrum colored wave accross keyboard. Direction not implemented, defaults to right. NT
brightness: Slider passes an integer (0-255) that sets the brightness value.
logo: Turns the back logo on or off. NT

NT: Haven't been able to test, as this effect is not supported by my hardware.

To do

Add contraints to views and clean up layout

BUGS:

Color pickers don't always appear. Is there a way to integrate them in the view? Help!
Dismissing 'About' view without clicking on 'Back' leaves the app in an undetermined state, with no way to quit.
Driver not always responds correctly; this isn't handled at all. Should retry?

Nice to haves:

Some kind of error management?
Check selected things to see if they form a compatible combination for command.

Acknowledgements

These are the repos where most of the actual work was done:

License

This project unless otherwise stated in the file is licensed under the GPLv2 license.

reven/razer-osx-led-gui