swaynag(1) General Commands Manual swaynag(1)

swaynag - نمایش پیام هشدار یا خطا همراه با دکمه‌ها

swaynag [گزینه‌ها...]

-b, --button <text> <action>

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

-B, --button-no-terminal <text> <action>

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

-z, --button-dismiss <text> <action>

ایجاد دکمه‌ای با متن text که هنگام فشرده شدن، action را اجرا کرده و swaynag را می‌بندد. اگر متغیر محیطی TERMINAL تنظیم شده باشد، action درون ترمینال اجرا خواهد شد. در غیر این صورت، به اجرای مستقیم بازمی‌گردد. با مشخص کردن چندباره این پرچم، می‌توان چندین دکمه را تعریف کرد.

-Z, --button-dismiss-no-terminal <text> <action>

ایجاد دکمه‌ای با متن text که هنگام فشرده شدن، action را اجرا کرده و swaynag را می‌بندد. action به جای اجرا در ترمینال، مستقیماً اجرا خواهد شد. با مشخص کردن چندباره این پرچم، می‌توان چندین دکمه را تعریف کرد.

-c, --config <path>

فایل پیکربندی مورد استفاده. به صورت پیش‌فرض، مسیرهای زیر بررسی می‌شوند: $HOME/.swaynag/config، $XDG_CONFIG_HOME/swaynag/config و SYSCONFDIR/swaynag/config. تمام پرچم‌ها به جز این گزینه و debug گزینه‌های معتبری در فایل پیکربندی با قالب long-option=value هستند. تمام خط فاصله‌های ابتدایی باید حذف شوند و علامت مساوی الزامی است. برای اطلاعات بیشتر swaynag(5) را ببینید.

-d, --debug

فعال‌سازی اشکال‌زدایی.

-e, --edge top|bottom

تنظیم لبه مورد استفاده.

-y, --layer overlay|top|bottom|background

تنظیم لایه مورد استفاده.

-f, --font <font>

تنظیم فونت مورد استفاده.

-h, --help

نمایش پیام راهنما و خروج.

-l, --detailed-message

خواندن یک پیام با جزئیات از stdin. دکمه‌ای برای تغییر وضعیت نمایش جزئیات اضافه خواهد شد. جزئیات در یک ناحیه متنی چندخطی و قابل پیمایش نمایش داده می‌شوند.

-L, --detailed-button <text>

تنظیم متن دکمه تغییر وضعیت نمایش جزئیات. اگر پیام دارای جزئیات وجود نداشته باشد، این گزینه تأثیری ندارد. مقدار پیش‌فرض Toggle details است.

-m, --message <msg>

تنظیم متن پیام.

-o, --output <output>

تنظیم خروجی مورد استفاده. این مقدار باید نام یک xdg_output باشد.

-s, --dismiss-button <text>

تنظیم متن دکمه بستن nagbar. مقدار پیش‌فرض X است.

-t, --type <type>

تنظیم نوع پیام. دو نوع به صورت پیش‌فرض ایجاد شده‌اند: error و warning. انواع سفارشی را می‌توان در فایل پیکربندی تعریف کرد. برای جزئیات به --config و swaynag(5) مراجعه کنید. هر دو نوع پیش‌فرض را می‌توان در فایل پیکربندی نیز بازنویسی کرد.

-v, --version

نمایش شماره نسخه و خروج.

--background <RRGGBB[AA]>

تنظیم رنگ پس‌زمینه.

--border <RRGGBB[AA]>

تنظیم رنگ حاشیه.

--border-bottom <RRGGBB[AA]>

تنظیم رنگ حاشیه پایینی.

--button-background <RRGGBB[AA]>

تنظیم رنگ پس‌زمینه دکمه‌ها.

--text <RRGGBB[AA]>

تنظیم رنگ متن.

--button-text <RRGGBB[AA]>

تنظیم رنگ متن دکمه.

--border-bottom-size <size>

تنظیم ضخامت حاشیه پایینی.

--message-padding <padding>

تنظیم حاشیه درونی (padding) پیام.

--details-background <RRGGBB[AA]>

تنظیم رنگ پس‌زمینه برای جزئیات.

--details-border-size <size>

تنظیم ضخامت حاشیه جزئیات.

--button-border-size <size>

تنظیم ضخامت حاشیه دکمه.

--button-gap <gap>

تنظیم اندازه فاصله میان دکمه‌ها.

--button-dismiss-gap <gap>

تنظیم اندازه فاصله میان دکمه بستن و دکمه‌ای دیگر.

--button-margin-right <margin>

تنظیم فاصله حاشیه از سمت راست دکمه بستن تا لبه.

--button-padding <padding>

تنظیم حاشیه درونی (padding) متن دکمه.

swaynag(5)

2026-06-23