📈 GH Trending Explorer 🎲 Surprise me

← all repos

infinityInfinite / secbird

git clone https://github.com/infinityInfinite/secbird.git v0.4.8 · today

A small, lightweight replacement for Razer Synapse on Windows. Set your Razer mouse, keyboard and other peripherals: lighting, DPI, polling rate, button remapping and profiles, without Synapse's background services, account, ads, pop-ups or restart prompts.

—
stars, 24h
+64
stars, 7 days · #765
+64
stars, 30 days · #4,146
64
★ total · +64% this week
5
forks · 15 open issues

Star history starts 2026-10-20; the chart appears after the second daily snapshot.

LanguageRust
LicenseApache-2.0
Created2026-10-13 (7d ago)
Last pushtoday
Watchers3
OwnerUser

Links

README excerpt
A small, lightweight replacement for Razer Synapse on Windows. Set your Razer mouse,
keyboard and other peripherals: lighting, DPI, polling rate, button remapping and profiles, without
Synapse's background services, account, ads, pop-ups or restart prompts.
- **Light:** a 1 MB tray app using about 12 MB of RAM, next to the hundreds of MB Synapse keeps running.
- **Quiet:** no services, no account, no telemetry. It sits in the tray and
 applies your settings when you sign in, plug a device in or wake the PC. The only time it goes
 online is a daily check for a new Secretarybird version, which you can turn off.
- **Built for many devices:** one screen for all of them, and one click to put a color or effect on every device, in step.
> **Beta.** We test on a Basilisk V3, and users have confirmed nine more devices, from Naga and
> Viper mice to BlackWidow keyboards and a Tartarus keypad (see below). Other devices are
> supported from public protocol facts and may not work yet. Tell us how yours does.
### ⬇ Download for Windows · ⬇ Download for Linux
Free · Windows 10 and 11 · on the page that opens, click `Secretarybird-Setup- .exe`.
On Linux it's the command line, in beta: see Linux.
## Install
1. Go to the **latest release** and download
 `Secretarybird-Setup- .exe`.
2. Run it. It installs for your Windows account only, so it doesn't ask for administrator rights.
3. The bird appears in the tray (click `^` next to the clock if it's hidden).
 Click it and choose **Open editor**.
**"Windows protected your PC"?** The installer isn't code-signed yet (signing costs money),
so Windows SmartScreen doesn't know it. Click **More info → Run anyway**. To check your download
matches the release, compare `Get-FileHash Secretarybird-Setup- .exe` in PowerShell
with `SHA256SUMS.txt` on the release page.
Prefer no installer? Download `Secretarybird- -portable.zip` instead, unzip it anywhere
and run `secbird-tray.exe`.
**Updating:** run the newer installer; your settings are kept.
**Uninstalling:** Windows Settings → Apps → Secretarybird. It asks whether to keep your profiles.
### Linux (command line, beta)
The `secbird` command line runs on Linux: DPI, polling rate, lighting and effects, button
remaps, macros, profiles and reports, the same as on Windows. The tray and the editor are
Windows-only for now.
1. Download and unpack the latest version. It's one static binary for any x86_64 distribution:
 [code] 
 Or download `secbird- -linux-x86_64.tar.gz` from the
 latest release and run
 `tar xf secbird-*-linux-x86_64.tar.gz`.
2. Install the binary and the udev rule, which lets you use Razer devices without root:
 [code] 
3. Unplug the device and plug it back in, then run `secbird list`.
Settings live in `~/.config/secretarybird`. `sudo ./install.sh --uninstall` removes it again.
If OpenRazer is installed, its daemon and Secretarybird can both change the same device; use
one at a time. Bug reports from Linux are very welcome, with `secbird report` output.
## Using it
| N