i3status-rs(1) — Parch Linux Manual Pages

amd_gpu

نمایش وضعیت و آمارهای کارت گرافیک AMD شما

پیکربندی (Configuration)

کلید	مقادیر	پیش‌فرض
device	دستگاه در /sys/class/drm/ برای خواندن اطلاعات.	هر کارت گرافیک AMD
format	رشته‌ای برای سفارشی‌سازی خروجی این بلوک. برای متغیرهای جایگزین موجود به بخش زیر مراجعه کنید.	" $icon $utilization "
format_alt	در صورت تعیین، بلوک با هر کلیک بین format و format_alt جابه‌جا خواهد شد	None
interval	بازهٔ زمانی به‌روزرسانی بر حسب ثانیه	5

جانگهدار	مقدار	نوع	واحد
icon	یک آیکون ایستا	آیکون	-
utilization	میزان استفاده از GPU	عدد	%
vram_total	کل حافظهٔ VRAM	عدد	بایت
vram_used	حافظهٔ VRAM مصرفی	عدد	بایت
vram_used_percents	حافظهٔ VRAM مصرفی / کل VRAM	عدد	%

عملیات	توضیحات	کلید پیش‌فرض
toggle_format	جابه‌جایی میان format و format_alt	کلید چپ
مثال
[[block]]
block = "amd_gpu"
format = " $icon $utilization "
format_alt = " $icon MEM: $vram_used_percents ($vram_used/$vram_total) "
interval = 1
آیکون‌های استفاده‌شده
• 2
gpu
backlight
روشنایی یک دستگاه نور پس‌زمینه (backlight)
این بلوک اطلاعات روشنایی را مستقیماً از فایل‌سیستم می‌خواند، بنابراین هم در X11 و هم در Wayland کار می‌کند.
این بلوک از inotify برای گوش دادن مستقیم به تغییرات روشنایی دستگاه استفاده می‌کند، بنابراین نیازی به تنظیم بازهٔ به‌روزرسانی (interval) نیست.
این بلوک از DBus برای تنظیم سطح روشنایی با استفاده از چرخ ماوس استفاده می‌کند، اما در صورتی که از systemd-logind استفاده نشود، به sysfs بازمی‌گردد.
مقیاس‌بندی ریشه‌ای (Root scaling)
برخی دستگاه‌ها مقادیر خامی را ارائه می‌دهند که مدیریت آن‌ها با مقیاس‌بندی غیرخطی به بهترین نحو انجام می‌شود.
درک انسان از روشنایی به ریشهٔ سوم درخشندگی نسبی نزدیک است، بنابراین مقادیر بین 2.4 و 3.0 برای root_scaling ارزش امتحان کردن دارند.
برای دستگاه‌هایی با پله‌های گسستهٔ اندک، این مقدار باید 1.0 (خطی) باشد.
اطلاعات بیشتر:
https://en.wikipedia.org/wiki/Lightness

پیکربندی (Configuration)
tab(	);
lw(14.0n) lw(28.0n) lw(28.0n).
کلید	مقادیر	پیش‌فرض
device	یک عبارت باقاعده (regex) برای تطبیق با دستگاه‌های /sys/class/backlight جهت خواندن اطلاعات روشنایی (می‌تواند با ۱ یا چند دستگاه مطابقت داشته باشد). وقتی هیچ device مشخص نشده باشد، این بلوک اطلاعات تمام دستگاه‌های یافت‌شده در دایرکتوری /sys/class/backlight را نمایش می‌دهد.	دستگاه پیش‌فرض
format	رشته‌ای برای سفارشی‌سازی خروجی این بلوک. جای‌نماهای دردسترس را در ادامه ببینید.	" $icon $brightness "
missing_format	رشته‌ای برای سفارشی‌سازی خروجی این بلوک. هیچ جای‌نمایی موجود نیست	" no backlight devices "
step_width	گام افزایش روشنایی هنگام پیمایش، بر حسب درصد	5
minimum	حداقل روشنایی که می‌توان با پیمایش به سمت پایین به آن رسید	5
maximum	حداکثر روشنایی که می‌توان با پیمایش به سمت بالا به آن رسید	100
cycle	سطوح روشنایی برای گردش متناوب با هر کلیک	[minimum, maximum]
root_scaling	معکوس توان مقیاس‌بندی (یعنی ریشه)	1.0
invert_icons	معکوس کردن ترتیب آیکون‌ها، در صورتی که ایموجی‌های رنگی دارید مفید است	false
ddcci_sleep_multiplier	https://www.ddcutil.com/performance_options/#option-sleep-multiplier مستندات ddcutil را ببینید	1.0
ddcci_max_tries_write_read	حداکثر دفعات تلاش برای نوشتن در یا خواندن از یک مانیتور ddcci	10

جای‌نما	مقدار	نوع	واحد
icon	آیکون بر اساس وضعیت نور پس‌زمینه	Icon	-
brightness	روشنایی کنونی	Number	%

کنش	دکمهٔ پیش‌فرض
cycle	Left
brightness_up	Wheel Up
brightness_down	Wheel Down
[[block]]
block = "backlight"
device = "intel_backlight"
مخفی کردن نور پس‌زمینهٔ ناموجود:
[[block]]
block = "backlight"
missing_format = ""
calibright
کالیبراسیون اضافی روشنایی نمایشگر را می‌توان در
$XDG_CONFIG_HOME/calibright/config.toml تنظیم کرد. برای جزئیات بیشتر به
https://github.com/bim9262/calibright

مراجعه کنید.
این بلوک بر هر پیکربندی سراسری تنظیم‌شده در
$XDG_CONFIG_HOME/calibright/config.toml اولویت دارد و آن را بازنویسی می‌کند.
حالت جایگزین D-Bus (D-Bus Fallback)
اگر از systemd-logind استفاده نمی‌کنید، i3status-rust تلاش
خواهد کرد روشنایی را با استفاده از sysfs تنظیم کند.
برای انجام این کار، باید دسترسی نوشتن داشته باشید.
می‌توانید این کار را با نوشتن یک قاعدهٔ udev برای سیستم خود انجام دهید.
ابتدا با استفاده از دستور groups بررسی کنید که کاربر شما عضو گروه
“video” باشد.
سپس قاعده‌ای در دایرکتوری /etc/udev/rules.d/ حاوی موارد
زیر اضافه کنید، برای مثال در فایل backlight.rules:
ACTION=="add", SUBSYSTEM=="backlight", GROUP="video", MODE="0664"
این کار به گروه video اجازه می‌دهد تمام دستگاه‌های نور پس‌زمینه را تغییر دهند.
همچنین برای اعمال این قاعده باید سیستم را مجدداً راه‌اندازی کنید.
آیکون‌های استفاده‌شده (Icons Used)
• 2
backlight (به‌صورت پیش‌رونده)
battery
اطلاعات دربارهٔ منبع تغذیهٔ داخلی
این بلوک می‌تواند وضعیت فعلی باتری (Full، Charging یا
Discharging)، درصد شارژ و زمان تخمینی تا شارژ/تخلیه شدن
را برای یک منبع تغذیهٔ داخلی نمایش دهد.
پیکربندی (Configuration)
tab(	);
lw(14.0n) lw(28.0n) lw(28.0n).
کلید	مقادیر
پیش‌فرض
T}
device	sysfs/UPower: دستگاهی در /sys/class/power_supply/ برای خواندن اطلاعات (همچنین برای UPower می‌تواند “DisplayDevice” باشد که یک منبع تغذیهٔ منطقی واحد به نمایندگی از همهٔ منابع تغذیهٔ فیزیکی است. این مورد برای مثال زمانی مفید است که سیستم شما چندین باتری داشته باشد، که در این حالت DisplayDevice طوری رفتار می‌کند که گویی یک باتری واحدِ بزرگ‌تر دارید). apc_ups: به‌صورت IPv4Address:port یا hostname:port
sysfs: اولین دستگاه باتریِ یافت‌شده در /sys/class/power_supply، که
ورودی‌های “BATx” یا “CMBx” در آن اولویت دارند.
apc_ups: مقدار “localhost:3551”.
upower: DisplayDevice
T}
driver	یکی از مقادیر "sysfs"، "apc_ups" یا "upower"
"sysfs"
T}
model	در صورت وجود، محتوای /sys/class/power_supply/.../model_name باید با این مقدار مطابقت داشته باشد. کاربرد معمول آن انتخاب بر اساس نام مدل در دستگاه‌هایی است که مسیر آن‌ها تغییر می‌کند.
ندارد
T}
interval	بازهٔ به‌روزرسانی به ثانیه. تنها برای driver = “sysfs” یا “apc_ups” کاربرد دارد.
10
T}
format	رشته‌ای برای سفارشی‌سازی خروجی این بلوک. برای نگه‌دارنده‌های مکانِ در دسترس، به ادامه مراجعه کنید.
" $icon $percentage "
T}
full_format	مشابه format اما برای زمانی که باتری پر است
" $icon "
T}
charging_format	مشابه format اما برای زمانی که باتری در حال شارژ است
ارجاع به format
T}
empty_format	مشابه format اما برای زمانی که باتری خالی است
" $icon "
T}
not_charging_format	مشابه format اما برای زمانی که باتری در حال شارژ نیست. به‌طور پیش‌فرض از آیکون باتری پر استفاده می‌کند، زیرا بسیاری از باتری‌ها هنگامی که پر هستند این وضعیت را گزارش می‌دهند.
" $icon "
T}
missing_format	مشابه format در صورتی که باتری پیدا نشود.
" $icon "
T}
info	حداقل سطح باتری، جایی که وضعیت روی info تنظیم می‌شود
60
T}
good	حداقل سطح باتری، جایی که وضعیت روی good تنظیم می‌شود
60
T}
warning	حداقل سطح باتری، جایی که وضعیت روی warning تنظیم می‌شود
30
T}
critical	حداقل سطح باتری، جایی که وضعیت روی critical تنظیم می‌شود
15
T}
full_threshold	درصدی که بالاتر از آن باتری پر در نظر گرفته می‌شود (نمایش full_format)
95
T}
empty_threshold	درصدی که پایین‌تر از آن باتری خالی در نظر گرفته می‌شود
7.5
T}
tab(	);
lw(8.3n) lw(46.5n) lw(12.1n) lw(3.2n).
جای‌نگهدار	مقدار
نوع
T}	واحد
icon	آیکون بر اساس وضعیت باتری
آیکون
T}	-
percentage	سطح باتری، به درصد
عدد
T}	درصد
time_remaining	زمان باقی‌مانده تا تکمیل (تخلیه) شارژ. تنها در صورتی ارائه می‌شود که وضعیت باتری در حال (تخلیه) شارژ باشد.
مدت‌زمان
T}	-
time	زمان باقی‌مانده تا تکمیل (تخلیه) شارژ. تنها در صورتی ارائه می‌شود که وضعیت باتری در حال (تخلیه) شارژ باشد.
رشته منسوخ‌شده
T}	-
power	توان مصرفی باتری یا از منبع تغذیه هنگام شارژ شدن
رشته یا عدد اعشاری
T}	وات

استفاده از time منسوخ شده و time_remaining جایگزین آن شده است.

مثال‌ها (EXAMPLES)

کاربرد پایه:

[[block]]
block = "battery"
format = " $icon $percentage "

[[block]]
block = "battery"
format = " $percentage {$time_remaining.dur(hms:true, min_unit:m) |}"
device = "DisplayDevice"
driver = "upower"

پنهان کردن باتری ناموجود:

[[block]]
block = "battery"
missing_format = ""

•

bat (به‌صورت مرحله‌ای)

•

bat_charging (به‌صورت مرحله‌ای)

•

bat_not_available

bluetooth

پایش دستگاه بلوتوث

این بلوک وضعیت اتصال یک دستگاه بلوتوث مشخص و در صورت پشتیبانی، سطح باتری آن را نمایش می‌دهد. به D-Bus API مربوط به Bluez وابسته است.

هنگامی که دستگاه بتواند به‌عنوان یک هدست صوتی، صفحه‌کلید، جوی‌استیک یا ماوس شناسایی شود، از شمایل مربوطه استفاده می‌کند. در غیر این صورت، به نماد عمومی بلوتوث بازمی‌گردد.

کلیک‌راست روی بلوک برای اتصال (یا قطع اتصال) دستگاه تلاش خواهد کرد.

نکته: اطلاعات سطح باتری برای برخی از دستگاه‌ها گزارش نمی‌شود. فعال‌سازی قابلیت‌های آزمایشی bluez ممکن است آن را برطرف کند.

پیکربندی (Configuration)

کلید	مقادیر	پیش‌فرض
mac	نشانی MAC دستگاه بلوتوث	اجباری
adapter_mac	نشانی MAC آداپتور بلوتوث (در صورتی که دستگاه شما به چندین آداپتور دردسترس متصل شده باشد)	None
format	رشته‌ای برای سفارشی‌سازی خروجی این بلوک. برای جایگزین‌های دردسترس به ادامه مراجعه کنید.	" $icon $name{ $percentage\|} "
disconnected_format	رشته‌ای برای سفارشی‌سازی خروجی این بلوک. برای جایگزین‌های دردسترس به ادامه مراجعه کنید.	" $icon{ $name\|} "
battery_state	نگاشتی از درصد باتری به وضعیت (رنگ) بلوک. مثال زیر را ببینید.	0..15 -> critical, 16..30 -> warning, 31..60 -> info, 61..100 -> good

متغیر جایگزین	مقدار	نوع	واحد
icon	شمایل بر پایه نوع دستگاه متصل‌شده	شمایل	-
name	نام دستگاه	متن	-
percentage	سطح باتری دستگاه (در صورت پشتیبانی‌نشدن دستگاه ممکن است وجود نداشته باشد)	عدد	%
battery_icon	شمایل باتری (در صورت پشتیبانی‌نشدن دستگاه ممکن است وجود نداشته باشد)	شمایل	-
available	در صورت دردسترس بودن دستگاه وجود دارد	پرچم	-

عملیات	دکمه پیش‌فرض
toggle	راست
این مثال تنها زمانی که دستگاه متصل است آیکون را نشان می‌دهد.
[[block]]
block = "bluetooth"
mac = "00:18:09:92:1B:BA"
disconnected_format = ""
format = " $icon "
[block.battery_state]
"0..20" = "critical"
"21..70" = "warning"
"71..100" = "good"
"آیکون‌های استفاده‌شده (Icons Used)"
• 2
headphones برای دستگاه‌های بلوتوثی که به‌عنوان
“audio-card”، “audio-headset” یا
“audio-headphones” شناسایی می‌شوند
• 2
joystick برای دستگاه‌های بلوتوثی که به‌عنوان
“input-gaming” شناسایی می‌شوند
• 2
keyboard برای دستگاه‌های بلوتوثی که به‌عنوان
“input-keyboard” شناسایی می‌شوند
• 2
mouse برای دستگاه‌های بلوتوثی که به‌عنوان
“input-mouse” شناسایی می‌شوند
• 2
bluetooth برای تمامی دستگاه‌های دیگر
calendar
تقویم (Calendar)
این بلوک رویدادهای پیش‌روی تقویم را که از یک سرور CalDav
ICalendar بازیابی شده‌اند، نمایش می‌دهد.
"پیکربندی (Configuration)"
tab(	);
lw(14.0n) lw(28.0n) lw(28.0n).
کلید	مقادیر
پیش‌فرض
T}
next_event_format	رشته‌ای برای سفارشی‌سازی خروجی این بلوک هنگامی که رویداد بعدی در تقویم وجود دارد. برای جای‌نگه‌دارهای موجود به زیر مراجعه کنید.
" $icon $start.datetime(f:`%a %H:%M') $summary "
T}
ongoing_event_format	رشته‌ای برای سفارشی‌سازی خروجی این بلوک در حین برگزاری یک رویداد.
" $icon $summary (ends at $end.datetime(f:`%H:%M')) "
T}
no_events_format	رشته‌ای برای سفارشی‌سازی خروجی این بلوک هنگامی که هیچ رویدادی وجود ندارد
" $icon "
T}
redirect_format	رشته‌ای برای سفارشی‌سازی خروجی این بلوک هنگامی که اعطای مجوز درخواست می‌شود
" $icon Check your web browser "
T}
fetch_interval	بازهٔ زمانی واکشی رویدادها به ثانیه
60
T}
alternate_events_interval	بازهٔ زمانی تناوب رویدادهای هم‌پوشان به ثانیه
10
T}
events_within_hours	تعداد ساعت‌ها برای بررسی و یافتن رویدادها در آینده
48
T}
source	آرایه‌ای از منابع برای دریافت تقویم‌ها از آن‌ها
[]
T}
warning_threshold	آستانهٔ هشدار به ثانیه برای رویداد پیش‌رو
300
T}
browser_cmd	دستور برای باز کردن جزئیات رویداد در مرورگر. این بلوک پیوند HTML را به‌عنوان یک آرگومان ارسال می‌کند
"xdg-open"
T}
tab(	);
lw(14.0n) lw(28.0n) lw(28.0n).
کلید	مقادیر
پیش‌فرض
T}
url	نشانی URL سرور تقویم CalDav
ندارد
T}
auth	پیکربندی احراز هویت (unauthenticated، basic یا oauth2)
unauthenticated
T}
calendars	فهرست نام‌های تقویم جهت پایش. در صورت خالی بودن، همهٔ تقویم‌ها واکشی خواهند شد.
[]
T}

نکته: در حال حاضر تنها از یک منبع پشتیبانی می‌شود

کنش	توضیحات	دکمهٔ پیش‌فرض
open_link	پیوند HTML مربوط به رویداد را باز می‌کند	چپ

بدون احراز هویت (Unauthenticated)

[[block]]
block = "calendar"
next_event_format = " $icon $start.datetime(f:'%a %H:%M') $summary "
ongoing_event_format = " $icon $summary (ends at $end.datetime(f:'%H:%M')) "
no_events_format = " $icon no events "
fetch_interval = 30
alternate_events_interval = 10
events_within_hours = 48
warning_threshold = 600
browser_cmd = "firefox"
[[block.source]]
url = "https://caldav.example.com/calendar/"
calendars = ["user/calendar"]
[block.source.auth]
type = "unauthenticated"

احراز هویت پایه (Basic Authentication)

[[block]]
block = "calendar"
next_event_format = " $icon $start.datetime(f:'%a %H:%M') $summary "
ongoing_event_format = " $icon $summary (ends at $end.datetime(f:'%H:%M')) "
no_events_format = " $icon no events "
fetch_interval = 30
alternate_events_interval = 10
events_within_hours = 48
warning_threshold = 600
browser_cmd = "firefox"
[[block.source]]
url = "https://caldav.example.com/calendar/"
calendars = [ "Holidays" ]
[block.source.auth]
type = "basic"
username = "your_username"
password = "your_password"

نکته: شما همچنین می‌توانید username و password را در یک فایل TOML جداگانه پیکربندی کنید.

~/.config/i3status-rust/example_credentials.toml

username = "my-username"
password = "my-password"

پیکربندی احراز هویت منبع با credentials_path:

[block.source.auth]
type = "basic"
credentials_path = "~/.config/i3status-rust/example_credentials.toml"
برای دسترسی به CalDav API گوگل، مراحل زیر را جهت فعال‌سازی API
و دریافت client_id و client_secret دنبال کنید: 1.
به Google Cloud Console بروید: به 

Google Cloud Console
 مراجعه کنید.
2.
ایجاد یک پروژه جدید: اگر از قبل پروژه‌ای ندارید،
روی منوی کشویی پروژه‌ها کلیک کرده و “New Project” را انتخاب کنید.
نامی برای پروژه خود مشخص کرده و روی “Create” کلیک کنید.
3.
فعال‌سازی CalDAV API: در پیشخوان پروژه، به مسیر
“APIs & Services” > “Library” بروید.
عبارت “CalDAV API” را جستجو کرده و روی آن کلیک کنید، سپس
“Enable” را بزنید.
4.
راه‌اندازی OAuth consent screen: به مسیر “APIs & Services” >
“OAuth consent screen” بروید.
اطلاعات مورد نیاز را پر کرده و ذخیره کنید.
5.
ایجاد اعتبارنامه‌ها (Credentials): - به مسیر “APIs & Services” >
“Credentials” بروید.
- روی “Create Credentials” کلیک کرده و “OAuth 2.0 Client
IDs” را انتخاب کنید.
- در صورتی که از قبل صفحه رضایت را پیکربندی نکرده‌اید، آن را تنظیم کنید.
- نوع برنامه را روی “Web application” تنظیم کنید.
- آدرس‌های redirect URI مجاز خود را اضافه کنید.
به عنوان مثال، http://localhost:8080.
- روی “Create” کلیک کرده و مقادیر client_id و
client_secret را یادداشت نمایید.
6.
بارگیری اعتبارنامه‌ها: روی نماد بارگیری در کنار
OAuth 2.0 Client ID خود کلیک کنید تا فایل JSON حاوی
client ID و client secret شما دانلود شود.
از این مقادیر در پیکربندی خود استفاده نمایید.

[[block]]
block = "calendar"
next_event_format = " $icon $start.datetime(f:'%a %H:%M') $summary "
ongoing_event_format = " $icon $summary (ends at $end.datetime(f:'%H:%M')) "
no_events_format = " $icon no events "
fetch_interval = 30
alternate_events_interval = 10
events_within_hours = 48
warning_threshold = 600
browser_cmd = "firefox"
[[block.source]]
url = "https://apidata.googleusercontent.com/caldav/v2/"
calendars = ["primary"]
[block.source.auth]
type = "oauth2"
client_id = "your_client_id"
client_secret = "your_client_secret"
auth_url = "https://accounts.google.com/o/oauth2/auth"
token_url = "https://oauth2.googleapis.com/token"
auth_token = "~/.config/i3status-rust/calendar.auth_token"
redirect_port = 8080
scopes = ["https://www.googleapis.com/auth/calendar", "https://www.googleapis.com/auth/calendar.events"]

نکته: شما همچنین می‌توانید client_id و client_secret را در یک فایل TOML جداگانه پیکربندی کنید.

~/.config/i3status-rust/google_credentials.toml

client_id = "my-client_id"
client_secret = "my-client_secret"

پیکربندی احراز هویت منبع با استفاده از credentials_path:

[block.source.auth]
type = "oauth2"
credentials_path = "~/.config/i3status-rust/google_credentials.toml"
auth_url = "https://accounts.google.com/o/oauth2/auth"
token_url = "https://oauth2.googleapis.com/token"
auth_token = "~/.config/i3status-rust/calendar.auth_token"
redirect_port = 8080
scopes = ["https://www.googleapis.com/auth/calendar", "https://www.googleapis.com/auth/calendar.events"]
پیکربندی قالب رشته‌ای است که می‌تواند شامل جای‌نگه‌دارهایی باشد که با
محتوای پویا جایگزین می‌شوند.
جای‌نگه‌دارها می‌توانند این موارد باشند: - $summary: خلاصه رویداد -
$description: شرح رویداد - $url:
نشانی وب (URL) رویداد - $location: مکان رویداد -
$start: زمان شروع رویداد - $end: زمان پایان
رویداد

نمادهای استفاده‌شده (Icons Used)

•: calendar

پیکربندی (Configuration)

کلید	مقادیر	پیش‌فرض
format	رشته‌ای برای سفارشی‌سازی خروجی این بلوک. برای مشاهده جای‌نگه‌دارهای موجود به جدول زیر مراجعه کنید.	" $icon $utilization "
format_alt	در صورت تنظیم، بلوک با هر کلیک بین format و format_alt جابه‌جا می‌شود	None
interval	بازه به‌روزرسانی بر حسب ثانیه	5
info_cpu	درصد استفاده از پردازنده که در آن وضعیت روی info تنظیم می‌شود	30.0
warning_cpu	درصد استفاده از پردازنده که در آن وضعیت روی warning تنظیم می‌شود	60.0
critical_cpu	درصد استفاده از پردازنده که در آن وضعیت روی critical تنظیم می‌شود	90.0

جای‌نگه‌دار	مقدار	نوع	واحد
icon	یک نماد (آیکون)	Icon	-
utilization	میانگین بهره‌وری پردازنده	Number	%
utilization<N>	بهره‌وری N-اُمین پردازنده منطقی	Number	%
barchart	بهره‌وری تمام پردازنده‌های منطقی که به‌صورت نمودار میله‌ای نمایش داده می‌شود	Text	-
frequency	میانگین فرکانس پردازنده (در صورت پشتیبانی نشدن پردازنده ممکن است وجود نداشته باشد)	Number	Hz
frequency<N>	فرکانس N-اُمین پردازنده منطقی (در صورت پشتیبانی نشدن پردازنده ممکن است وجود نداشته باشد)	Number	Hz
max_frequency	بیشینه فرکانس تمام پردازنده‌های منطقی	Number	Hz
boost	وضعیت شتاب توربو (turbo boost) پردازنده (در صورت پشتیبانی نشدن پردازنده ممکن است وجود نداشته باشد)	Text	-

کنش	توضیحات	دکمه پیش‌فرض
toggle_format	جابه‌جایی بین format و format_alt	چپ (Left)
[[block]]
block = "cpu"
interval = 1
format = " $icon $barchart $utilization "
format_alt = " $icon $frequency{ $boost\|} "
info_cpu = 20
warning_cpu = 50
critical_cpu = 90
آیکون‌های استفاده‌شده (Icons Used)
• 2
cpu (به صورت مرحله‌ای)
• 2
cpu_boost_on
• 2
cpu_boost_off
custom
خروجی یک دستور شل سفارشی
برای سفارشی‌سازی بیشتر، از گزینهٔ json استفاده کنید تا دستور شل یک خروجی JSON معتبر بر اساس طرح‌وارهٔ (schema) زیر تولید کند:
{"icon": "...", "state": "...", "text": "...", "short_text": "..."}
icon اختیاری است (پیش‌فرض “”). state اختیاری است و می‌تواند Idle، Info، Good، Warning یا Critical باشد (پیش‌فرض Idle). short_text اختیاری است.
پیکربندی (Configuration)
tab(	);
lw(14.0n) lw(28.0n) lw(28.0n).
کلید	مقادیر	پیش‌فرض
format	رشته‌ای برای سفارشی‌سازی خروجی این بلوک. جایگزین‌های موجود را در ادامه ببینید.	"{ $icon\|} $text.pango-str() "
command	دستور شل برای اجرا و نمایش	None
persistent	اجرای دستور در پس‌زمینه؛ به‌روزرسانی نمایشگر با هر خط خروجی دستور	false
cycle	دستورهایی که هنگام کلیک روی دکمه اجرا شده و جابه‌جا می‌شوند	None
interval	بازهٔ زمانی به‌روزرسانی به ثانیه (یا “once” برای به‌روزرسانی تنها یک‌بار)	10
json	استفاده از JSON خروجی دستور برای قالب‌بندی بلوک. اگر JSON معتبر نباشد، بلوک با خطا مواجه خواهد شد.	false
watch_files	پایش فایل‌ها برای به‌روزرسانی هنگام تغییر فایل. از گسترش مسیر مانند ~ پشتیبانی می‌کند.	None
hide_when_empty	هنگامی که خروجی دستور (یا فیلد متنی json) خالی باشد، بلوک را پنهان می‌کند	false
shell	مشخص‌کردن شل مورد استفاده برای اجرای دستورها	$SHELL در صورت تنظیم، در غیر این صورت sh

جایگزین	مقدار	نوع	واحد
icon	مقدار فیلد icon از خروجی JSON در صورت غیرخالی بودن	آیکون	-
text	خروجی اسکریپت یا فیلد text از خروجی JSON	متن
short_text	فیلد short_text از خروجی JSON	متن

عملیات	دکمهٔ پیش‌فرض
cycle	چپ
نمایش دما، به‌روزرسانی هر ۱۰ ثانیه:
[[block]]
block = "custom"
command = ''' cat /sys/class/thermal/thermal_zone0/temp \| awk '{printf("%.1f\n",$1/1000)}' '''
چرخش بین “ON” و “OFF”، به‌روزرسانی هر ۱ ثانیه، اجرای
دستور چرخه بعدی هنگام کلیک روی بلوک:
[[block]]
block = "custom"
cycle = ["echo ON", "echo OFF"]
interval = 1
[[block.click]]
button = "left"
action = "cycle"
استفاده از خروجی JSON:
[[block]]
block = "custom"
command = "echo '{\"icon\":\"weather_thunder\",\"state\":\"Critical\", \"text\": \"Danger!\"}'"
json = true
نمایش کرنل، به‌روزرسانی بلوک تنها یک‌بار:
[[block]]
block = "custom"
command = "uname -r"
interval = "once"
نمایش روشنایی صفحه در یک دستگاه intel و به‌روزرسانی آن تنها
هنگامی که pkill -SIGRTMIN+4 i3status-rs فراخوانی شود:
[[block]]
block = "custom"
command = ''' cat /sys/class/backlight/intel_backlight/brightness \| awk '{print $1}' '''
signal = 4
interval = "once"
به‌روزرسانی بلوک هنگامی که یک یا چند فایل مشخص‌شده تغییر کنند:
[[block]]
block = "custom"
command = "cat custom_status"
watch_files = ["custom_status"]
interval = "once"
"کارهای باقی‌مانده (TODO):"
• 2
استفاده از shellexpand
custom_dbus
بلوکی کنترل‌شده توسط DBus
این بلوک یک شیء جدید DBus در سرویس rs.i3status ایجاد می‌کند.
این شیء رابط rs.i3status.custom را پیاده‌سازی می‌کند که
به شما امکان می‌دهد آیکون، متن و وضعیت بلوک را تنظیم کنید.
خروجی
busctl --user introspect rs.i3status /<path>; rs.i3status.custom:
NAME TYPE SIGNATURE RESULT/VALUE FLAGS
rs.i3status.custom interface - - -
.SetIcon method s s -
.SetState method s s -
.SetText method ss s -
tab(	);
lw(14.0n) lw(28.0n) lw(28.0n).
کلید	مقادیر
پیش‌فرض
T}
format	رشته‌ای برای سفارشی‌سازی خروجی این بلوک.
"{ $icon\|}{ $text.pango-str()\|} "
T}

جای‌نگهدار	مقدار	نوع	واحد
icon	مقدار آیکون تنظیم‌شده از طریق SetIcon در صورتی که مقدار، یک رشته‌ی غیرخالی باشد.	Icon	-
text	مقدار نخستین رشته از SetText	Text	-
short_text	مقدار دومین رشته از SetText	Text	-

مثال

پیکربندی:

[[block]]
block = "custom_dbus"
path = "/my_path"

کاربرد:

### تنظیم متن کامل روی 'hello' و متن کوتاه روی 'hi'
busctl --user call rs.i3status /my_path rs.i3status.custom SetText ss hello hi
### تنظیم آیکون روی 'music'
busctl --user call rs.i3status /my_path rs.i3status.custom SetIcon s music
### تنظیم وضعیت روی 'good'
busctl --user call rs.i3status /my_path rs.i3status.custom SetState s good

از آن‌جا که انتشار اشیاء با نام یکسان از فرایندهای مختلف غیرممکن است، داشتن چندین بلوک dbus در نوارهای مختلف کار نخواهد کرد. به عنوان یک راه‌حل، می‌توانید متغیر محیطی I3RS_DBUS_NAME را برای تعیین رابطی که یک نوار روی آن کار می‌کند تنظیم کنید تا میان فرایندهای مختلف تمایز ایجاد شود. برای مثال، تنظیم این متغیر روی 'top'، به شما اجازه می‌دهد از rs.i3status.top استفاده کنید..SS در دست انجام (TODO)

•: ارسال یک سیگنال هنگام کلیک؟

disk_iostats

آمار ورودی/خروجی (I/O) دیسک

پیکربندی (Configuration)

کلید	مقادیر	پیش‌فرض
device	نام دستگاه بلوکی یا پارتیشن برای پایش (همان‌گونه که در /dev/ مشخص شده است)	در صورت تنظیم نشدن، دستگاه در هر interval به‌طور خودکار انتخاب خواهد شد
format	رشته‌ای برای سفارشی‌سازی خروجی این بلوک. برای جای‌نگه‌دارهای موجود به زیر مراجعه کنید.	" $icon $speed_read.eng(prefix:K) $speed_write.eng(prefix:K) "
interval	بازهٔ به‌روزرسانی بر حسب ثانیه	2
missing_format	مشابه format اما برای زمانی که دستگاه موجود نیست	" × "

جای‌نگه‌دار	مقدار	نوع	واحد
icon	یک شمایل ایستا	Icon	-
device	نام دستگاه	Text	-
speed_read	سرعت خواندن	Number	بایت بر ثانیه
speed_write	سرعت نوشتن	Number	بایت بر ثانیه
[[block]]
block = "disk_iostats"
device = "sda"
format = " $icon $speed_write.eng(prefix:K) "
استفاده از پارتیشن برچسب‌خورده Games از طریق نام‌های دستگاه پایدار از
/dev/disk/by-*/
[[block]]
block = "disk_iostats"
device = "disk/by-partlabel/Games"
format = " $icon $speed_write.eng(prefix:K) "
"آیکون‌های استفاده‌شده (Icons Used)"
• 2
disk_drive
disk_space
آمار مصرف دیسک
"پیکربندی (Configuration)"
tab(	);
lw(14.0n) lw(28.0n) lw(28.0n).
کلید	مقادیر	پیش‌فرض
path	مسیری که اطلاعات از آن جمع‌آوری می‌شود. از بسط مسیر مانند ~ پشتیبانی می‌کند.	"/"
interval	زمان به‌روزرسانی بر حسب ثانیه	20
format	یک رشته برای سفارشی‌سازی خروجی این بلوک. برای جای‌نگهدار‌های دردسترس به زیر مراجعه کنید.	" $icon $available "
format_alt	در صورت تنظیم، بلوک با هر کلیک بین format و format_alt جابه‌جا خواهد شد	None
warning	مقداری که وضعیت هشدار (warning) بلوک را فعال می‌کند	20.0
alert	مقداری که وضعیت بحرانی (critical) بلوک را فعال می‌کند	10.0
info_type	تعیین می‌کند که کدام اطلاعات بر وضعیت بلوک اثر بگذارد. مقادیر ممکن عبارتند از "available"، "free" و "used"	"available"
alert_unit	واحد گزینه‌های alert و warning. در صورت عدم تنظیم، از درصد استفاده می‌شود. مقادیر ممکن عبارتند از "B"، "KB"، "KiB"، "MB"، "MiB"، "GB"، "Gib"، "TB" و "TiB"	None
backend	بک‌اند مورد استفاده هنگام استعلام مصرف دیسک. مقادیر ممکن عبارتند از "vfs" (مانند du(1)) و "btrfs"	"vfs"

جای‌نگهدار	مقدار	نوع	واحد
icon	یک آیکون ایستا	Icon	-
path	مقدار گزینه path	Text	-
percentage	درصد آزاد یا مصرف‌شده. وابسته به info_type	Number	%
total	کل فضای دیسک	Number	Bytes
used	فضای مصرف‌شده دیسک	Number	Bytes
free	فضای آزاد دیسک	Number	Bytes
available	فضای دردسترس دیسک (فضای آزاد منهای فضای رزروشده سیستم)	Number	Bytes
tab(	);
lw(15.1n) lw(40.7n) lw(14.2n).
کنش	توضیحات	دکمه پیش‌فرض
toggle_format	جابه‌جایی میان format و format_alt	چپ

مثال‌ها

[[block]]
block = "disk_space"
info_type = "available"
alert_unit = "GB"
alert = 10.0
warning = 15.0
format = " $icon $available "
format_alt = " $icon $available / $total "

به‌روزرسانی بلوک با کلیک‌راست:

[[block]]
block = "disk_space"
[[block.click]]
button = "right"
update = true

نمایش بلوک تنها در صورتی که کمتر از ۱۰ گیگابایت فضا در دسترس باشد:

[[block]]
block = "disk_space"
format = " $free.eng(range:..10e9) |"

آیکون‌های مورد استفاده

•: disk_drive

docker

وضعیت دیمن محلی docker

پیکربندی

کلید	مقادیر	پیش‌فرض
interval	بازه زمانی به‌روزرسانی، به ثانیه.	5
format	رشته‌ای برای سفارشی‌سازی خروجی این بلوک. برای متغیرهای جایگزین موجود به بخش زیر مراجعه کنید.	" $icon $running.eng(w:1) "
socket_path	مسیر منتهی به سوکت docker. از بسط مسیر مانند ~ پشتیبانی می‌کند.	"/var/run/docker.sock"

کلید	مقدار	نوع	واحد
icon	یک آیکون ایستا	Icon	-
total	مجموع کانتینرهای روی میزبان	Number	-
running	کانتینرهای در حال اجرا روی میزبان	Number	-
stopped	کانتینرهای متوقف‌شده روی میزبان	Number	-
paused	کانتینرهای در حالت مکث روی میزبان	Number	-
images	مجموع ایمیج‌های روی میزبان	Number	-
[[block]]
block = "docker"
interval = 2
format = " $icon $running/$total "
آیکون‌های استفاده‌شده (Icons Used)
• 2
docker
external_ip
نشانی IP خارجی و اطلاعات گوناگون درباره آن
پیکربندی (Configuration)
tab(	);
lw(14.0n) lw(28.0n) lw(28.0n).
کلید	مقادیر	پیش‌فرض
format	رشته‌ای برای سفارشی‌سازی خروجی این بلوک. برای جایگزین‌های موجود به پایین مراجعه کنید.	" $ip $country_flag "
interval	فاصله زمانی بر حسب ثانیه برای به‌روزرسانی‌های خودکار	300
with_network_manager	اگر `true' باشد، به رویدادهای NetworkManager گوش می‌دهد و در صورت تغییر، IP را بی‌درنگ به‌روزرسانی می‌کند	true
use_ipv4	اگر `true' باشد، برای دریافت تمام اطلاعات از IPv4 استفاده می‌کند	false

کلید	مقدار	نوع	واحد
ip	نشانی IP خارجی، آن‌گونه که از یک سرور دوردست دیده می‌شود	متن	-
version	IPv4 یا IPv6	متن	-
city	نام شهر، مانند “San Francisco”	متن	-
region	نام منطقه، مانند “California”	متن	-
region_code	کد منطقه، مانند “CA” برای California	متن	-
country	کد کشور (۲ حرفی، ISO 3166-1 alpha-2)	متن	-
country_name	نام کوتاه کشور	متن	-
country_code	کد کشور (۲ حرفی، ISO 3166-1 alpha-2)	متن	-
country_code_iso3	کد کشور (۳ حرفی، ISO 3166-1 alpha-3)	متن	-
country_capital	پایتخت کشور	متن	-
country_tld	دامنه سطح‌بالای اختصاصی کشور (TLD)	متن	-
continent_code	کد قاره	متن	-
in_eu	کد منطقه، مانند “CA”	پرچم (Flag)	-
postal	کد پستی / ZIP	متن	-
latitude	عرض جغرافیایی	عدد	- (TODO: تبدیل به درجه؟)
longitude	طول جغرافیایی	عدد	- (TODO: تبدیل به درجه؟)
timezone	شهر	متن	-
utc_offset	انحراف UTC (با احتساب ساعت تابستانی) به‌صورت +HHMM یا -HHMM (HH ساعت، MM دقیقه است)	متن	-
country_calling_code	پیش‌شماره تلفن کشور (کد تماس، جداشده با کاما)	متن	-
currency	کد ارز (ISO 4217)	متن	-
currency_name	نام ارز	متن	-
languages	زبان‌های مکالمه (کد ۲ یا ۳ حرفی ISO 639 جداشده با کاما به همراه پسوند اختیاری کشور که با خط تیره جدا می‌شود)	متن	-
country_area	مساحت کشور (بر حسب کیلومتر مربع)	عدد	-
country_population	جمعیت کشور	عدد	-
timezone	منطقه زمانی	متن	-
org	سازمان	متن	-
asn	سیستم خودمختار (AS)	متن	-
country_flag	پرچم کشور	متن (گلیف)	-
مثال
[[block]]
block = "external_ip"
format = " $ip $country_code "
نکات
تمامی اطلاعات از
https://ipapi.co/json

دریافت می‌شود؛ مستندات آن‌ها را اینجا بررسی کنید:
https://ipapi.co/api/#complete-location5

آدرس IP در این مواقع استعلام می‌شود: ۱) هنگام شروع i3status-rs، ۲) زمانی که سیگنالی در D-Bus مبنی بر تغییر پیکربندی شبکه دریافت شود، ۳) هر ۵ دقیقه یک‌بار.
این تازه‌سازی دوره‌ای برای دریافت به‌روزرسانی‌های IP وجود دارد که اعلانی ایجاد نمی‌کنند، برای مثال به دلیل تازه‌سازی IP در روتر.
پرچم‌ها: آن‌ها آیکون نیستند بلکه گلیف‌های یونیکد هستند.
شما به فونتی نیاز خواهید داشت که شامل آن‌ها باشد.
آزمایش‌شده با:
https://www.babelstone.co.uk/Fonts/Flags.html

focused_window
پنجره دارای فوکوس فعلی
این بلوک عنوان و/یا نشان‌های فعال (هنگام استفاده با
sway/i3) پنجره‌ای را که در حال حاضر فوکوس دارد نمایش می‌دهد.
مدیر پنجره‌های پشتیبانی‌شده عبارتند از: sway، i3 و بیشتر
کامپوزیتورهای مبتنی بر wlroots.
برای اطلاعات بیشتر گزینه driver را ببینید.
پیکربندی
tab(	);
lw(14.0n) lw(28.0n) lw(28.0n).
کلید	مقادیر	پیش‌فرض
format	رشته‌ای برای سفارشی‌سازی خروجی این بلوک. برای متغیرهای جایگزین موجود به زیر مراجعه کنید.	" $title.str(max_w:21) \|"
driver	کدام درایور استفاده شود. مقادیر موجود: sway_ipc - برای i3 و sway، wlr_toplevel_management - برای کامپوزیتورهای Wayland که پروتکل https://gitlab.freedesktop.org/wlroots/wlr-protocols/-/blob/master/unstable/wlr-foreign-toplevel-management-unstable-v1.xml wlr-foreign-toplevel-management-unstable-v1 را پیاده‌سازی کرده‌اند، auto - تلاش برای حدس زدن خودکار درایور مناسب.	"auto"

متغیر جایگزین	مقدار	نوع	واحد
title	عنوان پنجره (ممکن است وجود نداشته باشد)	متن	-
marks	نشان‌های پنجره (تنها با sway/i3 موجود است)	متن	-
visible_marks	نشان‌های پنجره که با _ آغاز نمی‌شوند (تنها با sway/i3 موجود است)	متن	-
[[block]]
block = "focused_window"
[block.format]
full = " $title.str(max_w:15) \|"
short = " $title.str(max_w:10) \|"
این مثال به‌جای پنهان کردن بلوک در زمانی که عنوان پنجره خالی است، “Missing” را نمایش می‌دهد:
[[block]]
block = "focused_window"
format = " $title.str(0,21) \| Missing "
github
تعداد اعلان‌های GitHub
این بلوک تعداد اعلان‌های خوانده‌نشده یک حساب GitHub را نمایش می‌دهد.
یک
https://github.com/settings/tokens/new
توکن دسترسی شخصی (personal access token)

گیت‌هاب با دامنه دسترسی (scope) “notifications” مورد نیاز است، و باید با استفاده از متغیر محیطی I3RS_GITHUB_TOKEN یا گزینه پیکربندی token مشخص شود.
به‌صورت اختیاری، رنگ بلوک بر اساس بالاترین اعلان در فهرست‌های زیر (از بالاترین به پایین‌ترین اولویت) تعیین می‌شود:
critical، warning، info، good
پیکربندی (Configuration)
tab(	);
lw(14.0n) lw(28.0n) lw(28.0n).
کلید	مقادیر	پیش‌فرض
format	رشته‌ای برای سفارشی‌سازی خروجی این بلوک. برای نگه‌دارنده‌های مکان موجود، بخش زیر را ببینید.	" $icon $total.eng(w:1) "
interval	فاصله به‌روزرسانی بر حسب ثانیه	30
token	یک توکن دسترسی شخصی GitHub با دامنه دسترسی “notifications”	None
hide_if_total_is_zero	پنهان کردن این بلوک در صورتی که تعداد کل اعلان‌ها صفر باشد	false
critical	فهرستی از انواع اعلان‌ها که رنگ بلوک را به حالت بحرانی (critical) تغییر می‌دهند	None
warning	فهرستی از انواع اعلان‌ها که رنگ بلوک را به حالت هشدار (warning) تغییر می‌دهند	None
info	فهرستی از انواع اعلان‌ها که رنگ بلوک را به حالت اطلاع‌رسانی (info) تغییر می‌دهند	None
good	فهرستی از انواع اعلان‌ها که رنگ بلوک را به حالت مناسب (good) تغییر می‌دهند	None

تمام نگه‌دارنده‌های مکان (placeholders) اعدادی بدون واحد هستند.

نگه‌دارنده مکان	مقدار
icon	یک آیکون ایستا
total	تعداد کل اعلان‌ها
assign	شما به یک موضوع (issue) اختصاص داده شدید
author	شما این گفتگو (thread) را ایجاد کرده‌اید
comment	شما در این گفتگو دیدگاهی ارسال کرده‌اید
ci_activity	اجرای گردش‌کار (workflow run) در GitHub Actions که شما آغاز کرده بودید، تکمیل شد
invitation	شما دعوت‌نامه‌ای برای مشارکت در مخزن را پذیرفتید
manual	شما در گفتگو (از طریق یک issue یا pull request) مشترک شدید
mention	شما به‌طور خاص در محتوا مورد خطاب قرار گرفتید (@mentioned)
review_requested	از شما، یا تیمی که در آن عضو هستید، درخواست بازبینی (review) یک pull request شد
security_alert	گیت‌هاب یک آسیب‌پذیری امنیتی در مخزن شما کشف کرد
state_change	شما وضعیت گفتگو را تغییر دادید (برای مثال، بستن یک issue یا ادغام یک pull request)
subscribed	شما در حال دنبال کردن (watch) مخزن هستید
team_mention	شما در تیمی بودید که منشن (mention) شد
[[block]]
block = "github"
format = " $icon $total.eng(w:1)\|$mention.eng(w:1) "
interval = 60
token = "..."
[[block]]
block = "github"
token = "..."
format = " $icon $total.eng(w:1) "
info = ["total"]
warning = ["mention","review_requested"]
hide_if_total_is_zero = true
"آیکون‌های استفاده‌شده"
• 2
github
hueshift
مدیریت دمای رنگ نمایشگر
این بلوک دمای رنگ فعلی را بر حسب کلوین نمایش می‌دهد.
هنگام اسکرول کردن روی بلوک، دمای رنگ تغییر می‌کند.
کلیک چپ روی بلوک، دمای رنگ را روی
click_temp تنظیم می‌کند که مقدار پیش‌فرض آن 6500K است.
کلیک راست، دمای رنگ را به‌طور کامل به مقدار پیش‌فرض آن
(6500K) بازنشانی می‌کند.
پیکربندی
tab(	);
lw(14.0n) lw(28.0n) lw(28.0n).
کلید	مقادیر
پیش‌فرض
T}
format	رشته‌ای برای سفارشی‌سازی خروجی این بلوک. برای جانگهدارنده‌های موجود، بخش زیر را ببینید.
" $temperature "
T}
step	گام افزایش یا کاهش دمای رنگ بر حسب کلوین.
100
T}
hue_shifter	برنامه مورد استفاده برای کنترل رنگ صفحه نمایش.
تشخیص خودکار
T}
max_temp	حداکثر دمای رنگ بر حسب کلوین.
10000
T}
min_temp	حداقل دمای رنگ بر حسب کلوین.
1000
T}
click_temp	دمای رنگ کلیک چپ بر حسب کلوین.
6500
T}

جانگهدارنده	مقدار	نوع	واحد
temperature	دمای فعلی	عدد	-

عملیات	دکمه پیش‌فرض
set_click_temp	چپ
reset	راست
temperature_up	چرخ ماوس به بالا
temperature_down	چرخ ماوس به پایین
tab(	);
l l.
نام	پشتیبانی
"redshift"	X11
"sct"	X11
"gammastep"	X11 و Wayland
"wl_gammarelay"	Wayland
"wl_gammarelay_rs"	Wayland
"wlsunset"	Wayland

توجه داشته باشید که در حال حاضر، تنها wl_gammarelay و wl_gammarelay_rs مشترک رویدادها می‌شوند و در صورت تغییر خارجی دما، نوار را به‌روزرسانی می‌کنند. همچنین در حال حاضر این‌ها تنها درایورهایی هستند که تحت Wayland بدون پرش تصویر کار می‌کنند.

مثال (Example)

[[block]]
block = "hueshift"
hue_shifter = "redshift"
step = 50
click_temp = 3500

یک محدودیت سخت برای max_temp روی 10000K و به‌همین‌ترتیب برای min_temp روی 1000K تنظیم شده است. برای step نیز یک محدودیت سخت معادل 500K تعیین شده است تا از تغییرات بیش از حد ناگهانی جلوگیری شود.

kdeconnect

نشانگر KDEConnect

نمایش اطلاعات از دستگاه متصل فعلی در KDEConnect، که به‌صورت ناهمگام به‌روزرسانی می‌شود.

رنگ‌های بلوک بر اساس سطح باتری به‌روزرسانی می‌شوند، مگر اینکه تمام آستانه‌های bat_* روی 0 تنظیم شده باشند، که در این حالت رنگ‌های بلوک در عوض به تعداد اعلان‌ها وابسته خواهند بود..SS "پیکربندی (Configuration)"

کلید	مقادیر	پیش‌فرض
device_id	شناسهٔ دستگاه مطابق با خروجی kdeconnect --list-devices.	نخستین دستگاه یافت‌شده را در صورت وجود برمی‌گزیند.
format	رشته‌ای برای سفارشی‌سازی خروجی این بلوک. برای متغیرهای جانشین موجود به بخش زیر مراجعه کنید.	" $icon $name{ $bat_icon $bat_charge\|}{ $notif_icon\|} "
format_disconnected	مشابه format اما هنگامی که اتصال دستگاه قطع است	" $icon "
format_missing	مشابه format اما هنگامی که دستگاه وجود ندارد	" $icon x "
bat_info	حداقل سطح باتری که پایین‌تر از آن وضعیت روی info تنظیم می‌شود.	60
bat_good	حداقل سطح باتری که پایین‌تر از آن وضعیت روی good تنظیم می‌شود.	60
bat_warning	حداقل سطح باتری که پایین‌تر از آن وضعیت روی warning تنظیم می‌شود.	30
bat_critical	حداقل سطح باتری که پایین‌تر از آن وضعیت روی critical تنظیم می‌شود.	15

متغیر جانشین	مقدار	نوع	واحد
icon	آیکون بر پایهٔ وضعیت اتصال	آیکون	-
bat_icon	نشانگر سطح باتری (تنها هنگام اتصال و در صورت پشتیبانی)	آیکون	-
bat_charge	سطح شارژ باتری (تنها هنگام اتصال و در صورت پشتیبانی)	عدد	%
network_icon	نشانگر شبکهٔ همراه (تنها هنگام اتصال و در صورت پشتیبانی)	آیکون	-
network_type	نوع شبکهٔ همراه (تنها هنگام اتصال و در صورت پشتیبانی)	متن	-
network_strength	سطح سیگنال شبکهٔ همراه (تنها هنگام اتصال و در صورت پشتیبانی)	عدد	%
notif_icon	تنها هنگام اتصال و در صورت وجود اعلان‌ها	آیکون	-
notif_count	تعداد اعلان‌های تلفن همراه شما (تنها هنگام اتصال و غیرصفر بودن)	عدد	-
name	نام دستگاه شما طبق گزارش KDEConnect (در صورت در دسترس بودن)	متن	-
نام نمایش داده نشود، وضعیت “good” تنظیم نشود.
[[block]]
block = "kdeconnect"
format = " $icon {$bat_icon $bat_charge \|}{$notif_icon \|}{$network_icon$network_strength $network_type \|}"
bat_good = 101
"آیکون‌های استفاده‌شده (Icons Used)"
• 2
bat (به‌صورت پیش‌رونده)
• 2
bat_charging (به‌صورت پیش‌رونده)
• 2
net_cellular (به‌صورت پیش‌رونده)
• 2
notification
• 2
phone
• 2
phone_disconnected
keyboard_layout
نشانگر چیدمان صفحه‌کلید
شش راه‌انداز در دسترس است: - xkbevent که می‌تواند
به‌روزرسانی‌های ناهمگام را از رویدادهای x11 بخواند - setxkbmap (نام مستعار
برای xkbevent) منسوخ‌شده - xkbswitch
(نام مستعار برای xkbevent) منسوخ‌شده -
localebus که می‌تواند به‌روزرسانی‌های ناهمگام را از مسیر
D-Bus سامانه systemd در org.freedesktop.locale1 بخواند -
kbddbus که از
https://github.com/qnikst/kbdd
kbdd

برای پایش تغییرات چیدمان به‌ازای هر پنجره از طریق DBus استفاده می‌کند - sway
که می‌تواند به‌روزرسانی‌های ناهمگام را از sway IPC بخواند
setxkbmap و xkbswitch منسوخ شده‌اند و در نسخهٔ v0.35.0 حذف خواهند شد.
این‌که کدام‌یک از این روش‌ها مناسب است به پیکربندی سیستم شما بستگی دارد.
"پیکربندی (Configuration)"
tab(	);
lw(14.0n) lw(28.0n) lw(28.0n).
کلید	مقادیر	پیش‌فرض
driver	یکی از موارد "xkbevent"، "setxkbmap"، "xkbswitch"، "localebus"، "kbddbus" یا "sway"، بسته به سیستم شما.	"xkbevent"
interval منسوخ‌شده	بازهٔ زمانی به‌روزرسانی به ثانیه. تنها توسط راه‌انداز "setxkbmap" استفاده می‌شود.	60
format	رشته‌ای برای سفارشی‌سازی خروجی این بلوک. برای متغیرهای جایگزین دردسترس به ادامه مراجعه کنید.	" $layout "
sway_kb_identifier	شناسهٔ دستگاهی که می‌خواهید پایش کنید، همان‌طور که در خروجی swaymsg -t get_inputs یافت می‌شود.	پیش‌فرض نخستین ورودیِ یافت‌شده است
mappings	نگاشت layout (variant) به نام کوتاه سفارشی.	None

interval منسوخ شده است و در v0.35.0 حذف خواهد شد.

کلید	مقدار	نوع
layout	نام چیدمان صفحه‌کلید	String
variant	نام گونهٔ صفحه‌کلید یا N/A در صورت عدم کاربرد	String
گوش دادن به D-Bus برای تغییرات:
[[block]]
block = "keyboard_layout"
driver = "localebus"
گوش دادن به kbdd برای تغییرات؛ متن در قالب زیر است:
“English (US)” - {$layout ($variant)} از block.mappings برای
جایگزینی آن با نام‌های کوتاه‌تر، همان‌گونه که در زیر نشان داده شده است استفاده کنید.
همچنین از format = ” $layout ($variant) ” برای دیدن متن کامل
جهت نگاشت استفاده کنید، یا می‌توانید از dbus-monitor interface=ru.gentoo.kbdd برای
دیدن نگارش دقیق گونه (variant) بهره ببرید
[[block]]
block = "keyboard_layout"
driver = "kbddbus"
[block.mappings]
"English (US)" = "us"
"Bulgarian (new phonetic)" = "bg"
گوش دادن به sway برای تغییرات:
[[block]]
block = "keyboard_layout"
driver = "sway"
sway_kb_identifier = "1133:49706:Gaming_Keyboard_G110"
گوش دادن به sway برای تغییرات و بازنویسی نگاشت‌ها:
[[block]]
block = "keyboard_layout"
driver = "sway"
format = " $layout "
[block.mappings]
"English (Workman)" = "EN"
"Russian (N/A)" = "RU"
گوش دادن به رویدادهای xkb برای تغییرات:
[[block]]
block = "keyboard_layout"
driver = "xkbevent"
load
میانگین بار سیستم
"پیکربندی (Configuration)"
tab(	);
lw(7.3n) lw(57.5n) lw(5.3n).
کلید	مقادیر	پیش‌فرض
format	رشته‌ای برای سفارشی‌سازی خروجی این بلوک. برای نگه‌دارنده‌های دردسترس به زیر مراجعه کنید.	" $icon $1m.eng(w:4) "
interval	فاصله‌ی زمانی به‌روزرسانی برحسب ثانیه	3
info	حداقل بار برای تنظیم وضعیت روی info	0.3
warning	حداقل بار برای تنظیم وضعیت روی warning	0.6
critical	حداقل بار برای تنظیم وضعیت روی critical	0.9

نگه‌دارنده	مقدار	نوع	واحد
icon	یک آیکون ایستا	Icon	-
1m	میانگین بار ۱ دقیقه	Number	-
5m	میانگین بار ۵ دقیقه	Number	-
15m	میانگین بار ۱۵ دقیقه	Number	-
[[block]]
block = "load"
format = " $icon 1min avg: $1m.eng(w:4) "
interval = 1
آیکون‌های استفاده‌شده
• 2
cogs
maildir
نامه‌های خوانده‌نشده.
تنها از قالب maildir پشتیبانی می‌کند.
توجه داشته باشید که برای استفاده از این بلوک باید ویژگی maildir را فعال کنید:
cargo build --release --features maildir
پیکربندی
tab(	);
lw(14.0n) lw(28.0n) lw(28.0n).
کلید	مقادیر	پیش‌فرض
format	رشته‌ای برای شخصی‌سازی خروجی این بلوک. برای مشاهده جای‌بان‌های موجود، به زیر مراجعه کنید.	" $icon $status "
inboxes	فهرستی از صندوق‌های maildir برای جستجوی نامه‌ها در آن‌ها. از بسط‌های مسیر/glob پشتیبانی می‌کند (مانند ~ و *).	الزامی
threshold_warning	تعداد نامه‌های خوانده‌نشده‌ای که در آن وضعیت روی هشدار (warning) تنظیم می‌شود.	1
threshold_critical	تعداد نامه‌های خوانده‌نشده‌ای که در آن وضعیت روی بحرانی (critical) تنظیم می‌شود.	10
interval	فاصله زمانی به‌روزرسانی، به ثانیه.	5
display_type	کدام بخش از maildir شمارش شود: "new"، "cur" یا "all".	"new"

جای‌بان	مقدار	نوع	واحد
icon	یک آیکون ایستا	آیکون	-
status	تعداد ایمیل‌ها	عدد	-
[[block]]
block = "maildir"
interval = 60
inboxes = ["~/mail/local", "~/maildir/account1/*"]
threshold_warning = 1
threshold_critical = 10
display_type = "new"
"آیکون‌های استفاده‌شده"
• 2
mail
memory
میزان مصرف حافظه و swap
"پیکربندی"
tab(	);
lw(14.0n) lw(28.0n) lw(28.0n).
کلید	مقادیر	پیش‌فرض
format	رشته‌ای برای سفارشی‌سازی خروجی این بلوک هنگام قرار داشتن در نمای “Memory”. برای جای‌نگه‌دارهای موجود به پایین مراجعه کنید.	" $icon $mem_used.eng(prefix:Mi)/$mem_total.eng(prefix:Mi)($mem_used_percents.eng(w:2)) "
format_alt	در صورت تنظیم، بلوک با هر کلیک بین format و format_alt جابه‌جا خواهد شد	None
interval	فاصله زمانی به‌روزرسانی به ثانیه	5
warning_mem	درصد مصرف حافظه که در آن وضعیت روی warning تنظیم می‌شود	80.0
warning_swap	درصد مصرف swap که در آن وضعیت روی warning تنظیم می‌شود	80.0
critical_mem	درصد مصرف حافظه که در آن وضعیت روی critical تنظیم می‌شود	95.0
critical_swap	درصد مصرف swap که در آن وضعیت روی critical تنظیم می‌شود	95.0

جای‌نگه‌دار	مقدار	نوع	واحد
icon	آیکون حافظه	آیکون	-
icon_swap	آیکون swap	آیکون	-
mem_total	کل حافظه فیزیکی (RAM) در دسترس	عدد	بایت
mem_free	حافظه آزاد که هنوز توسط کرنل یا userspace استفاده نشده است (به‌طور کلی باید از mem_avail استفاده کنید)	عدد	بایت
mem_free_percents	مانند بالا، اما به‌صورت درصدی از کل حافظه	عدد	درصد
mem_avail	تخمین کرنل از حافظه آزادِ قابل استفاده که شامل حافظه کَش‌شده و بافرها می‌شود	عدد	بایت
mem_avail_percents	مانند بالا، اما به‌صورت درصدی از کل حافظه	عدد	درصد
mem_total_used	mem_total - mem_free	عدد	بایت
mem_total_used_percents	مانند بالا، اما به‌صورت درصدی از کل حافظه	عدد	درصد
mem_used	حافظه استفاده‌شده، بدون احتساب حافظه کَش‌شده و بافرها؛ مشابه نوار سبز htop	عدد	بایت
mem_used_percents	مانند بالا، اما به‌صورت درصدی از کل حافظه	عدد	درصد
buffers	بافرها، مشابه نوار آبی htop	عدد	بایت
buffers_percent	مانند بالا، اما به‌صورت درصدی از کل حافظه	عدد	درصد
cached	حافظه کَش‌شده (با در نظر گرفتن کَش ZFS ARC)، مشابه نوار زرد htop	عدد	بایت
cached_percent	مانند بالا، اما به‌صورت درصدی از کل حافظه	عدد	درصد
swap_total	کل swap	عدد	بایت
swap_free	مقدار آزاد swap	عدد	بایت
swap_free_percents	مانند بالا، اما به‌صورت درصدی از کل حافظه	عدد	درصد
swap_used	مقدار استفاده‌شده swap	عدد	بایت
swap_used_percents	مانند بالا، اما به‌صورت درصدی از کل حافظه	عدد	درصد
zram_compressed	میزان مصرف حافظه فشرده‌شده zram	عدد	بایت
zram_decompressed	میزان مصرف حافظه غیرفشرده zram	عدد	بایت
`zram_comp_ratio'	نسبت حافظه غیرفشرده به فشرده‌شده zram	عدد	-
zswap_compressed	میزان مصرف حافظه فشرده‌شده zswap (>=Linux 5.19)	عدد	بایت
zswap_decompressed	میزان مصرف حافظه غیرفشرده zswap (>=Linux 5.19)	عدد	بایت
zswap_decompressed_percents	مانند بالا، اما به‌صورت درصدی از کل حافظه zswap (>=Linux 5.19)	عدد	درصد
`zswap_comp_ratio'	نسبت حافظه غیرفشرده به فشرده‌شده zswap (>=Linux 5.19)	عدد	-
tab(	);
lw(15.1n) lw(40.7n) lw(14.2n).
کنش	توضیحات	دکمه پیش‌فرض
toggle_format	جابه‌جایی میان format و format_alt	Left

مثال‌ها (EXAMPLES)

[[block]]
block = "memory"
format = " $icon $mem_used_percents.eng(w:1) "
format_alt = " $icon_swap $swap_free.eng(w:3,u:B,p:Mi)/$swap_total.eng(w:3,u:B,p:Mi)($swap_used_percents.eng(w:2)) "
interval = 30
warning_mem = 70
critical_mem = 90

نمایش swap و پنهان‌سازی آن در صورت صفر بودن:

[[block]]
block = "memory"
format = " $icon $swap_used.eng(range:1..) |"

آیکون‌های استفاده‌شده

•: memory_mem
•: memory_swap

یک منوی سفارشی

این بلوک به شما اجازه می‌دهد تا به‌سرعت یک دستور شل سفارشی را اجرا کنید. برای فعال کردن این بلوک، روی آن چپ-کلیک کنید، سپس میان موارد پیکربندی‌شده پیمایش نمایید. برای اجرای هر مورد روی آن چپ-کلیک کرده و در صورت نیاز با چپ-کلیک مجدد، عملیات را تأیید کنید. در هر زمان می‌توانید برای غیرفعال کردن این بلوک، راست-کلیک کنید.

پیکربندی (Configuration)

کلید	مقادیر	پیش‌فرض
text	متنی که هنگام غیرفعال بودن بلوک نمایش داده خواهد شد.	الزامی
items	فهرستی از “items”. مثال‌های زیر را ببینید.	الزامی
[[block]]
block = "menu"
text = "\uf011"
[[block.items]]
display = " -> Sleep <-"
cmd = "systemctl suspend"
[[block.items]]
display = " -> Power Off <-"
cmd = "poweroff"
confirm_msg = "Are you sure you want to power off?"
[[block.items]]
display = " -> Reboot <-"
cmd = "reboot"
confirm_msg = "Are you sure you want to reboot?"
music
عنوان و نام هنرمند آهنگ فعلی
همچنین دکمه‌هایی برای پخش/توقف، قبلی و بعدی فراهم می‌کند.
از تمام پخش‌کننده‌های موسیقی که
https://specifications.freedesktop.org/mpris-spec/latest/Player_Interface.html
MediaPlayer2 Interface

را پیاده‌سازی کرده باشند پشتیبانی می‌کند.
این شامل موارد زیر است:
• 2
Spotify
• 2
VLC
• 2
mpd (از طریق
https://github.com/eonpatapon/mpDris2
mpDris2

)
و بسیاری موارد دیگر.
به‌طور پیش‌فرض این بلوک تمام پخش‌کننده‌های موجود روی گذرگاه (bus) MPRIS را رهگیری می‌کند.
کلیک‌راست روی بلوک، آن را به پخش‌کنندهٔ بعدی تغییر می‌دهد.
می‌توانید با استفاده از تنظیم “player”، ابزارک را روی یک پخش‌کنندهٔ مشخص ثابت (pin) کنید.
پیکربندی (Configuration)
tab(	);
lw(14.0n) lw(28.0n) lw(28.0n).
کلید	مقادیر	پیش‌فرض
format	رشته‌ای برای سفارشی‌سازی خروجی این بلوک. برای متغیرهای جایگزین موجود به بخش زیر مراجعه کنید.	" $icon {$combo.str(max_w:25,rot_interval:0.5) $play \|}"
format_alt	در صورت تنظیم، بلوک با هر کلیک بین format و format_alt جابه‌جا خواهد شد	None
player	نام رابط (های) MPRIS پخش‌کننده(های) موسیقی. این مقدار می‌تواند نام یک پخش‌کننده یا آرایه‌ای از نام‌های پخش‌کننده‌های موسیقی باشد. دستور busctl --user list \| grep "org.mpris.MediaPlayer2." \| cut -d' ' -f1 را اجرا کنید؛ نام مورد نظر بخش بعد از “org.mpris.MediaPlayer2.” است.	None
interface_name_exclude	فهرستی از الگوهای عبارات باقاعده (regex) برای نام‌های رابط MPRIS پخش‌کننده که باید نادیده گرفته شوند.	["playerctld"]
separator	رشته‌ای که باید بین نام هنرمند و عنوان آهنگ قرار گیرد.	" - "
seek_step_secs	تعداد ثانیه‌های مثبت برای پرش به جلو/عقب هنگام اسکرول روی نوار. نیازی نیست حتماً یک عدد صحیح باشد.	1
seek_forward_step_secs	تعداد ثانیه‌های مثبت برای پرش به جلو هنگام اسکرول روی نوار. نیازی نیست حتماً یک عدد صحیح باشد.	seek_step_secs
seek_backward_step_secs	تعداد ثانیه‌های مثبت برای پرش به عقب هنگام اسکرول روی نوار. نیازی نیست حتماً یک عدد صحیح باشد.	seek_step_secs
volume_step	درصد افزایش/کاهش میزان صدا برای دستگاه صوتی انتخاب‌شده هنگام اسکرول کردن. به‌طور خودکار حداکثر روی ۵۰ محدود می‌شود.	5

نکته: تمام متغیرهای جایگزین به‌جز icon می‌توانند وجود نداشته باشند. برای یادگیری نحوه مدیریت این وضعیت، مثال‌های زیر را ببینید.

متغیر جایگزین	مقدار	نوع
icon	یک آیکون ایستا	آیکون
artist	هنرمند فعلی	متن
title	عنوان فعلی	متن
url	نشانی اینترنتی (URL) آهنگ فعلی	متن
combo	بسته به این‌که چه اطلاعاتی موجود باشد، به “$artist[sep]$title"، "$artist"، "$title" یا "$url" تبدیل می‌شود. [sep] توسط گزینهٔ separator تعیین می‌شود.	متن
player	نام پخش‌کنندهٔ فعلی (برگرفته از بخش پایانی نام گذرگاه MPRIS آن)	متن
avail	تعداد کل پخش‌کننده‌های در دسترس برای جابه‌جایی میان آن‌ها	عدد
cur	شماره شاخص پخش‌کنندهٔ فعلی از میان پخش‌کننده‌های در دسترس	عدد
play	دکمه پخش/توقف	آیکون قابل کلیک
next	دکمه بعدی	آیکون قابل کلیک
prev	دکمه قبلی	آیکون قابل کلیک
volume_icon	آیکون بر اساس میزان صدا. در صورت عدم پشتیبانی وجود ندارد.	آیکون
volume	میزان صدای فعلی. در صورت بی‌صدا بودن یا عدم پشتیبانی وجود ندارد.	عدد
tab(	);
l l.
ابزارک	جای‌نگهدار
play_pause_btn	$play
next_btn	$next
prev_btn	$prev

عملیات	دکمه پیش‌فرض
play_pause	کلیک چپ روی play_pause_btn
next	کلیک چپ روی next_btn
prev	کلیک چپ روی prev_btn
next_player	کلیک راست
seek_forward	اسکرول به بالا
seek_backward	اسکرول به پایین
volume_up	-
volume_down	-
toggle_format	کلیک چپ
نمایش آهنگ در حال پخش تنها در Spotify، همراه با دکمه‌های play و next و محدود کردن عرض به ۲۰ نویسه:
[[block]]
block = "music"
format = " $icon {$combo.str(max_w:20) $play $next \|}"
player = "spotify"
همان مورد برای هر پخش‌کننده‌ی سازگار، انتخاب نخستین موردِ فعال روی گذرگاه، اما نادیده گرفتن “mpd” یا هر چیزی که شامل “kdeconnect” در نام خود باشد:
[[block]]
block = "music"
format = " $icon {$combo.str(max_w:20) $play $next \|}"
interface_name_exclude = [".kdeconnect.", "mpd"]
همانند بالا، اما با نمایش متن به‌صورت چرخشی:
[[block]]
block = "music"
format = " $icon {$combo.str(max_w:20,rot_interval:0.5) $play $next \|}"
interface_name_exclude = [".kdeconnect.", "mpd"]
کلیک در هر نقطه برای پخش/مکث، کلیک وسط برای تغییر قالب نمایش:
[[block]]
block = "music"
format = " format 1 "
format_alt = " format 2 "
[[block.click]]
button = "left"
action = "play_pause"
[[block.click]]
button = "middle"
widget = "."
action = "toggle_format"
پیمایش (اسکرول) برای تغییر حجم صدای پخش‌کننده، استفاده از دکمه‌های forward و back برای پرش زمانی (seek):
[[block]]
block = "music"
format = " $icon $volume_icon $combo $play $next\| "
seek_step_secs = 10
[[block.click]]
button = "up"
action = "volume_up"
[[block.click]]
button = "down"
action = "volume_down"
[[block.click]]
button = "forward"
action = "seek_forward"
[[block.click]]
button = "back"
action = "seek_backward"
"آیکون‌های مورداستفاده (Icons Used)"
• 2
music
• 2
music_next
• 2
music_play
• 2
music_prev
• 2
volume_muted
• 2
volume (به‌صورت پیش‌رونده).SS net
اطلاعات شبکه
این بلوک از sysfs و netlink استفاده می‌کند و بنابراین
به هیچ وابستگی خارجی نیاز ندارد.
پیکربندی (Configuration)
tab(	);
lw(14.0n) lw(28.0n) lw(28.0n).
کلید	مقادیر
پیش‌فرض
T}
device	رابط شبکه برای پایش (همان‌گونه که در /sys/class/net/ مشخص شده است). از regex پشتیبانی می‌کند.
در صورت تنظیم نشدن، دستگاه در هر
interval به‌طور خودکار انتخاب می‌شود
T}
interval	بازه به‌روزرسانی بر حسب ثانیه
2
T}
format	رشته‌ای برای سفارشی‌سازی خروجی این بلوک. برای جای‌نگهدار‌های موجود به بخش زیر مراجعه کنید.
" $icon ^icon_net_down $speed_down.eng(prefix:K) ^icon_net_up $speed_up.eng(prefix:K) "
T}
format_alt	در صورت تنظیم، بلوک با هر کلیک بین format و format_alt جابه‌جا خواهد شد
None
T}
inactive_format	مشابه format، اما برای زمانی که رابط غیرفعال است
" $icon Down "
T}
missing_format	مشابه format، اما برای زمانی که دستگاه یافت نمی‌شود
" × "
T}

کنش	توضیحات	دکمه پیش‌فرض
toggle_format	بین format و format_alt جابه‌جا می‌شود	چپ (Left)

جای‌نگهدار	مقدار	نوع	واحد
icon	آیکون بر اساس نوع دستگاه	آیکون	-
speed_down	سرعت دانلود	عدد	بایت بر ثانیه
speed_up	سرعت آپلود	عدد	بایت بر ثانیه
graph_down	نمودار سرعت دانلود	متن	-
graph_up	نمودار سرعت آپلود	متن	-
device	نام دستگاه	متن	-
ssid	شناسه SSID شبکه (تنها WiFi)	متن	-
frequency	فرکانس WiFi	عدد	هرتز (Hz)
signal_strength	سیگنال WiFi	عدد	%
bitrate	نرخ بیت اتصال WiFi	عدد	بیت بر ثانیه
ip	آدرس IPv4 رابط	متن	-
ipv6	آدرس IPv6 رابط	متن	-
nameserver	کارساز نام (Nameserver)	متن	-
نمایش اطلاعات WiFi در صورت دردسترس بودن
[[block]]
block = "net"
format = " $icon {$signal_strength $ssid $frequency\|Wired connection} via $device "
نمایش دقیق دستگاه
[[block]]
block = "net"
device = "^wlo0$"
آیکون‌های استفاده‌شده
• 2
net_loopback
• 2
net_vpn
• 2
net_wired
• 2
net_wireless (به‌صورت مرحله‌ای)
• 2
net_up
• 2
net_down
notify
نمایش و تغییر وضعیت دیمن اعلان‌ها
کلیک چپ روی این بلوک، اعلان‌ها را فعال/غیرفعال می‌کند.
پیکربندی (Configuration)
tab(	);
lw(14.0n) lw(28.0n) lw(28.0n).
کلید	مقادیر	پیش‌فرض
driver	مشخص می‌کند کدام دیمن اعلان در حال اجرا است. راه‌اندازهای موجود عبارتند از: "dunst" و "swaync"	"dunst"
format	رشته‌ای برای سفارشی‌سازی خروجی این بلوک. برای مشاهده جای‌نگه‌دارهای موجود به جدول زیر مراجعه کنید.	" $icon "

جای‌نگه‌دار	مقدار	نوع	واحد
icon	آیکون بر اساس وضعیت اعلان	Icon	-
notification_count[1]	تعداد اعلان‌ها (اگر 0 باشد حذف می‌شود)	Number	-
history_count[2]	تعداد اعلان‌ها در تاریخچه (اگر 0 باشد حذف می‌شود)	Number	-
paused	تنها در صورتی وجود دارد که اعلان‌ها غیرفعال باشند	Flag	-

عملیات	دکمه پیش‌فرض
toggle_paused	Left
show	-
show_all	-

عملیات‌های show و show_all برای SwayNC یکسان هستند..SS مثال‌ها نحوه استفاده از پرچم paused

[[block]]
block = "notify"
format = " $icon {$paused{Off}|On} "

نحوه استفاده از notification_count

[[block]]
block = "notify"
format = " $icon {($notification_count.eng(w:1)) |}"

نحوه نگاشت مجدد کنش‌ها

[[block]]
block = "notify"
driver = "swaync"
[[block.click]]
button = "left"
action = "show"
[[block.click]]
button = "right"
action = "toggle_paused"

آیکون‌های استفاده‌شده

•: bell
•: bell-slash

notmuch

شمارش پیام‌های notmuch

این بلوک از یک پایگاه‌داده notmuch پرس‌وجو کرده و تعداد پیام‌ها را نمایش می‌دهد.

ساده‌ترین پیکربندی، تعداد کل پیام‌های موجود در پایگاه‌داده notmuch ذخیره‌شده در $HOME/.mail را بازمی‌گرداند.

توجه داشته باشید که برای استفاده از این بلوک باید ویژگی notmuch را فعال کنید:

cargo build --release --features notmuch

پیکربندی

کلید	مقادیر	پیش‌فرض
format	رشته‌ای برای سفارشی‌سازی خروجی این بلوک. برای جانگه‌دارهای موجود به بخش زیر مراجعه کنید.	" $icon $count "
maildir	مسیر دایرکتوری حاوی پایگاه‌داده notmuch. از بسط مسیر مانند ~ پشتیبانی می‌کند.	~/.mail
query	پرس‌وجو برای اجرا روی پایگاه‌داده.	""
threshold_critical	تعداد نامه‌هایی که وضعیت critical را فعال می‌کند.	99999
threshold_warning	تعداد نامه‌هایی که وضعیت warning را فعال می‌کند.	99999
threshold_good	تعداد نامه‌هایی که وضعیت good را فعال می‌کند.	99999
threshold_info	تعداد نامه‌هایی که وضعیت info را فعال می‌کند.	99999
interval	فاصله زمانی به‌روزرسانی بر حسب ثانیه.	10

جانگه‌دار	مقدار	نوع	واحد
icon	یک آیکون ایستا	آیکون	-
count	تعداد پیام‌ها برای پرس‌وجو	عدد	-
[[block]]
block = "notmuch"
query = "tag:alert and not tag:trash"
threshold_warning = 1
threshold_critical = 10
[[block.click]]
button = "left"
update = true
آیکون‌های استفاده‌شده (Icons Used)
• 2
mail
nvidia_gpu
نمایش آمار و وضعیت پردازندهٔ گرافیکی NVidia شما
به‌طور پیش‌فرض show_temperature حافظهٔ مصرف‌شده را نمایش می‌دهد.
کلیک چپ ماوس روی بخش “temperature” از بلوک،
نمایش آن را بین حافظهٔ مصرفی یا کل حافظهٔ در دسترس تغییر می‌دهد.
کلیک چپ ماوس روی بخش “fan speed” بلوک باعث ورود آن به حالت تنظیم سرعت فن می‌شود.
در این حالت می‌توانید با چرخاندن چرخ ماوس (اسکرول) روی بلوک سرعت فن را تغییر دهید،
و با کلیک چپ از این حالت خارج شوید.
برای نمایش اطلاعات به nvidia-smi و برای تنظیم سرعت فن به
nvidia_settings نیاز است.
پیکربندی (Configuration)
tab(	);
lw(14.0n) lw(28.0n) lw(28.0n).
کلید	مقادیر	پیش‌فرض
gpu_id	شناسه GPU در سیستم.	0
format	رشته‌ای برای سفارشی‌سازی خروجی این بلوک. برای متغیرهای جایگزین موجود به ادامه مراجعه کنید.	" $icon $utilization $memory $temperature "
interval	بازه زمانی به‌روزرسانی بر حسب ثانیه.	1
idle	حداکثر دما که پایین‌تر از آن، وضعیت روی idle تنظیم می‌شود	50
good	حداکثر دما که پایین‌تر از آن، وضعیت روی good تنظیم می‌شود	70
info	حداکثر دما که پایین‌تر از آن، وضعیت روی info تنظیم می‌شود	75
warning	حداکثر دما که پایین‌تر از آن، وضعیت روی warning تنظیم می‌شود	80

متغیر جایگزین	نوع	واحد
icon	آیکون	-
name	متن	-
utilization	عدد	درصد
memory	عدد	بایت
temperature	عدد	درجه
fan_speed	عدد	درصد
clocks	عدد	هرتز
power	عدد	وات

ویجت	متغیر جایگزین
mem_btn	$memory
fan_btn	$fan_speed
tab(	);
l l.
عملیات	دکمه پیش‌فرض
toggle_mem_total	کلیک چپ روی mem_btn
toggle_fan_controlled	کلیک چپ روی fan_btn
fan_speed_up	اسکرول به بالا روی fan_btn
fan_speed_down	اسکرول به پایین روی fan_btn

مثال (Example)

[[block]]
block = "nvidia_gpu"
interval = 1
format = " $icon GT 1030 $utilization $temperature $clocks "

آیکون‌های استفاده‌شده (Icons Used)

•: gpu

کارهای آینده (TODO)

•: ارائه‌ی گزینه‌ی mappings مشابه با keyboard_layout برای نگاشت نام‌های GPU به برچسب‌ها؟

بسته‌ها (packages)

به‌روزرسانی‌های معلق برای مدیر بسته‌های مختلف مانند apt، pacman و غیره.

در حال حاضر، این مدیر بسته‌ها پشتیبانی می‌شوند: - apk برای Alpine Linux - apt برای سیستم‌های مبتنی بر Debian/Ubuntu - aur برای سیستم‌های مبتنی بر Arch - brew برای مدیر بسته‌ی Homebrew - dnf برای سیستم‌های مبتنی بر Fedora - flatpak برای بسته‌های Flatpak - pacman برای سیستم‌های مبتنی بر Arch - snap برای بسته‌های Snap - xbps برای Void Linux - zypper برای openSUSE

پیکربندی (Configuration)

کلید	مقادیر	پیش‌فرض
interval	بازه‌ی زمانی به‌روزرسانی بر حسب ثانیه.	600
package_manager	مدیر بسته جهت بررسی برای به‌روزرسانی‌ها	به‌طور خودکار از الگوهای format مشتق می‌شود، اما می‌تواند برای اثرگذاری بر مقدار $total استفاده شود
format	رشته‌ای جهت سفارشی‌سازی خروجی این بلوک. جانگهدارنده‌های دردسترس را در زیر ببینید.	" $icon $total.eng(w:1) "
format_singular	مشابه format، اما برای زمانی که دقیقاً یک به‌روزرسانی موجود است.	" $icon $total.eng(w:1) "
format_up_to_date	مشابه format، اما برای زمانی که هیچ به‌روزرسانی‌ای موجود نیست.	" $icon $total.eng(w:1) "
warning_updates_regex	نمایش بلوک در حالت اخطار (warning) در صورتی که به‌روزرسانی‌های منطبق با عبارت باقاعده موجود باشند.	None
critical_updates_regex	نمایش بلوک در حالت بحرانی (critical) در صورتی که به‌روزرسانی‌های منطبق با عبارت باقاعده موجود باشند.	None
ignore_updates_regex	به‌روزرسانی‌های منطبق با عبارت باقاعده را در شمارش لحاظ نمی‌کند.	None
ignore_phased_updates	به‌روزرسانی‌های مرحله‌ای که احتمالاً معوق مانده‌اند را در شمارش لحاظ نمی‌کند. (برای سیستم‌های مبتنی بر Debian/Ubuntu)	false
aur_command	دستور AUR جهت بررسی به‌روزرسانی‌های دردسترس، که خروجی را با همان قالب pacman تولید می‌کند. به‌عنوان مثال: yay -Qua (برای سیستم‌های مبتنی بر Arch)	در صورت استفاده از $aur الزامی است

جانگهدارنده	مقدار	نوع	واحد
icon	یک آیکون ایستا	آیکون	-
apk	تعداد به‌روزرسانی‌های دردسترس در Alpine Linux	عدد	-
apt	تعداد به‌روزرسانی‌های دردسترس در سیستم‌های مبتنی بر Debian/Ubuntu	عدد	-
aur	تعداد به‌روزرسانی‌های دردسترس در سیستم‌های مبتنی بر Arch	عدد	-
brew	تعداد به‌روزرسانی‌های دردسترس در مدیر بسته‌ی Homebrew	عدد	-
dnf	تعداد به‌روزرسانی‌های دردسترس در سیستم‌های مبتنی بر Fedora	عدد	-
flatpak	تعداد به‌روزرسانی‌های دردسترس در بسته‌های Flatpak	عدد	-
pacman	تعداد به‌روزرسانی‌های دردسترس در سیستم‌های مبتنی بر Arch	عدد	-
snap	تعداد به‌روزرسانی‌های دردسترس در بسته‌های Snap	عدد	-
xbps	تعداد به‌روزرسانی‌های دردسترس در Void Linux	عدد	-
zypper	تعداد به‌روزرسانی‌های دردسترس در openSUSE	عدد	-
total	تعداد به‌روزرسانی‌های دردسترس در تمام مدیر بسته‌های فهرست‌شده	عدد	-
Apt
این بلوک در پشت صحنه از apt استفاده می‌کند و برای اجرای آن
بدون دسترسی‌های ریشه (root)، برنامه i3status-rust پایگاه‌داده بسته‌های
مخصوص به خود را در /tmp/i3rs-apt/ ایجاد می‌کند که ممکن است
چندین مگابایت یا بیشتر فضا اشغال کند.
اگر پیکربندی سفارشی برای apt دارید، ممکن است این بلوک مطابق انتظار کار نکند
- در این صورت لطفاً یک issue گزارش کنید.
نکته: می‌توانید فهرست به‌روزرسانی‌های در دسترس را با استفاده از
APT_CONFIG=/tmp/i3rs-apt/apt.conf apt list --upgradable
دریافت کنید.
Pacman
نیازمند نصب بودن fakeroot است (فقط برای pacman لازم است).
نکته: می‌توانید فهرست به‌روزرسانی‌های در دسترس را با استفاده از
fakeroot pacman -Qu --dbpath /tmp/checkup-db-i3statusrs-$USER/
دریافت کنید.
اگر متغیر محیطی CHECKUPDATES_DB روی سیستم شما تنظیم شده است،
آن دایرکتوری را جایگزین کنید.
یادداشت: در صورت عدم اتصال به اینترنت، pikaur ممکن است کل بلوک را معلق (hang) کند
https://github.com/actionless/pikaur/issues/595
مرجع

.
در این صورت، از یک دستیار AUR دیگر استفاده کنید.
قلاب Pacman (Pacman hook)
نکته: در Arch Linux می‌توانید یک قلاب pacman تنظیم کنید تا
پس از ارتقای بسته‌ها، سیگنالی به i3status-rs برای به‌روزرسانی ارسال کند؛
بنابراین اطلاعات کهنه در بلوک pacman شما باقی نخواهد ماند.
در پیکربندی بلوک، مقدار signal = 1 را قرار دهید (یا اگر 1
توسط بلوک دیگری استفاده می‌شود، عددی دیگر):
[[block]]
block = "packages"
signal = 1
فایل /etc/pacman.d/hooks/i3status-rust.hook را با محتویات
زیر بسازید:
[Trigger]
Operation = Upgrade
Type = Package
Target = *
[Action]
When = PostTransaction
Exec = /usr/bin/pkill -SIGRTMIN+1 i3status-rs
مثال (Example)
پیکربندی اختصاصی Apk:
[[block]]
block = "packages"
package_manager = ["apk"]
interval = 1800
error_interval = 300
max_retries = 5
format = " $icon $apk.eng(w:1) updates available "
format_singular = " $icon One update available "
format_up_to_date = " $icon system up to date "
[[block.click]]
### نمایش dmenu با به‌روزرسانی‌های در دسترس. هر جایگزین دیگری برای dmenu نیز کار خواهد کرد.
button = "left"
cmd = "apk --no-cache --upgradable list \| dmenu -l 10";
پیکربندی اختصاصی Apt:
[[block]]
block = "packages"
interval = 1800
error_interval = 300
max_retries = 5
package_manager = ["apt"]
format = " $icon $apt updates available"
format_singular = " $icon One update available "
format_up_to_date = " $icon system up to date "
[[block.click]]
### نمایش dmenu با به‌روزرسانی‌های ذخیره‌شده موجود. هر جایگزین دیگری برای dmenu نیز کار خواهد کرد.
button = "left"
cmd = "APT_CONFIG=/tmp/i3rs-apt/apt.conf apt list --upgradable \| tail -n +2 \| rofi -dmenu"
[[block.click]]
### به‌روزرسانی بلوک با کلیک راست
button = "right"
update = true
پیکربندی اختصاصی Brew:
[[block]]
block = "packages"
package_manager = ["brew"]
interval = 1800
error_interval = 300
max_retries = 5
format = " $icon $brew.eng(w:1) updates available "
format_singular = " $icon One update available "
format_up_to_date = " $icon system up to date "
[[block.click]]
### نمایش dmenu با به‌روزرسانی‌های در دسترس. هر جایگزین دیگری برای dmenu نیز کار خواهد کرد.
button = "left"
cmd = "brew outdated \| dmenu -l 10";
پیکربندی اختصاصی Dnf:
[[block]]
block = "packages"
package_manager = ["dnf"]
interval = 1800
error_interval = 300
max_retries = 5
format = " $icon $dnf.eng(w:1) updates available "
format_singular = " $icon One update available "
format_up_to_date = " $icon system up to date "
[[block.click]]
### نمایش dmenu با به‌روزرسانی‌های ذخیره‌شده موجود. هر جایگزین دیگری برای dmenu نیز کار خواهد کرد.
button = "left"
cmd = "dnf list -q --upgrades \| tail -n +2 \| rofi -dmenu"
پیکربندی اختصاصی Flatpak:
[[block]]
block = "packages"
package_manager = ["flatpak"]
interval = 1800
error_interval = 300
max_retries = 5
format = " $icon $flatpak.eng(w:1) updates available "
format_singular = " $icon One update available "
format_up_to_date = " $icon system up to date "
[[block.click]]
### نمایش dmenu با به‌روزرسانی‌های ذخیره‌شده موجود. هر جایگزین دیگری برای dmenu نیز کار خواهد کرد.
button = "left"
cmd = "flatpak remote-ls --updates --columns=ref \| rofi -dmenu"
پیکربندی اختصاصی Pacman:
[[block]]
block = "packages"
package_manager = ["pacman"]
interval = 600
error_interval = 300
max_retries = 5
format = " $icon $pacman updates available "
format_singular = " $icon $pacman update available "
format_up_to_date = " $icon system up to date "
[[block.click]]
### باز کردن منوی نمایش‌دهنده به‌روزرسانی‌های موجود. wofi را با دستور منوی دلخواه خود جایگزین کنید.
button = "left"
cmd = "fakeroot pacman -Qu --dbpath /tmp/checkup-db-i3statusrs-$USER/ \| wofi --show dmenu";
[[block.click]]
### به‌روزرسانی بلوک با کلیک راست
button = "right"
update = true
پیکربندی Pacman و دستیار AUR:
[[block]]
block = "packages"
package_manager = ["pacman", "aur"]
interval = 600
error_interval = 300
max_retries = 5
format = " $icon $pacman + $aur = $total updates available "
format_singular = " $icon $total update available "
format_up_to_date = " $icon system up to date "
### دستور aur_command باید به‌روزرسانی‌های موجود را در خروجی استاندارد چاپ کند (مانند echo -ne "update\n")
aur_command = "yay -Qua"
پیکربندی فقط Snap:
[[block]]
block = "packages"
package_manager = ["snap"]
interval = 1800
error_interval = 300
max_retries = 5
format = " $icon $snap.eng(w:1) updates available "
format_singular = " $icon One update available "
format_up_to_date = " $icon system up to date "
[[block.click]]
### dmenu را با به‌روزرسانی‌های موجود نمایش می‌دهد. هر جایگزین دیگری برای dmenu نیز باید کار کند.
button = "left"
cmd = "snap refresh --list \| dmenu -l 10";
پیکربندی فقط Xbps:
[[block]]
block = "packages"
package_manager = ["xbps"]
interval = 1800
error_interval = 300
max_retries = 5
format = " $icon $xbps.eng(w:1) updates available "
format_singular = " $icon One update available "
format_up_to_date = " $icon system up to date "
[[block.click]]
### dmenu را با به‌روزرسانی‌های موجود نمایش می‌دهد. هر جایگزین دیگری برای dmenu نیز باید کار کند.
button = "left"
cmd = "xbps-install -Mun \| dmenu -l 10";
پیکربندی فقط Zypper:
[[block]]
block = "packages"
package_manager = ["zypper"]
interval = 1800
error_interval = 300
max_retries = 5
format = " $icon $zypper.eng(w:1) updates available "
format_singular = " $icon One update available "
format_up_to_date = " $icon system up to date "
[[block.click]]
### dmenu را با به‌روزرسانی‌های موجود نمایش می‌دهد. هر جایگزین دیگری برای dmenu نیز باید کار کند.
button = "left"
cmd = "zypper -q list-updates \| tail -n +3 \| rofi -dmenu -window-title 'Upgradable packages:'"
پیکربندی چند مدیر بسته:
به‌روزرسانی فهرست به‌روزرسانی‌های در انتظار هر سی دقیقه (1800 ثانیه):
[[block]]
block = "packages"
package_manager = ["apk", "apt", "aur", "brew", "dnf", "flatpak", "pacman", "snap", "xbps", "zypper"]
interval = 1800
error_interval = 300
max_retries = 5
format = " $icon $apk + $apt + $aur + $brew + $dnf + $flatpak + $pacman + $snap + $xbps + $zypper = $total updates available "
format_singular = " $icon One update available "
format_up_to_date = " $icon system up to date "
### اگر یک به‌روزرسانی linux موجود باشد، اما بستهٔ ZFS موجود نباشد، عملاً امکان
### ارتقای سیستم وجود نخواهد داشت، بنابراین یک هشدار نمایش می‌دهیم.
warning_updates_regex = "(linux\|linux-lts\|linux-zen)"
### اگر ZFS در دسترس باشد، می‌دانیم که می‌توانیم و باید ارتقا را انجام دهیم، بنابراین
### وضعیت را به صورت بحرانی نمایش می‌دهیم.
critical_updates_regex = "(zfs\|zfs-lts)"
"آیکون‌های استفاده‌شده"
• 2
update
pomodoro
یک
https://en.wikipedia.org/wiki/Pomodoro_Technique
تایمر پومودورو
.SS تکنیک (Technique)
در تکنیک اصلی شش مرحله وجود دارد:
۱) درباره کاری که باید انجام شود تصمیم‌گیری کنید.
۲) زمان‌سنج پومودورو را تنظیم کنید (به‌طور سنتی روی ۲۵ دقیقه).
۳) روی کار تمرکز و فعالیت کنید.
۴) با زنگ خوردن زمان‌سنج کار را پایان دهید و یک علامت تیک روی تکه‌ای کاغذ بگذارید.
۵) اگر کمتر از چهار علامت تیک دارید، یک استراحت کوتاه (۳–۵ دقیقه) داشته باشید و سپس به مرحله ۲ بازگردید.
۶) پس از چهار پومودورو، یک استراحت طولانی‌تر (۱۵–۳۰ دقیقه) داشته باشید، شمارش تیک‌های خود را صفر کنید، سپس به مرحله ۱ بروید.
پیکربندی (Configuration)
tab(	);
lw(14.0n) lw(28.0n) lw(28.0n).
کلید	مقادیر	پیش‌فرض
format	قالب مورد استفاده در حالت‌های idle، prompt، یا notify	" $icon{ $message\|} "
pomodoro_format	قالب مورد استفاده زمانی که پومودورو در حال اجرا یا متوقف‌شده (paused) است	" $icon $status_icon{ $completed_pomodoros.tally()\|} $time_remaining.duration(hms:true) "
break_format	قالب مورد استفاده زمانی که پومودورو در زمان استراحت است	" $icon $status_icon Break: $time_remaining.duration(hms:true) "
message	پیام هنگام به پایان رسیدن زمان‌سنج	"Pomodoro over! Take a break!"
break_message	پیام هنگام پایان یافتن استراحت	"Break over! Time to work!"
notify_cmd	یک دستور پوسته برای اجرا به عنوان اعلان‌کننده. {msg} با message یا break_message جایگزین خواهد شد.	None
blocking_cmd	آیا notify_cmd مسدودکننده است؟ اگر باشد، بلوک پومودورو تا پیش از پایان یافتن دستور برای ادامه منتظر خواهد ماند. در غیر این صورت، برای ادامه باید روی بلوک کلیک کنید.	false

جانگهدار	مقدار	نوع	پشتیبانی‌شده در
icon	یک آیکون ایستا	Icon	تمام قالب‌ها
status_icon	آیکونی که وضعیت پومودورو را منعکس می‌کند	Icon	pomodoro_format, break_format
message	پیام کنونی	Text	format
time_remaining	زمان باقی‌مانده (به دقیقه)	Duration	pomodoro_format, break_format
completed_pomodoros	تعداد پومودوروهای تکمیل‌شده	Number	pomodoro_format
استفاده از swaynag به‌عنوان اعلان‌گر:
[[block]]
block = "pomodoro"
notify_cmd = "swaynag -m '{msg}'"
blocking_cmd = true
استفاده از notify-send به‌عنوان اعلان‌گر:
[[block]]
block = "pomodoro"
notify_cmd = "notify-send '{msg}'"
blocking_cmd = false
آیکون‌های استفاده‌شده (Icons Used)
• 2
pomodoro
• 2
pomodoro_started
• 2
pomodoro_stopped
• 2
pomodoro_paused
• 2
pomodoro_break
privacy
ناظر حریم خصوصی
پیکربندی (Configuration)
tab(	);
lw(28.5n) lw(20.7n) lw(20.7n).
کلید	مقادیر	پیش‌فرض
driver	پیکربندی یک درایور (به زیر مراجعه کنید).	الزامی
format	رشته قالب‌بندی.	"{ $icon_audio \|}{ $icon_audio_sink \|}{ $icon_video \|}{ $icon_webcam \|}{ $icon_unknown \|}"
format_alt	رشته قالب‌بندی.	"{ $icon_audio $info_audio \|}{ $icon_audio_sink $info_audio_sink \|}{ $icon_video $info_video \|}{ $icon_webcam $info_webcam \|}{ $icon_unknown $info_unknown \|}"

گزینه‌های pipewire (نیازمند فعال بودن قابلیت pipewire)

کلید	مقادیر	الزامی	پیش‌فرض
name	pipewire	بله	ندارد
exclude_output	یک گره خروجی برای نادیده گرفتن، مثال: ["HD Pro Webcam C920"]	خیر	[]
exclude_input	یک گره ورودی برای نادیده گرفتن، مثال: ["openrgb"]	خیر	[]
display	کدام فیلد گره باید به عنوان نام نمایشی استفاده شود، گزینه‌ها: name، description، nickname	خیر	name
tab(	);
lw(9.3n) lw(18.7n) lw(23.3n) lw(18.7n).
کلید	مقادیر	الزامی	پیش‌فرض
name	vl4	بله	ندارد
exclude_device	دستگاهی برای نادیده‌گرفتن، به عنوان مثال: ["/dev/video5"]	خیر	[]
exclude_consumer	فرایندهایی برای نادیده‌گرفتن	خیر	["pipewire", "wireplumber"]

کلیدهای قالب در دسترس

جای‌نگهدار	مقدار	نوع	واحد
icon_{audio,audio_sink,video,webcam,unknown}	یک آیکون ایستا	آیکون	-
info_{audio,audio_sink,video,webcam,unknown}	نگاشت منابعی که در حال مصرف هستند	متن	-

می‌توانید از پسوندهای ذکرشده در بالا برای دریافت موارد زیر استفاده کنید:

پسوند	توضیحات
audio	صدای ضبط‌شده (مثلاً میکروفون)
audio_sink	صدای دریافت‌شده از یک سینک (مثلاً openrgb)
video	ضبط ویدیو (مثلاً ضبط صفحه‌نمایش)
webcam	ضبط وب‌کم
unknown	هر چیز دیگر
tab(	);
lw(15.1n) lw(40.7n) lw(14.2n).
کنش	توضیحات
دکمهٔ پیش‌فرض
T}
toggle_format	جابه‌جایی میان format و format_alt
چپ
T}

مثال (Example)

[[block]]
block = "privacy"
[[block.driver]]
name = "v4l"
[[block.driver]]
name = "pipewire"
exclude_input = ["openrgb"]
display = "nickname"

نمادهای استفاده‌شده (Icons Used)

•: microphone
•: volume
•: xrandr
•: webcam
•: unknown

rofication

تعداد اعلان‌های در انتظار در rofication-daemon

در صورت وجود اعلان‌های بحرانی، از رنگ متفاوتی استفاده می‌شود.

پیکربندی (Configuration)

کلید	مقادیر	پیش‌فرض
interval	نرخ تازه‌سازی بر حسب ثانیه.	1
format	رشته‌ای برای شخصی‌سازی خروجی این بلوک. برای جانگهدارها به بخش زیر مراجعه کنید.	" $icon $num.eng(w:1) "
socket_path	مسیر سوکت برای دیمن rofication. از بسط مسیر مانند ~ پشتیبانی می‌کند.	"/tmp/rofi_notification_daemon"

جانگهدار	مقدار	نوع	واحد
icon	یک نماد ایستا	نماد	-
num	تعداد اعلان‌های در انتظار	عدد	-
[[block]]
block = "rofication"
interval = 1
socket_path = "/tmp/rofi_notification_daemon"
[[block.click]]
button = "left"
cmd = "rofication-gui"
آیکون‌های مورد استفاده
• 2
bell
scratchpad
نشانگر scratchpad
پیکربندی
tab(	);
lw(14.0n) lw(28.0n) lw(28.0n).
کلید	مقادیر	پیش‌فرض
format	رشته‌ای برای سفارشی‌سازی خروجی این بلوک	$icon $count.eng(range:1..) \|

جای‌نگهدار	مقدار	نوع	واحد
icon	یک آیکون ایستا	آیکون	-
count	تعداد پنجره‌ها در scratchpad	عدد	-

مثال

[[block]]
block = "scratchpad"

آیکون‌های مورد استفاده

•: scratchpad

service_status

نمایش وضعیت یک سرویس

در حال حاضر تنها از systemd پشتیبانی می‌شود..SS "پیکربندی (Configuration)"

کلید	مقادیر	پیش‌فرض
driver	کدام سیستم init سرویس را اجرا می‌کند. راه‌اندازهای در دسترس عبارتند از: "systemd"	"systemd"
service	نام سرویس	اجباری
user	در صورت true بودن، وضعیت یک سرویس کاربر به جای یک سرویس سیستم پایش می‌شود.	false
active_format	رشته‌ای برای سفارشی‌سازی خروجی این بلوک. برای جانگهدارهای موجود، به بخش زیر مراجعه کنید.	" $service active "
inactive_format	رشته‌ای برای سفارشی‌سازی خروجی این بلوک. برای جانگهدارهای موجود، به بخش زیر مراجعه کنید.	" $service inactive "
active_state	یک [State] معتبر	[State::Idle]
inactive_state	یک [State] معتبر	[State::Critical]

جانگهدار	مقدار	نوع	واحد
service	نام سرویس	متن	-
مثال با استفاده از یک آیکون:
[[block]]
block = "service_status"
service = "cups"
active_format = " ^icon_tea "
inactive_format = " no ^icon_tea "
مثال برای بازنویسی inactive_state پیش‌فرض:
[[block]]
block = "service_status"
service = "shadow"
active_format = ""
inactive_format = " Integrity of password and group files failed "
inactive_state = "Warning"
sound
سطح صدا
این بلوک میزان بلندی صدا را (مطابق با PulseAudio یا ALSA) نمایش می‌دهد.
برای قطع/وصل صدا کلیک‌راست کنید، و برای تنظیم بلندی صدا پیمایش (اسکرول) نمایید.
نیازمند نصب PulseAudio یا بستهٔ alsa-utils برای ALSA است.
توجه داشته باشید اگر از دستورات PulseAudio (مانند pactl) برای تنظیم صدای خود استفاده می‌کنید، باید راه‌انداز "pulseaudio" (یا "auto") را انتخاب کنید تا تغییرات صدایی که فراتر از ۱۰۰٪ می‌روند را مشاهده نمایید.
پیکربندی
tab(	);
lw(14.0n) lw(28.0n) lw(28.0n).
کلید	مقادیر	پیش‌فرض
driver	"auto"، pipewire، "pulseaudio"، "alsa".	"auto" (ابتدا Pipewire، سپس با جایگزین Pulseaudio و جایگزین ALSA)
format	رشته‌ای برای سفارشی‌سازی خروجی این بلوک. جای‌نگهدارهای در دسترس را در زیر ببینید.	" $icon {$volume.eng(w:2) \|}"
format_alt	در صورت تنظیم، بلوک با هر بار کلیک بین format و format_alt جابه‌جا می‌شود.	None
name	نام دستگاه PulseAudio، یا نام کنترلگر ALSA مطابق با خروجی دستور amixer -D yourdevice scontrols.	PulseAudio: @DEFAULT_SINK@ / ALSA: Master
device	نام دستگاه ALSA، معمولاً در قالب “hw:X” یا “hw:X,Y” که در آن X شماره کارت و Y شماره دستگاه مطابق با خروجی دستور aplay -l است.	default
device_kind	نوع دستگاه PulseAudio: مقدار source یا sink.	"sink"
natural_mapping	هنگام استفاده از راه‌انداز ALSA، مقدار “صدای نگاشته‌شده (mapped volume)” را مطابق با خروجی alsamixer/amixer -M نمایش می‌دهد، که بلندی صدا را از نظر گوش انسان به صورت طبیعی‌تری بازنمایی می‌کند.	false
step_width	درصد افزایش/کاهش بلندی صدا برای دستگاه صوتی انتخاب‌شده در هنگام پیمایش. به‌طور خودکار روی ۵۰ محدود می‌شود.	5
max_vol	حداکثر درصد بلندی صدا که می‌توان از طریق پیمایش تنظیم کرد. توجه داشته باشید اگر توسط برنامهٔ دیگری تغییر کند، همچنان ممکن است فراتر از این مقدار تنظیم شود.	None
show_volume_when_muted	نمایش بلندی صدا حتی اگر در حال حاضر بی‌صدا (mute) باشد.	false
headphones_indicator	تغییر آیکون هنگام وصل بودن هدفون (فقط در pulseaudio)	false
mappings	نگاشت output_name به یک نام دلخواه.	None
mappings_use_regex	امکان تطبیق mappings با استفاده از عبارات باقاعده (regex) به جای برابری سادهٔ رشته‌ای. جایگزینی، عبارات باقاعده را در نظر می‌گیرد و می‌تواند شامل گروه‌های تصاحب (capture groups) باشد.	true
active_port_mappings	نگاشت active_port به یک نام دلخواه. جایگزینی، عبارات باقاعده را در نظر می‌گیرد و می‌تواند شامل گروه‌های تصاحب باشد.	None

جای‌نگهدار	مقدار	نوع	واحد
icon	آیکون بر اساس بلندی صدا	آیکون	-
volume	بلندی صدای فعلی. در صورت بی‌صدا بودن وجود نخواهد داشت.	عدد	%
output_name	نام دستگاه PulseAudio یا ALSA	متن	-
output_description	توضیحات دستگاه PulseAudio؛ در صورتی که هیچ توضیحی در دسترس نباشد، از output_name به عنوان جایگزین استفاده خواهد شد و توسط نگاشت‌ها بازنویسی می‌شود (نگاشت‌ها همچنان از output_name استفاده خواهند کرد)	متن	-
active_port	درگاه فعال (مشابه با اطلاعات بخش Ports در خروجی دستور pactl list cards). اگر توسط driver پشتیبانی نشود یا در active_port_mappings به "" نگاشت شده باشد، غایب خواهد بود.	متن	-
tab(	);
l l.
عملیات	دکمه پیش‌فرض
toggle_format	چپ
toggle_mute	راست
volume_down	چرخ رو به پایین
volume_up	چرخ رو به بالا

مثال‌ها (EXAMPLES)

تغییر عرض گام پیش‌فرض پیمایش به ۳ درصد:

[[block]]
block = "sound"
step_width = 3

تغییر نام خروجی نمایش‌داده‌شده:

[[block]]
block = "sound"
format = " $icon $output_name{ $volume|} "
[block.mappings]
"alsa_output.usb-Harman_Multimedia_JBL_Pebbles_1.0.0-00.analog-stereo" = "Speakers"
"alsa_output.pci-0000_00_1b.0.analog-stereo" = "Headset"

از آنجا که مقدار پیش‌فرض برای کلید device_kind برابر با sink است، برای نمایش بلوک microphone باید از مقدار source استفاده کنید:

[[block]]
block = "sound"
driver = "pulseaudio"
device_kind = "source"

نمایش هشدار در بلوک در صورتی که میکروفون از درگاه نادرست استفاده کند:

[[block]]
block = "sound"
driver = "pulseaudio"
device_kind = "source"
format = " $icon { $volume|} {$active_port |}"
[block.active_port_mappings]
"analog-input-rear-mic" = "" # نگاشت به یک رشته خالی موجب عدم وجود `$active_port` می‌شود
"analog-input-front-mic" = "ERR!"

آیکون‌های مورد استفاده (Icons Used)

•: microphone_muted (به صورت توالی)
•: microphone (به صورت توالی)
•: volume_muted (به صورت توالی)
•: volume (به صورت توالی)
•: headphones.SS speedtest سرعت‌های پینگ، دانلود و آپلود

این بلوک نیازمند speedtest-cli است.

پیکربندی (Configuration)

کلید	مقادیر	پیش‌فرض
format	رشته‌ای برای سفارشی‌سازی خروجی این بلوک. برای جای‌نگه‌دارهای موجود به بخش زیر مراجعه کنید.	" ^icon_ping $ping ^icon_net_down $speed_down ^icon_net_up $speed_up "
interval	بازه به‌روزرسانی بر حسب ثانیه	1800

جای‌نگه‌دار	مقدار	نوع	واحد
ping	تأخیر پینگ	عدد	ثانیه
speed_down	سرعت دانلود	عدد	بیت بر ثانیه
speed_up	سرعت آپلود	عدد	بیت بر ثانیه

مثال (Example)

نمایش تنها پینگ (همراه با یک آیکون)

[[block]]
block = "speedtest"
interval = 1800
format = " ^icon_ping $ping "

مخفی کردن پینگ و نمایش سرعت بر حسب بایت بر ثانیه هر کدام با استفاده از ۴ نویسه (بدون آیکون)

[[block]]
block = "speedtest"
interval = 1800
format = " $speed_down.eng(w:4,u:B) $speed_up(w:4,u:B) "

•

ping

•

net_down

•

net_up

taskwarrior

تعداد وظایف از فهرست taskwarrior

کلیک راست ماوس روی آیکون، نمای بلوک را به‌نوبت بین فیلترهای کاربر جابه‌جا می‌کند.

پیکربندی (Configuration)

کلید	مقادیر	پیش‌فرض
interval	بازه زمانی به‌روزرسانی بر حسب ثانیه	600 (۱۰ دقیقه)
warning_threshold	آستانه وظایف در انتظار (یا آغازشده) که با رسیدن به آن، بلوک به وضعیت هشدار (warning) درمی‌آید	10
critical_threshold	آستانه وظایف در انتظار (یا آغازشده) که با رسیدن به آن، بلوک به وضعیت بحرانی (critical) درمی‌آید	20
filters	فهرستی از جدول‌ها برای توصیف فیلترها (زیر را ببینید)	[{name = "pending", filter = "-COMPLETED -DELETED"}]
format	رشته‌ای برای سفارشی‌سازی خروجی این بلوک. برای متغیرهای جایگزین موجود، زیر را ببینید.	" $icon $count.eng(w:1) "
format_singular	مشابه format اما برای زمانی که دقیقاً یک وظیفه در انتظار است.	" $icon $count.eng(w:1) "
format_everything_done	مشابه format اما برای زمانی که همه وظایف تکمیل شده‌اند.	" $icon $count.eng(w:1) "
data_location	دایرکتوری‌ای که taskwarrior فایل‌های داده خود را در آن ذخیره می‌کند. از بسط مسیر مانند ~ پشتیبانی می‌کند.	"~/.task"
tab(	);
lw(14.0n) lw(28.0n) lw(28.0n).
کلید	مقادیر	پیش‌فرض
name	نام فیلتر
filter	معیارهایی را تعیین می‌کند که باید برقرار باشند تا یک وظیفه در این فیلتر شمارش شود
config_override	آرایه‌ای شامل بازنویسی‌های پیکربندی؛ مناسب برای تعیین صریح context یا سایر متغیرهای پیکربندی	[]

جای‌نگه‌دارها (Placeholders)

جای‌نگه‌دار	مقدار	نوع	واحد
icon	یک آیکون ایستا	آیکون	-
count	تعداد وظایف منطبق با فیلتر فعلی	عدد	-
filter_name	نام فیلتر فعلی	متن	-

کنش‌ها (Actions)

کنش	دکمه پیش‌فرض
next_filter	راست (Right)
در این مثال، اگر count صفر باشد، بلوک پنهان خواهد شد.
[[block]]
block = "taskwarrior"
interval = 60
format = " $icon count.eng(w:1) tasks "
format_singular = " $icon 1 task "
format_everything_done = ""
warning_threshold = 10
critical_threshold = 20
[[block.filters]]
name = "today"
filter = "+PENDING +OVERDUE or +DUETODAY"
[[block.filters]]
name = "some-project"
filter = "project:some-project +PENDING"
config_override = ["rc.context:none"]
"آیکون‌های استفاده‌شده (Icons Used)"
• 2
tasks
tea_timer
زمان‌سنج
"پیکربندی (Configuration)"
tab(	);
lw(14.0n) lw(28.0n) lw(28.0n).
کلید	مقادیر
پیش‌فرض
T}
format	رشته‌ای برای سفارشی‌سازی خروجی این بلوک. برای جای‌نگهدارهای موجود، بخش زیر را ببینید.
" $icon {$time.duration(hms:true) \|}"
T}
increment	تعداد ثانیه‌هایی که با هر بار کلیک روی بلوک اضافه می‌شود.
30
T}
done_cmd	دستوری برای اجرا در sh پس از پایان زمان‌سنج.
None
T}

جای‌نگهدار	مقدار	نوع	واحد
icon	یک آیکون ایستا	Icon	-
time	زمان باقی‌مانده زمان‌سنج	Duration	-
hours منسوخ‌شده	ساعت‌های باقی‌مانده زمان‌سنج	Text	h
minutes منسوخ‌شده	دقیقه‌های باقی‌مانده زمان‌سنج	Text	mn
seconds منسوخ‌شده	ثانیه‌های باقی‌مانده زمان‌سنج	Text	s

هنگامی که زمان‌سنج غیرفعال باشد، مقادیر time، hours، minutes و seconds مقداردهی نشده‌اند.

متغیرهای hours، minutes و seconds به نفع time منسوخ شده‌اند.

عملیات	دکمه پیش‌فرض
increment	کلیک چپ / چرخ رو به بالا (Left / Wheel Up)
decrement	چرخ رو به پایین (Wheel Down)
reset	کلیک راست (Right)
[[block]]
block = "tea_timer"
format = " $icon {$minutes:$seconds \|}"
done_cmd = "notify-send 'Timer Finished'"
نمادهای استفاده‌شده (ICONS USED)
• 2
tea
دما (temperature)
دمای سیستم
این بلوک دمای سیستم را بر اساس کتابخانهٔ libsensors نمایش می‌دهد.
این بلوک دارای دو حالت است: «جمع‌شده» (“collapsed”) که تنها از رنگ به عنوان شاخص استفاده می‌کند، و «گسترش‌یافته» (“expanded”) که محتوای رشتهٔ format را نمایش می‌دهد.
دمای میانگین، کمینه و بیشینه با استفاده از تمام حسگرهای نمایش‌داده‌شده توسط sensors محاسبه می‌شوند، یا می‌توانند به صورت اختیاری با chip و inputs فیلتر شوند.
نیازمند libsensors و ماژول‌های هستهٔ مناسب برای سخت‌افزار شما است.
برای مشاهدهٔ فهرست تراشه‌ها و ورودی‌های موجود، دستور sensors را اجرا کنید.
توجه داشته باشید که رنگ بلوک همواره بر اساس بیشینهٔ دما در تمام حسگرها تعیین می‌شود، نه میانگین آن.
در صورتی که حسگری با رفتار نادرست دارید، ممکن است نیاز باشد این نکته را مد نظر داشته باشید.
پیکربندی (CONFIGURATION)
tab(	);
lw(14.0n) lw(28.0n) lw(28.0n).
کلید	مقادیر
پیش‌فرض
T}
format	رشته‌ای برای سفارشی‌سازی خروجی این بلوک. برای جای‌نگهدارهای موجود به بخش زیر مراجعه کنید
" $icon $average avg, $max max "
T}
format_alt	در صورت تنظیم، بلوک با هر کلیک بین format و format_alt جابه‌جا می‌شود
None
T}
interval	بازهٔ به‌روزرسانی بر حسب ثانیه
5
T}
scale	یکی از مقادیر "celsius" یا "fahrenheit"
"celsius"
T}
good	بیشینهٔ دما برای تنظیم وضعیت به good
20 °C (68 °F)
T}
idle	بیشینهٔ دما برای تنظیم وضعیت به idle
45 °C (113 °F)
T}
info	بیشینهٔ دما برای تنظیم وضعیت به info
60 °C (140 °F)
T}
warning	بیشینهٔ دما برای تنظیم وضعیت به warning. فراتر از این دما، وضعیت روی critical تنظیم می‌شود
80 °C (176 °F)
T}
chip	نتایج را به نام یک تراشهٔ خاص محدود می‌کند. می‌توان از * به عنوان نویسهٔ عام (wildcard) استفاده کرد.
None
T}
inputs	نتایج را به ورودی‌های مجزای گزارش‌شده توسط هر تراشه محدود می‌کند.
None
T}

کنش	توضیحات	دکمهٔ پیش‌فرض
toggle_format	جابه‌جایی بین format و format_alt	Left

جای‌نگهدار	مقدار	نوع	واحد
min	کمینهٔ دما میان تمام ورودی‌ها	عدد	درجه
average	میانگین دما میان تمام ورودی‌ها	عدد	درجه
max	بیشینهٔ دما میان تمام ورودی‌ها	عدد	درجه
توجه داشته باشید که وقتی بلوک جمع شده باشد، هیچ جانگهدارنده‌ای ارائه نمی‌شود.
مثال (Example)
[[block]]
block = "temperature"
format = " $icon $max max "
format_alt = " $icon $min min, $max max, $average avg "
interval = 10
chip = "-isa-"
آیکون‌های مورد استفاده (Icons Used)
• 2
thermometer
time
زمان فعلی.
پیکربندی (Configuration)
tab(	);
lw(28.5n) lw(20.7n) lw(20.7n).
کلید	مقادیر	پیش‌فرض
format	رشته قالب‌بندی. برای مشاهده همه گزینه‌ها به https://docs.rs/chrono/0.3.0/chrono/format/strftime/index.html#specifiers مستندات chrono مراجعه کنید.	" $icon $timestamp.datetime() "
interval	بازه به‌روزرسانی به ثانیه	10
timezone	یک مشخص‌کننده منطقه زمانی (مانند “Europe/Lisbon”)	منطقه زمانی محلی

جانگهدارنده	مقدار	نوع	واحد
icon	یک آیکون ایستا	Icon	-
timestamp	زمان فعلی	Datetime	-

کنش	دکمه پیش‌فرض
next_timezone	چپ
prev_timezone	راست
[[block]]
block = "time"
interval = 60
[block.format]
full = " $icon $timestamp.datetime(f:'%a %Y-%m-%d %R %Z', l:fr_BE) "
short = " $icon $timestamp.datetime(f:%R) "
تقویم‌های غیرمیلادی (Non Gregorian calendars)
می‌توانید با افزودن شناسهٔ تقویم در رشتهٔ locale، از تقویم‌هایی به‌جز تقویم میلادی
استفاده کنید.
هنگام استفاده از این قابلیت، نمی‌توانید از رشتهٔ قالب به سبک chrono استفاده نمایید
و باید از یکی از گزینه‌های ارائه‌شده توسط کریت icu4x استفاده کنید:
short، medium، long، full.
تنها با استفاده از قابلیت icu_calendar در دسترس است.
مثال (Example)
[[block]]
block = "time"
interval = 60
format = "$timestamp.datetime(locale:'fa_IR-u-ca-persian', f:'full')"
آیکون‌های استفاده‌شده (Icons Used)
• 2
time
toggle
یک بلوک ضامن (Toggle)
می‌توانید دستورهایی را برای غیرفعال کردن ضامن (command_off)
و فعال کردن آن (command_on) تعیین کنید.
اگر این دستورها با وضعیتی غیر از صفر خارج شوند، وضعیت ضامن تغییر نخواهد کرد
و حالت بلوک به critical تغییر می‌یابد تا یک هشدار بصری از بروز خطا
ارائه دهد.
همچنین باید دستوری را برای تعیین وضعیت ضامن مشخص کنید (command_state).
هنگامی که این دستور هیچ خروجی نداشته باشد، ضامن غیرفعال است؛ در غیر این صورت
فعال خواهد بود.
با مشخص کردن ویژگی interval می‌توانید تعیین کنید که command_state به‌طور مداوم
اجرا شود.
برای اجرای این دستورها، شل مشخص‌شده در متغیر محیطی $SHELL استفاده می‌شود.
اگر چنین متغیری تعریف نشده باشد، sh به کار می‌رود.
پیکربندی (Configuration)
tab(	);
lw(14.0n) lw(28.0n) lw(28.0n).
کلید	مقادیر
پیش‌فرض
T}
format	رشته‌ای برای شخصی‌سازی خروجی این بلوک. برای جای‌بان‌های در دسترس، بخش زیر را ببینید
" $icon "
T}
command_on	دستور شل برای فعال کردن ضامن
الزامی
T}
command_off	دستور شل برای غیرفعال کردن ضامن
الزامی
T}
command_state	دستور شل برای تعیین وضعیت. خروجی خالی => خیر، در غیر این صورت => بله.
الزامی
T}
icon_on	جایگزین آیکون برای دکمهٔ ضامن در وضعیت روشن
"toggle_on"
T}
icon_off	جایگزین آیکون برای دکمهٔ ضامن در وضعیت خاموش
"toggle_off"
T}
interval	فاصلهٔ زمانی به‌روزرسانی بر حسب ثانیه. در صورت عدم تنظیم، command_state تنها با کلیک اجرا خواهد شد.
ندارد
T}
state_on	[State] (رنگ) این بلوک در وضعیت روشن
[idle][State::Idle]
T}
state_off	[State] (رنگ) این بلوک در وضعیت خاموش
[idle][State::Idle]
T}

جای‌بان	مقدار	نوع	واحد
icon	آیکون بر اساس وضعیت ضامن	Icon	-

عمل	دکمهٔ پیش‌فرض
toggle	چپ (Left)
از این پیکربندی می‌توان برای تغییر وضعیت یک نمایشگر خارجی استفاده کرد:
[[block]]
block = "toggle"
format = " $icon 4k "
command_state = "xrandr \| grep 'DP1 connected 38' \| grep -v eDP1";
command_on = "~/.screenlayout/4kmon_default.sh"
command_off = "~/.screenlayout/builtin.sh"
interval = 5
state_on = "good"
state_off = "warning"
"آیکون‌های استفاده‌شده"
• 2
toggle_off
• 2
toggle_on
uptime
مدت‌زمان بالا بودن سیستم
این بلوک مدت‌زمان بالا بودن سیستم را بر حسب دو واحد بزرگ‌تر نمایش می‌دهد؛ بنابراین دقیقه و ثانیه، یا ساعت و دقیقه، یا روز و ساعت، یا هفته و روز.
"پیکربندی"
tab(	);
lw(16.4n) lw(41.7n) lw(11.9n).
کلید	مقادیر
پیش‌فرض
T}
format	رشته‌ای برای سفارشی‌سازی خروجی این بلوک. برای مشاهدهٔ متغیرهای جایگزین موجود به بخش زیر مراجعه کنید
" $icon $uptime "
T}
interval	بازهٔ زمانی به‌روزرسانی بر حسب ثانیه
60
T}

متغیر جایگزین	مقدار	نوع	واحد
icon	یک آیکون ایستا	آیکون	-
text منسوخ‌شده	مدت‌زمان فعلی بالا بودن سیستم	متن	-
uptime	مدت‌زمان فعلی بالا بودن سیستم	مدت‌زمان	-

text منسوخ شده و uptime جایگزین آن شده است..SS مثال

[[block]]
block = "uptime"
interval = 3600 # به‌روزرسانی در هر ساعت

آیکون‌های استفاده‌شده

•: uptime

vpn

وضعیت فعلی اتصال برای شبکه‌های VPN را نمایش می‌دهد.

این ویجت با کلیک چپ، وضعیت اتصال را تغییر می‌دهد (قطع/وصل می‌کند).

پیکربندی

کلید	مقادیر	پیش‌فرض
driver	مشخص می‌کند کدام vpn باید استفاده شود. راه‌اندازهای موجود عبارتند از: "nordvpn"، "mullvad"، "tailscale"	"nordvpn"
interval	بازه زمانی به‌روزرسانی بر حسب ثانیه.	10
format_connected	رشته‌ای برای سفارشی‌سازی خروجی در صورت متصل بودن شبکه. برای جای‌نگهدارهای موجود به بخش زیر مراجعه کنید.	" VPN: $icon "
format_disconnected	رشته‌ای برای سفارشی‌سازی خروجی در صورت قطع بودن شبکه. برای جای‌نگهدارهای موجود به بخش زیر مراجعه کنید.	" VPN: $icon "
state_connected	وضعیت ویجت در صورتی که شبکه vpn متصل باشد.	info
state_disconnected	وضعیت ویجت در صورتی که شبکه vpn قطع باشد.	idle

جای‌نگهدار	مقدار	نوع	واحد
icon	یک آیکون ایستا	آیکون	-
country	کشوری که در حال حاضر به آن متصل است	متن	-
flag	پرچم ویژه کشور (وابسته به قلمی که از آنها پشتیبانی کند)	متن	-
profile	پیکربندی نمایه در حال حاضر انتخاب‌شده (tailnet)	متن	-
error	پیام خطا در صورت وجود	متن	-

عمل	دکمه پیش‌فرض	توضیحات
toggle	Left	اتصال شبکه vpn را تغییر وضعیت می‌دهد (قطع/وصل می‌کند)
Mullvad
در پشت صحنه، راه‌انداز mullvad از باینری خط فرمان mullvad استفاده می‌کند.
برای اینکه این مورد به درستی کار کند، فایل باینری باید قابل اجرا باشد و دیمن mullvad در حال اجرا باشد.
nordvpn
در پشت صحنه، راه‌انداز nordvpn از باینری خط فرمان nordvpn استفاده می‌کند.
برای اینکه این مورد به درستی کار کند، فایل باینری باید بدون امتیازات ریشه (root) قابل اجرا باشد.
Tailscale
در پشت صحنه، راه‌انداز tailscale از باینری خط فرمان tailscale استفاده می‌کند.
برای اینکه این مورد به درستی کار کند، دیمن tailscale باید در حال اجرا باشد و کاربر باید به عنوان اپراتور پیکربندی شده باشد:
sudo tailscale set --operator=$USER
Cloudflare WARP
در پشت صحنه، راه‌انداز WARP از باینری خط فرمان warp-cli استفاده می‌کند.
تنها اطمینان حاصل کنید که فایل باینری بدون امتیازات ریشه (root) قابل اجرا باشد.
"مثال (Example)"
وضعیت فعلی شبکه vpn را نمایش می‌دهد:
[[block]]
block = "vpn"
driver = "nordvpn"
interval = 10
format_connected = "VPN: $icon "
format_disconnected = "VPN: $icon "
state_connected = "good"
state_disconnected = "warning"
مقادیر ممکن برای state_connected و
state_disconnected:
warning
critical
good
info
idle
"آیکون‌های استفاده‌شده (Icons Used)"
• 2
net_vpn
• 2
net_wired
• 2
net_down
• 2
پرچم‌های کد کشور (در صورت پشتیبانی توسط قلم)
پرچم‌ها: آن‌ها آیکون نیستند، بلکه نشانه‌های یونیکد هستند.
به قلمی نیاز خواهید داشت که شامل آن‌ها باشد.
آزمایش‌شده با:
https://www.babelstone.co.uk/Fonts/Flags.html

watson
آمار Watson

http://tailordev.github.io/Watson
Watson

یک برنامه ساده خط فرمان (CLI) برای ردیابی زمان است.
این بلوک نام پروژه فعال فعلی شما، برچسب‌ها و در صورت تمایل زمان ثبت‌شده را نشان می‌دهد.
کلیک کردن روی ویجت، متغیر show_time را به صورت پویا تغییر وضعیت می‌دهد.
"پیکربندی (Configuration)"
tab(	);
lw(14.0n) lw(28.0n) lw(28.0n).
کلید	مقادیر	پیش‌فرض
format	رشته‌ای برای سفارشی‌سازی خروجی این بلوک. برای متغیرهای جایگزین موجود، به پایین مراجعه کنید	" $text \|"
show_time	نمایش یا عدم نمایش زمان ثبت‌شده.	false
state_path	مسیر فایل وضعیت Watson. از بسط مسیر مانند ~ پشتیبانی می‌کند.	$XDG_CONFIG_HOME/watson/state
interval	فاصله زمانی به‌روزرسانی، به ثانیه.	60

متغیر جایگزین	مقدار	نوع	واحد
text	فعالیت فعلی	متن	-

عملیات	توضیحات	دکمه پیش‌فرض
toggle_show_time	تغییر وضعیت مقدار show_time	چپ
[[block]]
block = "watson"
show_time = true
state_path = "~/.config/watson/state"
"کارهای آینده (TODO)"
• 2
گسترش قابلیت‌ها: شروع / توقف watson با استفاده از این بلوک
weather
آب‌وهوای کنونی
این بلوک، اطلاعات آب‌وهوا و دمای محلی را نمایش می‌دهد.
برای استفاده از این بلوک، به دسترسی به یک سرویس API آب‌وهوای
پشتیبانی‌شده نیاز خواهید داشت.
در زمان نگارش این مستند، OpenWeatherMap، met.no و US National
Weather Service پشتیبانی می‌شوند.
پیکربندی این بلوک نیازمند پیکربندی یک سرویس آب‌وهوا است که ممکن است
به کلیدهای API و پارامترهای دیگر نیاز داشته باشد.
در صورت استفاده از ویژگی autolocate، بازه به‌روزرسانی autolocate
را به گونه‌ای تنظیم کنید که از محدودیت روزانه ۱۰۰۰ درخواست رایگان ipapi.co
فراتر نروید.
یا از autolocate_interval = "once" استفاده کنید تا تنها هنگام
مقداردهی اولیه اجرا شود.
"پیکربندی (Configuration)"
tab(	);
lw(14.0n) lw(28.0n) lw(28.0n).
کلید	مقادیر	پیش‌فرض
service	پیکربندی یک سرویس آب‌وهوا (پایین را ببینید).	الزامی
format	رشته‌ای برای سفارشی‌سازی خروجی این بلوک. برای جای‌نماهای موجود به بخش زیر مراجعه کنید. ممکن است نیاز به گریز دادن متن باشد؛ به Escaping Text مراجعه کنید.	" $icon $weather $temp "
format_alt	در صورت تنظیم، بلوک با هر بار کلیک بین format و format_alt جابه‌جا خواهد شد.	None
interval	بازه به‌روزرسانی بر حسب ثانیه.	600
autolocate	موقعیت مکانی شما را با استفاده از سرویس مکان‌یابی IP در ipapi.co دریافت می‌کند (نیازی به کلید API نیست). اگر فراخوانی API با شکست مواجه شود، بلوک به پیکربندی مکان اختصاصی سرویس بازمی‌گردد.	false
autolocate_interval	بازه به‌روزرسانی برای autolocate بر حسب ثانیه یا “once”	interval
برای استفاده از این سرویس به یک کلید API (رایگان) نیاز خواهید داشت.
tab(	);
lw(9.3n) lw(18.7n) lw(23.3n) lw(18.7n).
کلید	مقادیر	ضروری
پیش‌فرض
T}
name	openweathermap.	بله
ندارد
T}
api_key	کلید API حساب OpenWeatherMap شما.	بله
ندارد
T}
coordinates	مختصات عرض و طول جغرافیایی GPS به‌صورت یک چندتایی (tuple)، مانند: ["39.2362","9.3317"]	بله*
ندارد
T}
city_id	شناسه OpenWeatherMap برای شهر. (منسوخ‌شده)	بله*
ندارد
T}
place	پرس‌وجوی جستجوی OpenWeatherMap براساس “By {city name},{state code},{country code}”. مشاهده در https://openweathermap.org/api/geocoding-api#direct_name اینجا . یک فراخوانی API اضافی مصرف می‌کند	بله*
ندارد
T}
zip	پرس‌وجوی جستجوی OpenWeatherMap براساس “By {zip code},{country code}”. مشاهده در https://openweathermap.org/api/geocoding-api#direct_zip اینجا . یک فراخوانی API اضافی مصرف می‌کند	بله*
ندارد
T}
units	یا "metric" یا "imperial".	خیر
"metric"
T}
lang	کد زبان. مشاهده در https://openweathermap.org/current#multi اینجا . در حال حاضر فقط بر کلید weather_verbose اثر می‌گذارد.	خیر
"en"
T}
forecast_hours	چند ساعت باید پیش‌بینی شود (باید مضاربی از ۳ ساعت باشد، حداکثر ۱۲۰ ساعت)	خیر
12
T}

ارائه یکی از گزینه‌های coordinates، city_id، place یا zip الزامی است. اگر بیش از یکی مشخص شده باشد، coordinates نسبت به city_id اولویت دارد، که خود نسبت به place و آن نیز نسبت به zip تقدم دارد.

گزینه‌های api_key، city_id، place، zip را می‌توان در فایل پیکربندی حذف کرد؛ در این صورت باید مقدار آن‌ها از طریق متغیرهای محیطی OPENWEATHERMAP_API_KEY، OPENWEATHERMAP_CITY_ID، OPENWEATHERMAP_PLACE و OPENWEATHERMAP_ZIP تعیین شود.

پیش‌بینی‌ها فقط در صورتی دریافت می‌شوند که forecast_hours > 0 باشد و ساختار قالب شامل کلیدهای مربوط به پیش‌بینی آب‌وهوا باشد..SS گزینه‌های met.no

کلید	مقادیر	الزامی	پیش‌فرض
name	metno.	بله	ندارد
coordinates	مختصات عرض و طول جغرافیایی GPS به صورت یک چندتایی، به عنوان مثال: ["39.2362","9.3317"]	الزامی در صورت autolocate = false	ندارد
lang	کد زبان: en، nn یا nb	خیر	en
altitude	ارتفاع زمین از سطح دریا بر حسب متر	خیر	تخمین‌زده‌شده توسط سرور
forecast_hours	تعداد ساعاتی که باید پیش‌بینی شوند	خیر	12

سرویس Met.no از نام مکان پشتیبانی نمی‌کند، اما اگر autolocate فعال باشد، مقدار شهر در autolocate استفاده خواهد شد.

گزینه‌های US National Weather Service

کلید	مقادیر	الزامی	پیش‌فرض
name	nws.	بله	ندارد
coordinates	مختصات عرض و طول جغرافیایی GPS به صورت یک چندتایی، به عنوان مثال: ["39.2362","9.3317"]	الزامی در صورت autolocate = false	ندارد
forecast_hours	تعداد ساعاتی که باید پیش‌بینی شوند	خیر	12
units	یا "metric" یا "imperial".	خیر	"metric"

پیش‌بینی‌ها آمار را از هر ساعت بین زمان فعلی و مقدار forecast_hours جمع‌آوری می‌کنند و وضعیت پیش‌بینی‌شده آب‌وهوا را برای تعداد ساعات تعیین‌شده در آینده ارائه می‌دهند..SS کلیدهای قالب در دسترس

کلید	مقدار	نوع	واحد
location	نام مکان (قالب دقیق به سرویس بستگی دارد)	متن	-
icon{,_ffin}	شمایل نمایانگر وضعیت آب‌وهوا	شمایل	-
weather{,_ffin}	توضیح متنی کوتاه از آب‌وهوا، مانند “Raining”	متن	-
weather_verbose{,_ffin}	توضیح متنی مفصل از آب‌وهوا، مانند “overcast clouds”	متن	-
temp{,_{favg,fmin,fmax,ffin}}	دما	عدد	درجه
apparent{,_{favg,fmin,fmax,ffin}}	دمای ظاهری استرالیایی	عدد	درجه
humidity{,_{favg,fmin,fmax,ffin}}	رطوبت	عدد	%
wind{,_{favg,fmin,fmax,ffin}}	سرعت باد	عدد	-
wind_kmh{,_{favg,fmin,fmax,ffin}}	سرعت باد. سرعت باد بر حسب کیلومتر بر ساعت	عدد	-
direction{,_{favg,fmin,fmax,ffin}}	جهت باد، مانند “NE”	متن	-
sunrise	زمان طلوع خورشید (ممکن است در روز قطبی یا شب قطبی موجود نباشد)[3]	تاریخ و زمان	-
sunset	زمان غروب خورشید (ممکن است در روز قطبی یا شب قطبی موجود نباشد)[4]	تاریخ و زمان	-

می‌توانید از پسوندهای ذکرشده در بالا برای دریافت موارد زیر استفاده کنید:

پسوند	توضیحات
هیچ‌کدام	آب‌وهوای کنونی
_favg	مقدار میانگین پیش‌بینی
_fmin	مقدار کمینه پیش‌بینی
_fmax	مقدار بیشینه پیش‌بینی
_ffin	مقدار نهایی پیش‌بینی

کنش	توضیحات	دکمه پیش‌فرض
toggle_format	جابه‌جایی میان format و format_alt	چپ
نمایش وضعیت دقیق آب‌وهوا در سان‌فرانسیسکو از طریق سرویس OpenWeatherMap:
[[block]]
block = "weather"
format = " $icon $weather ($location) $temp, $wind m/s $direction "
format_alt = " $icon_ffin Forecast (9 hour avg) {$temp_favg ({$temp_fmin}-{$temp_fmax})\|Unavailable} "
[block.service]
name = "openweathermap"
api_key = "XXX"
city_id = "5398563"
units = "metric"
forecast_hours = 9
نمایش زمان طلوع و غروب خورشید در null island
[[block]]
block = "weather"
format = "up $sunrise.datetime(f:'%R') down $sunset.datetime(f:'%R')"
[block.service]
name = "metno"
coordinates = ["0", "0"]
"آیکون‌های استفاده‌شده (USED ICONS)"
• 2
weather_sun (هنگامی که وضعیت آب‌وهوا در طول روز “Clear” گزارش شود)
• 2
weather_moon (هنگامی که وضعیت آب‌وهوا در شب “Clear” گزارش شود)
• 2
weather_clouds (هنگامی که وضعیت آب‌وهوا در طول روز “Clouds” گزارش شود)
• 2
weather_clouds_night (هنگامی که وضعیت آب‌وهوا در شب “Clouds” گزارش شود)
• 2
weather_fog (هنگامی که وضعیت آب‌وهوا در طول روز “Fog” یا “Mist” گزارش شود)
• 2
weather_fog_night (هنگامی که وضعیت آب‌وهوا در شب “Fog” یا “Mist” گزارش شود)
• 2
weather_rain (هنگامی که وضعیت آب‌وهوا در طول روز “Rain” یا “Drizzle” گزارش شود)
• 2
weather_rain_night (هنگامی که وضعیت آب‌وهوا در شب “Rain” یا “Drizzle” گزارش شود)
• 2
weather_snow (هنگامی که وضعیت آب‌وهوا “Snow” گزارش شود)
• 2
weather_thunder (هنگامی که وضعیت آب‌وهوا در طول روز “Thunderstorm” گزارش شود)
• 2
weather_thunder_night (هنگامی که وضعیت آب‌وهوا در شب “Thunderstorm” گزارش شود)
xrandr
اطلاعات صفحه نمایش X11
اطلاعات صفحه نمایش X11 (نام، روشنایی، وضوح تصویر، نرخ نوسازی).
با یک کلیک می‌توانید بین نمایشگرهای فعال خود جابه‌جا شوید و با چرخاندن چرخ ماوس به بالا یا پایین، روشنایی نمایشگرهای انتخاب‌شده را تنظیم کنید.
در رابطه با کنترل روشنایی، xrandr روشنایی نمایشگر را به جای تغییر سخت‌افزاری با استفاده از گاما تغییر می‌دهد؛ بنابراین اگر این رفتار مطلوب نیست، استفاده از بلوک backlight را به عنوان جایگزین در نظر بگیرید.
نکته: برخی کاربران گزارش داده‌اند که هنگام استفاده از این بلوک با مشکلاتی (برای نمونه
https://github.com/greshake/i3status-rust/issues/274
اینجا

و
https://github.com/greshake/i3status-rust/issues/668
اینجا

مواجه شده‌اند.
علت این مسئله در حال حاضر ناشناخته است، با این حال تنظیم یک بازه به‌روزرسانی طولانی‌تر ممکن است کمک‌کننده باشد..SS "پیکربندی (Configuration)"
tab(	);
lw(14.0n) lw(28.0n) lw(28.0n).
کلید	مقادیر	پیش‌فرض
format	رشته‌ای برای سفارشی‌سازی خروجی این بلوک. برای جانگهدارنده‌های موجود به بخش زیر مراجعه کنید.	" $icon $display $brightness_icon $brightness "
step_width	گامی که روشنایی بر اساس آن برای صفحه نمایش انتخاب‌شده افزایش/کاهش می‌یابد (هنگامی که بیشتر از ۵۰ باشد، به ۵۰ محدود می‌شود).	5
interval	بازه زمانی به‌روزرسانی بر حسب ثانیه.	5
invert_icons	معکوس کردن ترتیب آیکون‌ها؛ در صورتی که ایموجی‌های رنگی دارید مفید است	false

جانگهدارنده	مقدار	نوع	واحد
icon	یک آیکون ایستا	آیکون	-
display	نام نمایشگر	متن	-
brightness	روشنایی نمایشگر	عدد	%
brightness_icon	یک آیکون ایستا	آیکون	-
resolution	تفکیک‌پذیری نمایشگر	متن	-
res_icon	یک آیکون ایستا	آیکون	-
refresh_rate	نرخ نوسازی نمایشگر	عدد	هرتز

عملیات	دکمه پیش‌فرض
cycle_outputs	چپ
brightness_up	چرخ به بالا
brightness_down	چرخ به پایین
[[block]]
block = "xrandr"
format = " $icon $brightness $resolution $refresh_rate "
"آیکون‌های مورد استفاده"
• 2
xrandr
• 2
backlight
• 2
resolution
"نکات (NOTES)"
[1]
هنگام استفاده از notification_count با درایور dunst، از dunst > 1.9.0 استفاده کنید.
[2]
متغیر history_count در SwayNC معادل notification_count است.
[3]
در روزهای قطبی و شب‌های قطبی، ممکن است طلوع یا غروب خورشید در یک روز مشخص رخ ندهد و بنابراین مقدار متناظر آن موجود نباشد.
این رفتار به سرویس هواشناسی مورد استفاده بستگی دارد.
برای met.no و nws، هم طلوع و هم غروب خورشید در روزها و شب‌های قطبی وجود نخواهد داشت، اما OpenWeatherMap زمان یکسانی را برای هر دو طلوع و غروب خورشید نمایش می‌دهد.
[4]
در روزهای قطبی و شب‌های قطبی، ممکن است طلوع یا غروب خورشید در یک روز مشخص رخ ندهد و بنابراین مقدار متناظر آن موجود نباشد.
این رفتار به سرویس هواشناسی مورد استفاده بستگی دارد.
برای met.no و nws، هم طلوع و هم غروب خورشید در روزها و شب‌های قطبی وجود نخواهد داشت، اما OpenWeatherMap زمان یکسانی را برای هر دو طلوع و غروب خورشید نمایش می‌دهد.
"تم‌ها (THEMES)"
"انتخاب تم و مجموعه آیکون"
برای استفاده از تم یا مجموعه آیکونی غیر از پیش‌فرض، آن‌ها را مانند زیر به فایل پیکربندی خود اضافه کنید:
[theme]
theme = "solarized-dark"
[icons]
icons = "awesome6"
هر دوی تم و مجموعه آیکون را می‌توان از یک فایل جداگانه بارگذاری کرد.
[theme]
theme = "<file>"
[icons]
icons = "<file>"
که در آن <file> می‌تواند یک نام فایل یا یک مسیر کامل باشد و با این ترتیب بررسی خواهد شد:
"1." 3
اگر مسیر کامل و مطلق داده شده باشد، همان‌طور که هست استفاده می‌شود:
/home/foo/custom_theme.toml
"2." 3
اگر نام فایل داده شده باشد، برای نمونه “custom_theme.toml”، ابتدا
$XDG_CONFIG_HOME/i3status-rust/themes
بررسی می‌شود
"3." 3
سپس در $XDG_DATA_HOME/i3status-rust/themes جستجو می‌شود
"4." 3
در غیر این صورت در /usr/share/i3status-rust/themes جستجو خواهد شد
نکات: - در مورد مجموعه‌های آیکون، فایل باید به‌جای themes در زیردایرکتوری
icons قرار داشته باشد.
- می‌توانید هنگام مشخص کردن پارامترهای file از پسوند .toml صرف‌نظر کنید.
- تمام تم‌های از پیش تعریف‌شده به‌صورت فایل ارائه شده‌اند، بنابراین می‌توانید از آن‌ها به‌عنوان نمونه‌هایی برای چگونگی نوشتن تم‌ها/مجموعه‌های آیکون خود استفاده کنید.
"تم‌های موجود"
نکته: نماگرفت‌ها با استفاده از این پیکربندی همراه با این پیکربندی swaybar تولید شده‌اند.
• 2
plain (پیش‌فرض) [تصویر: plain]
• 2
solarized-dark [تصویر: solarized-dark]
• 2
solarized-light [تصویر: solarized-light]
• 2
slick [تصویر: slick]
• 2
modern [تصویر: modern]
• 2
bad-wolf [تصویر: bad-wolf]
• 2
gruvbox-light [تصویر: gruvbox-light]
• 2
gruvbox-dark [تصویر: gruvbox-dark]
• 2
space-villain [تصویر: space-villain]
• 2
native (مانند plain بدون پس‌زمینه و با جداکننده‌های بومی)
[تصویر: native]
• 2
semi-native (مانند native اما همراه با پس‌زمینه)
[تصویر: semi-native]
• 2
nord-dark (شب قطبی) [تصویر: nord-dark]
• 2
dracula [تصویر: dracula]
• 2
srcery [تصویر: srcery]
• 2
ctp-frappe [تصویر: ctp-frappe]
• 2
ctp-latte [تصویر: ctp-latte]
• 2
ctp-macchiato [تصویر: ctp-macchiato]
• 2
ctp-mocha [تصویر: ctp-mocha]
• 2
tomorrow-night [تصویر: tomorrow-night].SS "مجموعه‌شمایل‌های دردسترس (Available icon sets)"
• 2
none (پیش‌فرض.
به‌جای شمایل‌ها از برچسب‌های متنی استفاده می‌کند)
• 2
awesome4 (Font Awesome 4.x)
• 2
awesome5 (Font Awesome 5.x)
• 2
awesome6 (Font Awesome 6.x)
• 2
emoji
• 2
material
• 2
material-nf (هر فونتی از مجموعهٔ Nerd Fonts)
نکته: برای استفاده از مجموعه‌شمایل material، به یک قلم (فونت) وصله‌شدهٔ material icons نیاز دارید که می‌توانید آن را از
https://gist.github.com/draoncc/3c20d8d4262892ccd2e227eefeafa8ef/raw/3e6e12c213fba1ec28aaa26430c3606874754c30/MaterialIcons-Regular-for-inline.ttf
اینجا

دریافت کنید.
اطمینان حاصل کنید که آن را در بلوک bar در پیکربندی i3 خود وارد کرده‌اید.
"بازنویسی تم‌ها و مجموعه‌شمایل‌ها (Overriding themes and icon sets)"
یک بلوک در پیکربندی به نام theme یا
icons مانند زیر ایجاد کنید:
[theme]
theme = "solarized-dark"
[theme.overrides]
# مثال: بازتعریف رنگ‌های `idle`
idle_bg = "#123456"
idle_fg = "#abcdef"
# مثال: جابه‌جایی رنگ‌های `good` و `warning`
good_fg = { link = "warning_fg" }
good_bg = { link = "warning_bg" }
warning_fg = { link = "good_fg" }
warning_bg = { link = "good_bg" }
[icons]
icons = "awesome6"
[icons.overrides]
bat = [
"\| \|",
"\|¼\|",
"\|½\|",
"\|¾\|",
"\|X\|",
]
bat_charging = "\|^\|"
علاوه بر بازنویسی‌های سراسری، می‌توانید با استفاده از گزینه‌های
theme_overrides، icons_overrides و
icons_format که برای همهٔ بلوک‌ها در دسترس هستند، از بازنویسی‌های مخصوص هر بلوک نیز استفاده کنید.
برای نمونه:
[[block]]
block = "cpu"
icons_format = "{icon}"
[block.theme_overrides]
idle_bg = "#123456"
idle_fg = "#abcdef"
[block.icons_overrides]
cpu_boost_on = "ON"
cpu_boost_off = "OFF"
"بازنویسی‌های تم موجود (Available theme overrides)"
تمامی بازنویسی‌های bg و fg یکی از موارد زیر هستند:
• 2
کدهای رنگ هگزادسیمال html مانند #000000 یا #789ABC؛ بایت
چهارم برای آلفا (مانند #acbdef42) در برخی سیستم‌ها کار می‌کند.
00 شفاف است، FF کدر (ناشفاف) است، یا
• 2
ارجاع به یک بازنویسی دیگر، مثلاً:
{ link = "idle-bg" }، یا
• 2
ارجاع به یک نام رنگ تعریف‌شده در ~/.Xresources،
مانند x:background که به‌دنبال خطی مانند
*background: #aabbcc در ~/.Xresources می‌گردد (همچنین ببینید
https://wiki.debian.org/Xresources
.Xresources

).
سایه‌رنگ‌ها به هر دومین بلوک با شمارش از راست اضافه می‌شوند.
بنابراین آن‌ها همیشه بلوک را روشن‌تر می‌کنند و هرگز آن را تیره نخواهند کرد.
کانال آلفا نیز، در صورت پشتیبانی، می‌تواند به همین شیوه به صورت متناوب اعمال شود.
برای راهنمایی و الگوبرداری می‌توانید نگاهی به طرح‌رنگ‌های ارائه‌شده بیندازید.
• 2
idle_bg
• 2
idle_fg
• 2
good_bg
• 2
good_fg
• 2
warning_bg
• 2
warning_fg
• 2
critical_bg
• 2
critical_fg
• 2
info_bg
• 2
info_fg
• 2
alternating_tint_bg
• 2
alternating_tint_fg
• 2
separator_bg
• 2
separator_fg
• 2
separator
• 2
end_separator
• 2
start_separator.SS "جایگزینی‌های موجود آیکون (Available icon overrides)"
این موارد را می‌توان مستقیماً روی یک رشته حاوی کدپوینت(های) یونیکد مورد نظر تنظیم کرد یا از یک توالی گریز (escape sequence) در TOML مانند
"\uf0f3" برای کدپوینت‌های حداکثر ۴-نیبلی و
"\U0001f312" برای کدپوینت‌های حداکثر ۸-نیبلی استفاده کرد.
می‌توانید کدپوینت‌ها را در مستندات فونت آیکونی که استفاده می‌کنید بیابید.
برای مشاهده فهرستی از آیکون‌های استفاده‌شده به مستندات هر بلوک، یا برای فهرست کامل آیکون‌ها به مجموعه‌آیکون‌های ارائه‌شده مراجعه کنید.
"نسخه (VERSION)"
v0.36.1
"نویسندگان (AUTHORS)"
Kai Greshake <development	kai-greshake.de>، مشارکت‌کنندگان در GitHub (https, //github.com/greshake/i3status-rust/graphs/contributors)