.\" Generated by scdoc 1.11.4
.\" Complete documentation for this program is not available as a GNU info page
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.nh
.ad l
.\" Begin generated content:
.TH "swaync" "1" "2026-03-23"
.PP
.SH "نام (NAME)"
.PP
swaync \- دیمن ساده اعلان با رابط گرافیکی GTK برای اعلان‌ها و مرکز کنترل
.PP
.SH "نحوه استفاده (USAGE)"
.PP
\fBswaync\fR [option]
.PP
.SH "گزینه‌ها (OPTIONS)"
.PP
\fB-h, --help\fR
.RS 4
نمایش گزینه‌های راهنما
.PP
.RE
\fB-v, --version\fR
.RS 4
چاپ نسخه
.PP
.RE
\fB-s, --style\fR <CSS file>
.RS 4
استفاده از یک فایل شیوه‌نامه (Stylesheet) سفارشی
.PP
.RE
\fB--replace\fR
.RS 4
جایگزین کردن نمونه در حال اجرای SwayNotificationCenter
.PP
.RE
\fB--skip-system-css\fR
.RS 4
صرف‌نظر از تجزیه فایل شیوه‌نامه ارائه‌شده همراه بسته.\& مناسب برای اشکال‌زدایی CSS
.PP
.RE
\fB--custom-system-css\fR
.RS 4
انتخاب یک فایل CSS سفارشی برای استفاده به‌عنوان CSS «سیستمی».\& مناسب برای اشکال‌زدایی CSS
.PP
.RE
\fB-c, --config\fR <Config file>
.RS 4
استفاده از یک فایل پیکربندی سفارشی
.PP
.RE
.SH "کلیدهای میان‌بر مرکز کنترل (CONTROL CENTER KEYBOARD SHORTCUTS)"
.PP
\fBUp/Down\fR: پیمایش اعلان‌ها
.PP
\fBHome\fR: رفتن به جدیدترین اعلان
.PP
\fBEnd\fR: رفتن به قدیمی‌ترین اعلان
.PP
\fBEscape/Caps_Lock\fR: بستن پنل اعلان‌ها
.PP
\fBReturn\fR: اجرای کنش پیش‌فرض یا در صورت نبود، بستن اعلان
.PP
\fBDelete/BackSpace\fR: بستن اعلان
.PP
\fBShift+C\fR: بستن تمام اعلان‌ها
.PP
\fBShift+D\fR: تغییر وضعیت «مزاحم نشوید» (Do Not Disturb)
.PP
\fBButtons 1-9\fR: اجرای کنش‌های جایگزین
.PP
\fBLeft click button / actions\fR: فعال‌سازی کنش اعلان
.PP
\fBMiddle/Right click notification\fR: بستن اعلان
.PP
.SH "پیکربندی (CONFIGURATION)"
.PP
فایل پیکربندی اصلی در مسیر \fB/etc/xdg/swaync/config.\&json\fR قرار دارد.\& آن را
به پوشه \fB\(ti/.\&config/swaync/\fR خود کپی کنید تا بدون نیاز به دسترسی مدیر سیستم (root) بتوانید آن را سفارشی‌سازی کنید.\&
.PP
برای بارگذاری مجدد پیکربندی، باید دستور \fBswaync-client --reload-config\fR را اجرا کنید.\&
.PP
برای دریافت اطلاعات درباره ساختار فایل پیکربندی، \fBswaync\fR(5) را ببینید.\&
.PP
.PP
.SH "اسکریپت‌نویسی (SCRIPTING)"
.PP
قوانین و منطق اسکریپت‌نویسی:
.PP
.PD 0
.IP 1. 4
به ازای هر اعلان \fBتنها یک\fR اسکریپت می‌تواند اجرا شود
.IP 2. 4
هر اسکریپت نیازمند `exec` و دست‌کم یکی از ویژگی‌های دیگر است
.IP 3. 4
برای اجرا شدن اسکریپت، تمام ویژگی‌های فهرست‌شده باید با اعلان مطابقت داشته باشند
.IP 4. 4
اگر هر یک از ویژگی‌ها مطابقت نداشته باشد، اسکریپت نادیده گرفته خواهد شد
.IP 5. 4
اگر اعلانی فاقد یکی از ویژگی‌ها باشد، آن ویژگی نادیده گرفته می‌شود
.PD
.PP
اطلاعات اعلان را می‌توان با اجرای دستور
\fBG_MESSAGES_DEBUG=all swaync\fR در ترمینال چاپ کرد (هنگامی که یک اعلان ظاهر می‌شود).\&
.PP
ویژگی‌های پیکربندی:
.PP
.nf
.RS 4
{
	"scripts": {
		"example-script": {
			"exec": "Your shell command or script here\&.\&.\&.",
			"app-name": "Notification app-name Regex",
			"summary": "Notification summary Regex",
			"body": "Notification body Regex",
			"urgency": "Low or Normal or Critical",
			"category": "Notification category Regex"
		}
	}
	other non scripting properties\&.\&.\&.
}
.fi
.RE
.PP
مثال \fBconfig.\&json\fR:
.PP
.nf
.RS 4
{
	"scripts": {
		// This script will only run when Spotify sends a notification containing
		// that exact summary and body
		"example-script": {
			"exec": "~/\&.config/swaync/myRickRollScript\&.sh",
			"app-name": "Spotify"
			"summary": "Never Gonna Give You Up",
			"body": "Rick Astley - Whenever You Need Somebody"
		}
	}
	other non scripting properties\&.\&.\&.
}
.fi
.RE
.PP
.SS "غیرفعال‌سازی اسکریپت‌نویسی (Disable scripting)"
.PP
برای غیرفعال کردن کامل اسکریپت‌نویسی، پروژه باید به این صورت ساخته شود:
.PP
.nf
.RS 4
meson build -Dscripting=false
ninja -C build
meson install -C build
.fi
.RE
.PP
.SH "مثال Waybar (WAYBAR EXAMPLE)"
.PP
این مثال برای نمایش صحیح نشانک‌ها به \fBNotoSansMono Nerd Font\fR نیاز دارد
.PP
پیکربندی Waybar:
.PP
.nf
.RS 4
"custom/notification": {
	"tooltip": false,
	"format": "{icon}",
	"format-icons": {
		"notification": "<span foreground=\&'red\&'><sup></sup></span>",
		"none": "",
		"dnd-notification": "<span foreground=\&'red\&'><sup></sup></span>",
		"dnd-none": "",
		"inhibited-notification": "<span foreground=\&'red\&'><sup></sup></span>",
		"inhibited-none": "",
		"dnd-inhibited-notification": "<span foreground=\&'red\&'><sup></sup></span>",
		"dnd-inhibited-none": ""
	},
	"return-type": "json",
	"exec-if": "which swaync-client",
	"exec": "swaync-client -swb",
	"on-click": "swaync-client -t -sw",
	"on-click-right": "swaync-client -d -sw",
	"escape": true
},
.fi
.RE
.PP
فایل css برنامه Waybar:
.PP
.nf
.RS 4
#custom-notification {
	font-family: "NotoSansMono Nerd Font";
}
.fi
.RE