'\" t
.\"     Title: i3-msg
.\"    Author: [see the "AUTHOR" section]
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net>
.\"      Date: 02/06/2026
.\"    Manual: i3 Manual
.\"    Source: i3 4.25.1
.\"  Language: English
.\"
.TH "I3\-MSG" "1" "02/06/2026" "i3 4\&.25\&.1" "i3 Manual"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "نام (NAME)"
i3-msg \- ارسال پیام به مدیر پنجره i3
.SH "خلاصه دستور (SYNOPSIS)"
.sp
i3\-msg [\-q] [\-v] [\-h] [\-s socket] [\-t type] [\-r] [message]
.SH "گزینه‌ها (OPTIONS)"
.PP
\fB\-q, \-\-quiet\fR
.RS 4
فقط پیام IPC را ارسال می‌کند و خروجی پاسخ را پنهان می‌سازد\&.
.RE
.PP
\fB\-v, \-\-version\fR
.RS 4
نمایش شماره نسخه برنامه و خروج\&.
.RE
.PP
\fB\-h, \-\-help\fR
.RS 4
نمایش یک پیام راهنمای کوتاه و خروج\&.
.RE
.PP
\fB\-s, \-\-socket\fR \fIsock_path\fR
.RS 4
برنامه i3\-msg از متغیر محیطی I3SOCK یا مسیر سوکت مشخص‌شده در اینجا استفاده می‌کند\&. اگر هر دو ناموفق باشند، تلاش می‌کند اطلاعات سوکت را از پنجره ریشه به دست آورد و سپس قبل از خروج با خطا، مسیر /tmp/i3\-ipc\&.sock را امتحان کند\&.
.RE
.PP
\fB\-t\fR \fItype\fR
.RS 4
ارسال پیام IPC؛ بخش زیر را ببینید\&. مقدار پیش‌فرض این گزینه "command" است\&.
.RE
.PP
\fB\-m\fR, \fB\-\-monitor\fR
.RS 4
به جای خروج بلافاصله پس از دریافت نخستین رویداد مشترک‌شده، به طور نامحدود منتظر تمام آن‌ها می‌ماند\&. فقط همراه با "\-t subscribe" قابل استفاده است\&. برای جزئیات، نوع پیام IPC "subscribe" را در زیر ببینید\&.
.RE
.PP
\fB\-r, \-\-raw\fR
.RS 4
نمایش پاسخ خام JSON به جای فرمت‌بندی زیبای خطاها (برای دستورها) یا نمایش محتوای فایل پیکربندی سطح بالا (برای GET_CONFIG)\&.
.RE
.PP
\fBmessage\fR
.RS 4
پیام IPC ارسالی؛ بخش زیر را ببینید\&.
.RE
.SH "انواع پیام‌های IPC (IPC MESSAGE TYPES)"
.PP
command
.RS 4
بار داده (payload) پیام، یک دستور برای i3 است (مانند دستوراتی که در فایل پیکربندی به کلیدها متصل می‌کنید) و بلافاصله پس از دریافت اجرا می‌شود\&.
.RE
.PP
get_workspaces
.RS 4
فضاهای کاری جاری را دریافت می‌کند\&. پاسخ، یک فهرست کدگذاری‌شده به صورت JSON از فضاهای کاری خواهد بود\&.
.RE
.PP
get_outputs
.RS 4
خروجی‌های (نمایشگرهای) جاری را دریافت می‌کند\&. پاسخ، یک فهرست کدگذاری‌شده به صورت JSON از خروجی‌ها خواهد بود (بخش پاسخ‌ها در docs/ipc را ببینید، برای نمونه در
\m[blue]\fBhttps://i3wm\&.org/docs/ipc\&.html#_receiving_replies_from_i3\fR\m[])\&.
.RE
.PP
get_tree
.RS 4
درخت چینش را دریافت می‌کند\&. مدیر پنجره i3 از ساختار داده درختی استفاده می‌کند که شامل تمامی کانتینرها است\&. پاسخ، درخت کدگذاری‌شده به صورت JSON خواهد بود\&.
.RE
.PP
get_marks
.RS 4
فهرستی از نشانه‌ها (شناسه‌های کانتینرها برای پرش سریع و آسان به آن‌ها در آینده) را دریافت می‌کند\&. پاسخ، یک فهرست کدگذاری‌شده به صورت JSON از نشانه‌های پنجره خواهد بود\&.
.RE
.PP
get_bar_config
.RS 4
پیکربندی نوار فضای کاری (به صورت نگاشت JSON) با شناسه داده‌شده را دریافت می‌کند\&. اگر شناسه‌ای ارائه نشود، آرایه‌ای از تمام شناسه نوارهای پیکربندی‌شده بازگردانده می‌شود\&.
.RE
.PP
get_binding_modes
.RS 4
فهرستی از حالت‌های اتصال کلید (binding modes) پیکربندی‌شده را دریافت می‌کند\&.
.RE
.PP
get_version
.RS 4
نسخه فعلی i3 را دریافت می‌کند\&. پاسخ یک دیکشنری کدگذاری‌شده به صورت JSON شامل نسخه اصلی، فرعی، وصله و نسخه خوانا برای انسان خواهد بود\&.
.RE
.PP
get_config
.RS 4
پیکربندی فعلی بارگذاری‌شده در i3 را دریافت می‌کند\&.
.RE
.PP
send_tick
.RS 4
یک رویداد تیک (tick) به تمامی اتصالات IPC که در رویدادهای تیک مشترک شده‌اند ارسال می‌کند\&.
.RE
.PP
subscribe
.RS 4
بار داده پیام، رویدادهایی را توصیف می‌کند که قصد اشتراک در آن‌ها را دارید\&. به محض دریافت، هر رویداد به صورت یک شیء کدگذاری‌شده در قالب JSON تخلیه می‌شود\&. برای نظارت مستمر، گزینه \-m را ببینید\&.
.RE
.SH "توضیحات (DESCRIPTION)"
.sp
دستور i3\-msg یک پیاده‌سازی نمونه برای کلاینتی است که از رابط IPC سوکت یونیکس برای ارتباط با i3 استفاده می‌کند\&.
.SS "وضعیت خروج (Exit status):"
.sp
0: در صورت موفقیت، 1: در صورت نحو نامعتبر یا ناتوانی در اتصال به سوکت IPC، 2: در صورتی که i3 در پردازش دستور(های) شما با خطا مواجه شود\&.
.SH "مثال‌ها (EXAMPLES)"
.sp
.if n \{\
.RS 4
.\}
.nf
# استفاده از کادر ۱ پیکسلی برای کلاینت جاری
i3\-msg "border 1pixel"

# می‌توانید گیومه‌ها را حذف کنید
i3\-msg border normal

# استخراج و تخلیه درخت چینش
i3\-msg \-t get_tree

# نظارت بر تغییرات پنجره‌ها
i3\-msg \-t subscribe \-m \*(Aq[ "window" ]\*(Aq
.fi
.if n \{\
.RE
.\}
.SH "محیط (ENVIRONMENT)"
.SS "I3SOCK"
.sp
اگر هیچ سوکت IPC در خط فرمان مشخص نشده باشد، از این متغیر برای تعیین مسیر سوکت دامنه یونیکس مورد نیاز برای اتصال به i3 استفاده می‌شود\&.
.SH "همچنین ببینید (SEE ALSO)"
.sp
i3(1)
.SH "نویسندگان (AUTHORS)"
.sp
Michael Stapelberg و مشارکت‌کنندگان