sway(1) General Commands Manual sway(1)

sway - یک کامپوزیتور Wayland سازگار با i3

sway [options...] [command]

-h, --help

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

-c, --config <config>

یک فایل پیکربندی را مشخص می‌کند.

-C, --validate

بررسی معتبر بودن فایل پیکربندی و سپس خروج.

-d, --debug

فعال‌سازی ثبت وقایع کامل، شامل اطلاعات دیباگ.

-v, --version

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

-V, --verbose

فعال‌سازی ثبت وقایع با جزئیات بیشتر (verbose).

--get-socketpath

مسیر سوکت IPC را دریافت و چاپ کرده، سپس خارج می‌شود.

دستور sway برای برطرف کردن نیاز به یک مدیر پنجره شبیه به i3 برای Wayland ایجاد شد. توسعه‌دهندگان بالادستی i3 قصدی برای پورت کردن i3 به Wayland ندارند، و پروژه‌های پیشنهادی دیگران نیز ناتمام رها شدند (vaporware شدند). سپاس فراوان از تیم i3 برای ارائه چنین نرم‌افزار فوق‌العاده‌ای؛ آن‌قدر عالی که کاربران شما ترجیح می‌دهند یک مدیر پنجره کاملاً جدید را از ابتدا بنویسند که دقیقاً مانند i3 رفتار کند، تا اینکه به چیز دیگری مهاجرت کنند.

شما می‌توانید sway را مستقیماً از طریق یک tty یا به‌وسیله یک مدیر ورود (login manager) سازگار با Wayland اجرا کنید.

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

1.
~/.sway/config
2.
$XDG_CONFIG_HOME/sway/config (مسیر پیشنهادی)
3.
~/.i3/config
4.
$XDG_CONFIG_HOME/i3/config
5.
/etc/sway/config
6.
/etc/i3/config

در صورت عدم تنظیم، مقدار پیش‌فرض $XDG_CONFIG_HOME برابر با ~/.config خواهد بود.

اگر هیچ فایل پیکربندی یافت نشود، یک خطا رخ می‌دهد. پیکربندی پیش‌فرضِ توصیه‌شده معمولاً در /etc/sway/config نصب می‌شود؛ توصیه می‌شود این فایل را در ~/.config/sway/config کپی کرده و آن را ویرایش نمایید.

برای اطلاعات بیشتر در مورد قالب فایل پیکربندی، sway(5) را ببینید.

اگرچه عموماً استفاده از swaymsg(1) ترجیح داده می‌شود، اما می‌توانید دستور sway command را اجرا کنید تا command به نمونه در حال اجرای sway ارسال شود. همچنین می‌توانید با i3-msg(1) یا حتی i3(1) دستورها را ارسال کنید.

متغیرهای محیطی زیر بر sway تأثیر می‌گذارند:

SWAYSOCK

مسیر سوکت IPC برنامه sway را مشخص می‌کند.

XKB_DEFAULT_RULES, XKB_DEFAULT_MODEL, XKB_DEFAULT_LAYOUT, XKB_DEFAULT_VARIANT, XKB_DEFAULT_OPTIONS

تنظیمات صفحه‌کلید xkb را پیکربندی می‌کند. xkeyboard-config(7) را ببینید. روش ترجیحی برای پیکربندی صفحه‌کلید از طریق فایل پیکربندی است؛ sway-input(5) را ببینید.

متغیرهای محیطی زیر توسط sway مقداردهی می‌شوند:

DISPLAY

در صورت کامپایل با پشتیبانی از Xwayland و در صورتی که Xwayland توسط پیکربندی غیرفعال نشده باشد، با نام نمایشگر X مورد استفاده برای Xwayland مقداردهی می‌شود.

I3SOCK

برای سازگاری با i3، مسیر سوکت IPC برنامه sway را مشخص می‌کند.

SWAYSOCK

مسیر سوکت IPC برنامه sway را مشخص می‌کند.

WAYLAND_DISPLAY

نام نمایشگر Wayland که sway روی آن در حال اجرا است را مشخص می‌کند.

XCURSOR_SIZE

اندازه پیکربندی‌شده مکان‌نما را مشخص می‌کند.

XCURSOR_THEME

تم پیکربندی‌شده مکان‌نما را مشخص می‌کند.

نگهداری‌شده توسط Simon Ser <contact@emersion.fr>، با همراهی سایر مشارکت‌کنندگان متن‌باز. برای کسب اطلاعات بیشتر در رابطه با توسعه sway، نشانی https://github.com/swaywm/sway را ببینید.

sway(5) swaymsg(1) sway-input(5) sway-output(5) sway-bar(5) sway-ipc(7)

2026-06-23