/razer-macos

Color effects manager for Razer keyboards and laptops on macOS Catalina.

Primary LanguageCGNU General Public License v2.0GPL-2.0

keyboard demo pic

Open source color effects manager for Razer keyboards on macOS

  • Custom color picker for static, reactive and starlight effects
  • Hardware based color controls Colors are saved to onboard memory
  • Supporting the latest macOS Official drivers (Synapse 2) supports only up to macOS 10.14 Mojave. There are no also plans from Razer to support macOS with Synapse 3 (source)

Download

Latest release

Device support

All Razer keybords are supported, with other peripherals being added in the future. For a complete list of supported keyboards see openrazer.

Confirmed working for:

  • Razer BlackWidow Elite
  • Razer Ornata Chroma
  • Razer Huntsman
  • Razer Huntsman Elite
  • Razer Huntsman TE

FAQ

Q: Selecting a colour setting has no effect on my keyboard

A: It is possible that a wrong on-board keyboard profile has been selected. Change to a different profile and try again.

Q: Menu says "No device found".

A: Razer keyboard needs to be plugged in. Quit the application, plug in the keyboard and restart the application.

Developer usage

Ensure xcode command line tools are installed,

Install node package dependencies:

yarn

Run development server:

yarn dev

During development, every time the driver code has been updated, a rebuild is required:

yarn rebuild

For building a distribution ready app and dmg:

yarn dist

Implementation

Project includes both hardware drivers and frontend UI.

Drivers are ported from the openrazer project for Linux. The goal is to support all devices from openrazer on macOS.

An Electron macOS menu bar app is used for the front-end. The C driver is exposed as a native Node.js addon using node-addon-api, which gets called by Electron.

Adding support for new peripherals types should be relatively simple. See wiki.

Credits

Builds on work done by these projects: