---
name: "razer.conf"
section: "5"
platform: "linux"
package: "openrazer-daemon"
version: "3.12.4-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/razer.conf"
---

# razer.conf(5)

configuration file for the OpenRazer Daemon

## NAME

razer.conf - configuration file for the OpenRazer Daemon

## DESCRIPTION

The *~/.config/openrazer/razer.conf* (**$XDG\_CONFIG\_HOME** is respected, if set) file configures some startup and runtime options of the [**openrazer-daemon**(8)](/openrazer-daemon/8.md). [**openrazer-daemon**(8)](/openrazer-daemon/8.md) is able to use configuration files specified in non-standard locations by providing the *--config* argument.

The configuration file is formatted like a .INI file and is parsed by Python's ConfigParser.

## EXAMPLE

An example file should be installed under */usr/share/openrazer/razer.conf.example*.

## SECTIONS

### GENERAL

The first section in the configuration file is a **\[General\]** section. This section contains miscellaneous options.

**verbose\_logging** *bool*

This flag specifies if the daemon is to output detailed logging information. This value acts the same as if **-v** or **--verbose** was passed at the command line.

### STARTUP

The **\[Startup\]** section in the configuration file contains values to be used during startup, for example it can decide if syncing effects will be active when started.

**sync\_effects\_enabled** *bool*

This flag specifies if the effects syncing logic is active when the daemon is started, not having to wait for the user to activate them.

**devices\_off\_on\_screensaver** *bool*

This flag specifies if the functionality to turn off razer devices when the screensaver is activated is active when the daemon starts.

**battery\_notifier** *bool*

This flag specifies that notifications should be shown regularly with the remaining battery level.

**battery\_notifier\_freq** *int*

This flag specifies how often the notification with the remaining battery level should be shown.

**battery\_notifier\_percent** *int*

This flag specifies what battery percentage the device should reach before sending notifications.

**restore\_persistence** *bool*

This flag specifies whether effects saved in persistence.conf should be applied when the daemon starts.

**persistence\_dual\_boot\_quirk** *bool*

This flag specifies whether the persisted effect is applied twice to address a quirk with newer devices that were last changed by Razer Synapse on Windows. Only applicable with restore\_persistence = True.

### DEVICE

Additional per-device sections can be defined with the name "Device:XXXX" where XXXX is the serial number of your device.

**driver\_mode** *bool*

This flag specifies an override whether the device should be switched into "driver mode" (as opposed to keeping it in "device mode"). Ideally the OpenRazer stack should support all functionality in software and support the devices being in driver mode, but that's not the case for a wide variety of devices yet, especially mice. However some users may want to explicitly force a device into driver mode to enable some functionality like horizontal scrolling.

## SEE ALSO

[**openrazer-daemon**(8)](/openrazer-daemon/8.md)