iToto / razer-macos

Color effects manager for Razer peripherals on macOS Catalina and above

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

keyboard demo pic

Open source color effects manager for Razer keyboards and mice 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

Installation

If you get a security warning, you need to go to your Mac's "System Preferences" -> "Security and Privacy" -> "General" and click "Open" at the bottom to allow Razer macOS to run.

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:

Keyboards:

  • Razer BlackWidow Elite
  • Razer Ornata Chroma
  • Razer Huntsman
  • Razer Huntsman Elite
  • Razer Huntsman TE
  • Razer Blade Advanced 2018

Mice:

  • Deathadder Elite
  • Razer Lancehead Wireless

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:

About

Color effects manager for Razer peripherals on macOS Catalina and above

License:GNU General Public License v2.0


Languages

Language:C 87.6%Language:JavaScript 6.9%Language:C++ 4.6%Language:Python 0.5%Language:CSS 0.3%Language:HTML 0.1%