.\" Generated by scdoc 1.11.3
.\" Complete documentation for this program is not available as a GNU info page
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.nh
.ad l
.\" Begin generated content:
.TH "openrazer-daemon" "8" "2024-07-02"
.PP
.SH NAME
.PP
openrazer-daemon - Daemon to manage Razer devices in userspace
.PP
.SH SYNOPSIS
.PP
\fBopenrazer-daemon\fR [options.\&.\&.\&]
.PP
.SH DESCRIPTION
.PP
\fBopenrazer-daemon\fR is a userspace service which is designed to be an intermediary between userspace programs and the Razer drivers.\& It will provide some higher level functions to allow similar operation to the Windows Razer Synapse program.\& This service is designed to be started by xdg-autostart as a session service.\&
.PP
The service has the functionality to sync effects between multiple devices, perform on-the-fly macro recording and playback and reimplements the FN+Keys logic so they work when \fBmacro_keys\fR are enabled.\& The service can also perform various ripple effects and turn off the devices when the screensaver is active.\&
.PP
Note, that all paths shown as defaults, eg ~/.\&local/share/ or ~/.\&config/ can be changed with XDG Base Directory specification variables: \fB$XDG_CONFIG_HOME\fR, \fB$XDG_DATA_HOME\fR and \fB$XDG_RUNTIME_DIR\fR.\&
.PP
.SH OPTIONS
.PP
\fB-v\fR, \fB--verbose\fR
.RS 4
Enable logging of DEBUG messages.\&
.PP
.RE
\fB-F\fR, \fB--foreground\fR
.RS 4
Run the daemon in the foreground and don'\&t fork.\& This also enables sending the log output to stdout (in addition to the log file).\&
.PP
.RE
\fB-r\fR, \fB--respawn\fR
.RS 4
Stop any running daemon first (if one is running) before starting.\&
.PP
.RE
\fB-s\fR, \fB--stop\fR
.RS 4
Gracefully stop the running daemon.\&
.PP
.RE
\fB--as-root\fR
.RS 4
Allow the daemon to be started as root.\&
.PP
.RE
\fB--config\fR=\fIconfig_file\fR
.RS 4
Specifies the location of the config file.\& If this is not provided it will default to ~/.\&config/openrazer/razer.\&conf and create it if needed from the example config.\&
.PP
.RE
\fB--persistence\fR=\fIpersistence_file\fR
.RS 4
Specifies the location of the persistence file.\& This will be created if non-existent.\& This file will store device states so they persist between reboots.\&
.PP
.RE
\fB--run-dir\fR=\fIrun_directory\fR
.RS 4
Tells the daemon what directory is its run directory, the directory it will change to once started.\& It will default to \fB$XDG_RUNTIME_DIR\fR, if not set it falls back to ~/.\&local/share/openrazer/.\&
.PP
.RE
\fB--log-dir\fR=\fIlog_directory\fR
.RS 4
This argument decides where the log directory will be, the daemon itself will handle log rotation as it'\&s a user session service.\& The daemon will default to ~/.\&local/share/openrazer/logs/ for its log directory.\&
.PP
.RE
\fB--test-dir\fR=\fItest_dir\fR
.RS 4
If provided the daemon will operate in test-driver mode in which it exposes devices that aren'\&t physically connected.\& Use \fIscripts/create_fake_device.\&py\fR or \fIscripts/setup_fake_devices.\&sh\fR from the source repository to create the directory structure.\&
.PP
.RE
.SH DOCUMENTATION
.PP
The full and most up-to-date documentation can be found on our GitHub repository at https://github.\&com/openrazer/openrazer.\&
.PP
.SH SEE ALSO
.PP
\fBrazer.\&conf\fR(5)