nicmarti

Open Razor Rgb 4 Mac — Development skill for Claude Code

Development community

Native macOS menu-bar app to control Razer BlackWidow V3 Pro RGB lighting without Synapse — pure IOKit, plus Claude Code hooks that turn the keyboard into a live status light.

How to install Open Razor Rgb 4 Mac

This entry records only its repository, not the path inside it, so there is no exact command to give. Open nicmarti/open-razor-rgb-4-mac and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Open Razor Rgb 4 Mac does

Native macOS menu-bar app to control Razer BlackWidow V3 Pro RGB lighting without Synapse — pure IOKit, plus Claude Code hooks that turn the keyboard into a live status light.

Alternatives in Development

Quosparr — 🐦 Native menu bar & tray app for macOS, Windows and Linux: track Codex, Claude Code and Grok quotas, resets 288 ★
Cc Bar — Native macOS menu bar app: track quota, usage and cost for Codex (multi-account) and Claude Code, from your me 119 ★
CoderBar — Native macOS agent control for Codex and Claude — monitor, approve, ask, and jump back from the menu bar 100 ★

README

OpenRazorRGB

[![License: BSD 3-Clause](https://img.shields.io/badge/license-BSD%203--Clause-blue.svg)](./LICENSE) [![Swift](https://img.shields.io/badge/Swift-6.0-orange.svg)](https://swift.org) [![macOS](https://img.shields.io/badge/platform-macOS%2013%2B-lightgrey.svg)](https://www.apple.com/macos)

A native macOS app to control the RGB lighting of a **Razer BlackWidow V3 Pro (Wired)** keyboard — without Razer Synapse.

Built with Swift + IOKit. The lighting protocol is reimplemented from [OpenRGB](https://gitlab.com/CalcProgrammer1/OpenRGB/). No kernel extension, no libusb, no root — pure IOKit HID feature reports.

Screenshots

Menu-bar popover	Per-key editor with saved presets

Project structure

Target	Description
`RazerKit`	Reusable core library: HID access, Razer report/protocol, 109-key layout
`razer-poc`	CLI tool: enumerate, diagnose, and drive the keyboard
`OpenRazorRGBApp`	SwiftUI executable (SwiftPM, for development)
`OpenRazorRGB.xcodeproj`	Xcode app target — builds the signed `.app` bundle for daily use

The SwiftPM package (`Package.swift`) and the Xcode project (`project.yml` → `OpenRazorRGB.xcodeproj`) share the same source files in `Sources/`. Use SwiftPM for quick CLI iteration; use Xcode to build the distributable `.app`.

Requirements

macOS 13 Ventura or later
Xcode 15+ / Swift 6+ (install via the App Store or xcode-select --install)
A Razer BlackWidow V3 Pro (Wired) connected over USB

**xcodegen** is required to regenerate the `.xcodeproj` if you modify `project.yml`: `brew install xcodegen && xcodegen generate`

1. Build

git clone 
cd OpenRazorRGB

# Recommended: build + install the signed .app and restart it
make prod

# Or, for quick SwiftPM iteration (bare binary):
swift build
swift build -c release   # optimised, required for the Claud