'\" t
.\"     Title: i3bar
.\"    Author: [see the "AUTHORS" 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 "I3BAR" "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)"
i3bar \- نوار وضعیت و میزکار مبتنی بر xcb
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBi3bar\fR [\fB\-b\fR \fIbar_id\fR] [\fB\-s\fR \fIsock_path\fR] [\fB\-t\fR] [\fB\-h\fR] [\fB\-v\fR] [\fB\-V\fR]
.SH "هشدار (WARNING)"
.sp
برنامه i3bar برای هر بلوک پیکربندی \fIbar\fR به طور خودکار توسط i3 فراخوانی خواهد شد\&.
.sp
اجرای دستی آن معمولاً چیزی نیست که بخواهید انجام دهید\&.
.sp
به شما هشدار داده شد!
.SH "گزینه‌ها (OPTIONS)"
.PP
\fB\-s, \-\-socket\fR \fIsock_path\fR
.RS 4
مسیر سوکت IPC در i3 را بازنویسی می‌کند\&.
.RE
.PP
\fB\-b, \-\-bar_id\fR \fIbar_id\fR
.RS 4
شناسه نوار (bar ID) را مشخص می‌کند تا پیکربندی آن از i3 دریافت شود\&. به طور پیش‌فرض، i3bar از نخستین بلوک نوار پیکربندی‌شده در i3 استفاده خواهد کرد\&.
.RE
.PP
\fB\-t, \-\-transparency\fR
.RS 4
فعال‌سازی شفافیت (رنگ‌های RGBA)
.RE
.PP
\fB\-h, \-\-help\fR
.RS 4
نمایش یک پیام راهنمای کوتاه و خروج
.RE
.PP
\fB\-v, \-\-version\fR
.RS 4
نمایش شماره نسخه و خروج\&.
.RE
.PP
\fB\-V\fR
.RS 4
حالت پرگو (نمایش گزارش‌های با جزئیات بیشتر)\&.
.RE
.SH "توضیحات (DESCRIPTION)"
.sp
\fBi3bar\fR نواری را در پایین (یا بالای) نمایشگر(های) شما نمایش می‌دهد که دربردارندهٔ دکمه‌های جابه‌جایی بین فضاهای کاری و یک خط وضعیت تولید شده توسط i3status(1) یا برنامه‌های مشابه است\&. این ابزار به طور خودکار توسط i3 فراخوانی (و از طریق آن پیکربندی) می‌شود\&.
.sp
برنامه i3bar از یک پروتکل JSON برای تنظیم خط وضعیت پشتیبانی می‌کند، ببینید \m[blue]\fBhttps://i3wm\&.org/docs/i3bar\-protocol\&.html\fR\m[]
.sp
از نسخه 4\&.23 در i3، ابزار i3bar از یک پروتکل JSON دیگر برای تنظیم دکمه‌های فضاهای کاری پشتیبانی می‌کند\&. ببینید \m[blue]\fBhttps://i3wm\&.org/docs/i3bar\-workspace\-protocol\&.html\fR\m[]\&.
.SH "محیط (ENVIRONMENT)"
.SS "I3SOCK"
.sp
به عنوان مسیر جایگزین (fallback) برای سوکت IPC در i3 استفاده می‌شود، در صورتی که نه آرگومانی در خط فرمان مشخص شده باشد و نه ویژگی I3_SOCKET_PATH روی پنجره ریشه X11 تنظیم شده باشد\&.
.SH "مثال‌ها (EXAMPLES)"
.sp
اینجا چیزی برای دیدن نیست، به مسیر خود ادامه دهید\&. همان‌طور که در بالا گفته شد، نباید i3bar را به صورت دستی اجرا کنید\&.
.sp
در عوض، به مستندات i3، به‌ویژه راهنمای کاربری (User\(cqs Guide) مراجعه کنید\&.
.SH "همچنین ببینید (SEE ALSO)"
.sp
i3status(1)، j4status(1) یا conky(1) برای برنامه‌های تولیدکننده خط وضعیت\&.
.sp
dzen2(1) یا xmobar(1) برای برنامه‌های مشابه i3bar\&.
.SH "نویسندگان (AUTHORS)"
.sp
Axel Wagner و مشارکت‌کنندگان