Skip to content

Install

Jump to bottom
Tim May edited this page Jul 19, 2026 · 1 revision

Install

Homebrew (recommended)

brew tap shoelesstim/tap
brew install --cask razerstream

Upgrade later:

brew upgrade --cask razerstream

Zip from GitHub

  1. Open the latest release
  2. Download RazerStream-vX.Y.Z.zip
  3. Unzip and drag RazerStream.app into /Applications
  4. Double-click to open

Releases are Developer ID signed and notarized. You should not need to right-click → Open or disable Gatekeeper.

First run

  1. Plug in the Razer Stream Controller over USB.
  2. Open RazerStream. On connect you should see a short LED cascade and the panel fade in, then your page layout.
  3. When prompted, grant Accessibility (System Settings → Privacy & Security → Accessibility). Required for keystrokes and media keys. Launching apps and drawing to the device work without it.
  4. Optional: Settings → General → open at login.

Pages (add / delete)

At the top of the sidebar page list there is a native + / − control:

  • + adds a page
  • − deletes the selected page (disabled when only one page remains)
  • Right-click a page row → Delete also works
  • Double-click a page name to rename
  • Drag a tile onto a page row to move that tile to that page (only if the destination has an empty slot)

If you are on 1.4.0–1.4.7 and never see +/−, upgrade to 1.4.72 or later (issue #1).

Coexistence with Loupedeck software

If the old Loupedeck app or LaunchAgent is running, it may hold the serial port and RazerStream cannot connect. Quit Loupedeck fully first. Whether a full uninstall is required is still an open question; if you test either path, a short note on an issue helps everyone.

Logi Options+ has been reported as aggressive around this hardware; if the device never shows up with Options+ installed, try without it.

Build from source

Needs Xcode 16+ (or a working swift toolchain for macOS 14+).

git clone https://github.com/ShoelessTim/RazerStream.git
cd RazerStream
swift build -c release
./scripts/make_app.sh release install
open /Applications/RazerStream.app

CLI smoke tests:

swift run rstream monitor
swift run rstream test-pattern
swift run rstream brightness 7

Clone this wiki locally