Skip to content

Latest commit

 

History

History
164 lines (104 loc) · 4.62 KB

README.md

File metadata and controls

164 lines (104 loc) · 4.62 KB
Raw

keyboard demo pic

Open source color effects manager for Razer devices on macOS

  • Supporting Razer devices Keyboards, mice, mouse mats, eGPUs and blade laptops
  • Custom color picking Choose your own colors for static, reactive and starlight effects
  • Persistent color settings Color effects are saved to onboard memory
  • Works on the latest macOS Including Intel and Apple Silicon. There are no plans from Razer to further support macOS (source)

Download

Latest release

Installation instructions

Install by drag and drop to Applications. If you get a security warning when opening the app, 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.

Please see FAQ section below if color changes are not working, otherwise open a new issue.

Device support

  • ⌨️ Keyboard
  • 🖱️ Mouse
  • 📜 Mouse mat
  • 🌈 e-GPU
  • 🎧 Headphones and stand
  • 💻 Blade laptop
  • 🔊 Speakers
  • 🍺 Mug

For a complete list of supported devices, please see openrazer.

Confirmed working for:

Keyboards:

  • Razer BlackWidow 2019
  • Razer BlackWidow Elite
  • Razer BlackWidow Chroma v2
  • Razer Ornata Chroma
  • Razer Huntsman
  • Razer Huntsman Elite
  • Razer Huntsman TE
  • Razer Huntsman Mini
  • Razer Huntsman V2 Analog
  • Razer Huntsman V2
  • Razer Cynosa V2
  • Razer Ornata V2

Mice:

  • Razer DeathAdder Elite
  • Razer DeathAdder Essential
  • Razer DeathAdder Essential White Edition
  • Razer DeathAdder Essential (2021)
  • Razer DeathAdder V2
  • Razer DeathAdder V2 Pro (wired and wireless)
  • Razer Razer Lancehead Wireless
  • Razer Viper Ultimate Wireless
  • Razer Basilisk Ultimate
  • Razer Basilisk V2
  • Razer Abyssus V2 (under older mouse effects)
  • Razer Razer DeathAdder 2013 (under older mouse effects)
  • Razer Naga Trinity

Mouse mats:

  • Razer Goliathus Extended
  • Razer Firefly V2

Laptops:

  • Razer Blade Advanced 2018

Headphones:

  • Razer Kraken V2

Accessories:

  • Razer Base Station V2
  • Razer Mouse Bungee V3 Chroma

Please feel free to open pull requests for new devices you have tested.

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. See your device manual for specific instructions on how to switch profiles.

Q: Menu says "No device found".

A: Use the "Refresh Device List" option.

Q: How do I customize and rebind keys?

You might find the Karabiner-elements tool helpful.

Device Support Policy

Ongoing new device support will be provided on a volunteer contribution basis, as it is difficult for someone who does not own the physical devices to be adding support and conducting tests.

Developer usage

git clone --recursive https://github.com/1kc/razer-macos.git

Ensure xcode command line tools are installed,

If you have a paid Apple Developer account, edit release.sh with your details.

Afterwards, to automatically build, sign, and/or notarize (if applicable,) run in Terminal: ./release.sh

Ad-hoc signing will be used if account information is left empty.

Or build manually:

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

Sign the universal package before moving to /Applications folder with ad-hoc signing:

codesign -s - --deep --force ./dist/mac-universal/Razer\ macOS.app

Implementation

Project includes both hardware drivers and user interface.

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 user interface. The C driver is exposed as a native Node.js addon using node-addon-api, which gets invoked by Electron at runtime to send packets to devices.

Adding support for new peripherals types requires porting from the openrazer project. See wiki.

Credits

Builds on work done by these amazing projects: