تخطَّ إلى المحتوى

إعدادات متقدمة

بمجرد أن تصبح مرتاحاً مع أساسيات الإعدادات، هذه الأنماط تساعدك في ضبط تسوميكي أكثر.

ويدجت مخصصة متوافقة مع Waybar تقوم بتشغيل أوامر shell خارجية مع تحليل مخرجات قابل للتكوين ومعالجة النقرات.

[[widgets.custom_widget]]
id = "volume"
exec = "pamixer --get-volume"
label_format = "󰕾 {}%"
interval = 1000
on_scroll_up = "pamixer -i 5"
on_scroll_down = "pamixer -d 5"
exec_on_event = true
[layout]
left_section = ["@custom_widget:volume", "workspaces"]

خيارات التهيئة الكاملة:

المفتاح النوع الافتراضي الوصف
id string — معرف فريد للإشارة في التخطيط (@custom_widget:معرفي)
exec string — أمر shell للتنفيذ؛ احذفه لزر ينفّذ الأمر عند النقر فقط
exec_if string — لا ينفّذ exec إلا إذا خرج هذا الأمر بالحالة 0
hide_empty_text bool false يخفي الأداة عندما تكون المخرجات فارغة
icon string — أيقونة ثابتة، تعادل format_icons.default
interval int 0 فترة التحديث بالمللي ثانية (0 = تنفيذ مرة واحدة)
return_type string "plain" تنسيق المخرجات: "plain" أو "json"
label_format string "{}" سلسلة تنسيق حيث يتم استبدال {} بالمخرجات
format string — الاسم المستخدم في Waybar لـ label_format
exec_on_event bool false إعادة تشغيل الأمر بعد النقر/التمرير
max_length int 0 الحد الأقصى لطول النص (0 = بدون حد)
min_length int 0 الحد الأدنى لطول النص (يملأ بمسافات)
rotate int 0 تدوير النص بالدرجات
tooltip bool true إظهار تلميح مع المخرجات
tooltip_format string — سلسلة تنسيق التلميح
tooltip_text string — تلميح ثابت، لwidget لا تتغير مخرجاته أبدًا
on_click string — أمر النقر الأيسر
on_click_right string — أمر النقر الأيمن
on_click_middle string — أمر النقر الأوسط
on_scroll_up string — أمر التمرير لأعلى
on_scroll_down string — أمر التمرير لأسفل
signal int — رقم الإشارة لمشغلات الأحداث sig*
restart_interval int — فترة إعادة التشغيل للنصوص البرمجية المستمرة

جمّع الأدوات مع مسافات وأنماط مشتركة: أشر إلى مجموعة في تخطيطك باستخدام @group:N (فهرس يبدأ من صفر) أو @group:id (معرف نصي) :

[[widget_groups]]
id = "sys-group"
widgets = ["updates", "battery"]
spacing = 4
style_classes = ["bordered"]

أشر في التخطيط باستخدام @group:sys-group.

[layout]
right_section = ["@group:sys-group", "system_tray"]

المجموعات القابلة للطي

Section titled “المجموعات القابلة للطي”

أخفِ الأدوات الأقل استخداماً خلف مفتاح:

[[collapsible_groups]]
id = "utility-tools"
widgets = ["ocr", "screenshot", "recorder"]
spacing = 4
label_format = "󰍽"
tooltip = "أدوات مساعدة"
style_classes = ["utility-tools"]

أشر في التخطيط باستخدام @collapsible:utility-tools.

right_section = ["@collapsible:utility-tools", "system_tray"]