razer.conf(5) File Formats Manual razer.conf(5)

razer.conf - فایل پیکربندی برای دیمن OpenRazer

فایل ~/.config/openrazer/razer.conf (در صورت تنظیم بودن، $XDG_CONFIG_HOME لحاظ می‌شود) برخی از گزینه‌های زمان راه‌اندازی و زمان اجرای openrazer-daemon(8) را پیکربندی می‌کند. openrazer-daemon(8) می‌تواند با ارائه آرگومان --config از فایل‌های پیکربندی مشخص‌شده در مسیرهای غیر استاندارد استفاده کند.

این فایل پیکربندی ساختاری مشابه یک فایل .INI دارد و توسط ConfigParser پایتون تجزیه می‌شود.

یک فایل نمونه باید در مسیر /usr/share/openrazer/razer.conf.example نصب شده باشد.

اولین بخش در فایل پیکربندی، بخش [General] است. این بخش شامل گزینه‌های متفرقه می‌باشد.

verbose_logging bool

این پرچم مشخص می‌کند که آیا دیمن باید اطلاعات گزارش‌گیری (logging) با جزئیات را در خروجی ثبت کند یا خیر. این مقدار همانند ارسال -v یا --verbose در خط فرمان عمل می‌کند.

بخش [Startup] در فایل پیکربندی شامل مقادیری است که در هنگام راه‌اندازی استفاده می‌شوند؛ برای مثال مشخص می‌کند که آیا همگام‌سازی جلوه‌ها هنگام شروع فعال باشد یا خیر.

sync_effects_enabled bool

این پرچم مشخص می‌کند که آیا منطق همگام‌سازی جلوه‌ها هنگام شروع دیمن فعال باشد یا خیر، تا نیازی به فعال‌سازی دستی توسط کاربر نباشد.

devices_off_on_screensaver bool

این پرچم مشخص می‌کند که آیا قابلیت خاموش کردن دستگاه‌های ریزر هنگام فعال شدن محافظ صفحه نمایش (screensaver)، در زمان شروع دیمن فعال باشد یا خیر.

battery_notifier bool

این پرچم مشخص می‌کند که آیا اعلان‌ها باید به صورت منظم همراه با درصد باقی‌مانده باتری نمایش داده شوند یا خیر.

battery_notifier_freq int

این پرچم مشخص می‌کند که اعلان مربوط به سطح باقی‌مانده باتری هر چند وقت یک‌بار باید نمایش داده شود.

battery_notifier_percent int

این پرچم مشخص می‌کند که باتری دستگاه باید به چه درصدی برسد تا ارسال اعلان‌ها آغاز شود.

restore_persistence bool

این پرچم مشخص می‌کند که آیا جلوه‌های ذخیره‌شده در persistence.conf هنگام شروع دیمن اعمال شوند یا خیر.

persistence_dual_boot_quirk bool

این پرچم مشخص می‌کند که آیا جلوه ذخیره‌شده باید دو بار اعمال شود تا مشکل خاص (quirk) دستگاه‌های جدیدتری که آخرین بار توسط Razer Synapse در ویندوز تغییر یافته‌اند برطرف شود یا خیر. این گزینه تنها در صورت تنظیم restore_persistence = True قابل استفاده است.

بخش‌های اختصاصی اضافی به ازای هر دستگاه می‌توانند با نام "Device:XXXX" تعریف شوند که در آن XXXX شماره سریال دستگاه شما است.

driver_mode bool

این پرچم یک بازنویسی (override) را مشخص می‌کند مبنی بر اینکه آیا دستگاه باید به «حالت درایور» (driver mode) تغییر وضعیت دهد (در مقابل نگه‌داشتن آن در «حالت دستگاه» یا device mode) یا خیر. در حالت ایده‌آل، پشته نرم‌افزاری OpenRazer باید از تمام قابلیت‌ها در سطح نرم‌افزار پشتیبانی کرده و از قرارگیری دستگاه‌ها در حالت درایور پشتیبانی کند، اما این موضوع هنوز برای طیف گسترده‌ای از دستگاه‌ها، به‌ویژه ماوس‌ها، صدق نمی‌کند. با این حال، برخی از کاربران ممکن است بخواهند دستگاه را به صورت صریح به حالت درایور وادار کنند تا عملکردهایی مانند پیمایش افقی فعال شوند.

openrazer-daemon(8)

2026-04-18