razer.conf(5)

💖 razer.conf — the config file for the OpenRazer Daemon 💖

okay bestie, sit down, we're configuring your snake-y lil peripherals and it's gonna be so good 🐍✨

---

🌸 NAME 🌸

razer.conf — the configuration file for the OpenRazer Daemon. it's giving "settings, but make it a text file" 💅

---

✨ DESCRIPTION ✨

so here's the tea: the ~/.config/openrazer/razer.conf file is where you go to set up a bunch of the startup and runtime options for openrazer-daemon(8). and yes, $XDG_CONFIG_HOME is respected if you've set it, so if you keep your config somewhere cute and custom, the daemon will find it, no cap 🫶

and if you're extra and your config lives in a non-standard location? totally fine. openrazer-daemon(8) can use it anyway — you just hand it over with the --config argument. iconic behavior honestly.

the format? it's like a .INI file. and it gets parsed by Python's ConfigParser. that's the whole vibe check, it's literally just that 🌈

---

🎀 EXAMPLE 🎀

there should be an example file already installed for you, chillin' at:

/usr/share/openrazer/razer.conf.example

go look at it bestie, it's free real estate 👑

---

🦋 SECTIONS 🦋

💜 GENERAL

the first section in the config file is called [General], and it's the miscellaneous drawer where all the random-but-important stuff lives. ✨

• verbose_logging bool — this flag decides whether the daemon spits out detailed logging info. it does the exact same thing as if you'd passed -v or --verbose on the command line. same energy, different door 🚪

🌸 STARTUP

the [Startup] section is where the values used during startup hang out. for example, it gets to decide whether effects syncing is active the moment the daemon starts. it's the "what's my morning routine" section, fr fr ☀️

• sync_effects_enabled bool — this flag says whether the effects syncing logic is active when the daemon starts, so you don't have to sit around waiting for the user to go activate them manually. self-starter energy 💅
• devices_off_on_screensaver bool — this flag says whether the "turn off my razer devices when the screensaver kicks in" functionality is active from the moment the daemon starts. sleepy time for the RGB 😴
• battery_notifier bool — this flag says notifications should be shown regularly with whatever battery level you've got left. 🔋
• battery_notifier_freq int — this one controls how often that remaining-battery-level notification gets shown. the frequency, bestie ⏰
• battery_notifier_percent int — this sets what battery percentage your device needs to reach before it starts sending you notifications. the threshold, the limit, the line in the sand 🪫
• restore_persistence bool — this flag says whether the effects saved in persistence.conf should get applied when the daemon starts. bringing back your faves 💾
• persistence_dual_boot_quirk bool — this flag says whether the persisted effect is applied twice, to work around a quirk with newer devices that were last changed by Razer Synapse on Windows. heads up though: it's only applicable when restore_persistence = True. no persistence, no quirk-fixing, periodt 🪄

🧚 DEVICE

you can also define extra per-device sections, and you name them "Device:XXXX" — where XXXX is the serial number of your device. bespoke sections for bespoke babies 💖

• driver_mode bool — this flag is an override for whether the device should be switched into "driver mode" (as opposed to keeping it in "device mode"). ideally the OpenRazer stack would support all the functionality in software and be cool with devices living in driver mode — but nope, that's not the case for a wide variety of devices yet, especially mice 🐭. that said, some users may want to explicitly force a device into driver mode to unlock functionality like horizontal scrolling. so, like, your choice bestie, but know what you're signing up for 😭

---

🔥 SEE ALSO 🔥

• openrazer-daemon(8)

---

and that's the whole page, babe 🫶 this was razer.conf(5) from the File Formats Manual, dated 2026-04-18. go forth and make your setup gorgeous, you've got this 💜✨🎀