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
- GitHub: github.com/infinityInfinite/secbird
- Homepage: https://infinityinfinite.github.io/secbird/
- Releases · Issues · Hacker News mentions
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