.\" 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 "swaymsg" "1" "2026-06-23"
.PP
.SH "نام (NAME)"
.PP
swaymsg \- ارسال پیام به یک نمونه در حال اجرای sway از طریق سوکت IPC.\&
.PP
.SH "خلاصه دستور (SYNOPSIS)"
.PP
\fIswaymsg\fR [options.\&.\&.\&] [message]
.PP
.SH "گزینه‌ها (OPTIONS)"
.PP
\fB-h, --help\fR
.RS 4
نمایش پیام راهنما و خروج.\&
.PP
.RE
\fB-m, --monitor\fR
.RS 4
پایش برای دریافت پاسخ‌ها تا زمان متوقف شدن، به‌جای خروج پس از دریافت
نخستین پاسخ.\& این گزینه تنها با نوع پیام IPC به نام \fIsubscribe\fR قابل استفاده است.\&
اگر پاسخی ناهنجار دریافت شود یا نوع رویداد نامعتبری درخواست شده باشد،
swaymsg پایش را متوقف کرده و خارج می‌شود.\&
.PP
.RE
\fB-p, --pretty\fR
.RS 4
استفاده از خروجی زیبا و مرتب حتی در صورت عدم استفاده از tty.\&
برای همه انواع پیام در دسترس نیست.\&
.PP
.RE
\fB-q, --quiet\fR
.RS 4
ارسال پیام IPC بدون چاپ پاسخ دریافتی از sway.\&
.PP
.RE
\fB-r, --raw\fR
.RS 4
استفاده از خروجی خام JSON حتی در صورت استفاده از tty.\&
.PP
.RE
\fB-s, --socket\fR <path>
.RS 4
استفاده از مسیر سوکت مشخص‌شده.\& در غیر این صورت، swaymsg از sway جویای
مکان سوکت خواهد شد (که ابتدا مقدار $SWAYSOCK و سپس $I3SOCK است).\&
.PP
.RE
\fB-t, --type\fR <type>
.RS 4
مشخص کردن نوع پیام IPC.\& به موارد زیر مراجعه کنید.\&
.PP
.RE
\fB-v, --version\fR
.RS 4
چاپ نسخه (برنامه swaymsg) و خروج.\&
.PP
.RE
.SH "انواع پیام‌های IPC (IPC MESSAGE TYPES)"
.PP
\fB<command>\fR
.RS 4
پیام ارسالی یک دستور sway است (همان دستوراتی که می‌توانید در فایل پیکربندی sway
به کلیدهای میانبر مقید کنید).\& این دستور بلافاصله اجرا خواهد شد.\&
.PP
برای مشاهده فهرست دستورها به \fBsway\fR(5) مراجعه کنید.\&
.PP
دستور \fIswaymsg\fR می‌تواند خروجی به شکل خوانا و مرتب (پیش‌فرض در حالت مستقل) یا
با قالب‌بندی JSON (\fB--raw\fR) بازگرداند.\& برای مستندات دقیق درباره داده‌های JSON
بازگردانده شده در هر یک از انواع پیام فهرست‌شده در زیر، به \fBsway-ipc\fR(7) مراجعه کنید.\&
قالب JSON می‌تواند حاوی اطلاعات بیشتری نسبت به خروجی مرتب (pretty) باشد.\&
.PP
نکات:
.PD 0
.IP \(bu 4
بسط دستور دو بار انجام می‌شود: یک بار توسط swaymsg و بار دیگر توسط sway.\&
اگر در دستور خود رشته‌های چندکلمه‌ای دارای علامت نقل‌قول دارید، کل
دستور را درون علامت‌های نقل‌قول تکی (single-quotes) قرار دهید.\& به عنوان مثال، از
\fIswaymsg '\&output "Foobar Display" enable'\&\fR به‌جای
\fIswaymsg output "Foobar Display" enable\fR استفاده کنید.\& علاوه بر این، توجه داشته باشید
که گزینه‌های جداشده با کاما نیز رشته‌های چندکلمه‌ای به حساب می‌آیند، چرا که
می‌توان از کاما برای اجرای چندین دستور در همان سطر استفاده کرد.\&
.IP \(bu 4
اگر دستوری ارائه می‌دهید که با یک خط تیره (\fI-\fR) شروع می‌شود، پیش از
دستور دو خط تیره (\fI--\fR) درج کنید تا به swaymsg اعلام کند هیچ چیزی پس
از آن نقطه را به عنوان گزینه پردازش نکند.\& برای مثال، از
\fIswaymsg -- mark --add test\fR به‌جای \fIswaymsg mark --add test\fR استفاده کنید.\&
.PD
.PP
.RE
\fBget_workspaces\fR
.RS 4
فهرستی از فضاهای کاری و وضعیت آن‌ها را دریافت می‌کند.\&
.PP
.RE
\fBget_inputs\fR
.RS 4
فهرستی از ورودی‌های فعلی را دریافت می‌کند.\&
.PP
.RE
\fBget_outputs\fR
.RS 4
فهرستی از خروجی‌های فعلی را دریافت می‌کند.\&
.PP
.RE
\fBget_tree\fR
.RS 4
درخت چیدمان کدگذاری‌شده به صورت JSON از تمامی پنجره‌های باز، کانتینرها،
خروجی‌ها، فضاهای کاری و غیره را دریافت می‌کند.\&
.PP
.RE
\fBget_seats\fR
.RS 4
فهرستی از تمامی seatها،
ویژگی‌های آن‌ها و تمام دستگاه‌های اختصاص‌یافته را دریافت می‌کند.\&
.PP
.RE
\fBget_marks\fR
.RS 4
فهرستی کدگذاری‌شده به صورت JSON از نشانه‌ها (marks) را دریافت می‌کند.\&
.PP
.RE
\fBget_bar_config\fR
.RS 4
پیکربندی کدگذاری‌شده به صورت JSON را برای swaybar دریافت می‌کند.\&
.PP
.RE
\fBget_version\fR
.RS 4
اطلاعات نسخه نمونه در حال اجرای sway را دریافت می‌کند.\&
.PP
.RE
\fBget_binding_modes\fR
.RS 4
فهرستی کدگذاری‌شده به صورت JSON از حالت‌های میانبر (binding modes) پیکربندی‌شده فعلی را دریافت می‌کند.\&
.PP
.RE
\fBget_binding_state\fR
.RS 4
اطلاعات کدگذاری‌شده به صورت JSON درباره وضعیت فعلی کلیدهای میانبر (binding state) را دریافت می‌کند.\&
.PP
.RE
\fBget_config\fR
.RS 4
یک رونوشت از پیکربندی فعلی را دریافت می‌کند.\& دستورهای include را بسط نمی‌دهد.\&
.PP
.RE
\fBsend_tick\fR
.RS 4
یک رویداد tick را به تمام کلاینت‌های مشترک‌شده ارسال می‌کند.\&
.PP
.RE
\fBsubscribe\fR
.RS 4
اشتراک در فهرستی از انواع رویدادها.\& آرگومان این نوع باید در قالب
یک آرایه معتبر JSON ارائه شود.\& در صورتی که هر یک از انواع نامعتبر باشد
یا آرایه معتبر JSON ارائه نشود، عملیات با شکست مواجه خواهد شد.\&
برای مشاهده فهرست انواع رویدادهای معتبر و داده‌های بازگردانده شده به همراه آن‌ها به
\fBsway-ipc\fR(7) مراجعه کنید.\&
.PP
.RE
.SH "کدهای بازگشتی (RETURN CODES)"
.PP
\fB0\fR
.RS 4
موفقیت
.PP
.RE
\fB1\fR
.RS 4
خطاهای swaymsg مانند نحو نامعتبر، ناتوانی در اتصال به سوکت ipc
یا ناتوانی در تجزیه پاسخ sway
.PP
.RE
\fB2\fR
.RS 4
بروز خطا از سوی sway هنگام پردازش دستور (مانند دستور نامعتبر،
شکست در اجرای دستور، و درخواست اشتراک نامعتبر)
.PP
.RE
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fBsway\fR(5) \fBsway-bar\fR(5) \fBsway-input\fR(5) \fBsway-output\fR(5) \fBsway-ipc\fR(7)