.TH UTOX "1" "March 2026" "µTox 0.18.1"
.SH "نام (NAME)"
µTox \- کلاینت سبک Tox

.SH "خلاصه دستور (SYNOPSIS)"
کاربرد: utox [\-\-portable] [\-\-theme <THEME>] [\-\-set=<start\-on\-boot|show\-window|hide\-window>] [\-\-allow\-root]
   یا: utox \-\-version
   یا: utox \-\-help

.SH "توضیحات (DESCRIPTION)"
نرم‌افزار \fBµTox\fP یک کلاینت آزاد، سبک و گرافیکی Tox برای سامانهٔ پنجره‌ای X.org است.

از \fBµTox\fP می‌توان برای موارد زیر استفاده کرد:
 * پیام‌رسانی متنی یک‌به‌یک (1\-to\-1)
 * پیام‌رسانی متنی گروهی
 * تماس‌های صوتی
 * تماس‌های تصویری
 * تماس‌های صوتی گروهی
 * هم‌رسانی صفحه‌نمایش (desktop sharing)
 * انتقال فایل

.SH "گزینه‌ها (OPTIONS)"
.IP "\fB\-t\fP \fI<THEME>\fP یا \fB\-\-theme\fP \fI<THEME>\fP"
انتخاب طرح رنگی. گزینه‌های ممکن عبارتند از: \fIdefault\fP، \fIdark\fP،
\fIlight\fP، \fIhighcontrast\fP، \fIzenburn\fP، \fIsolarized-light\fP، یا
\fIsolarized-dark\fP.

.IP "\fB\-p\fP یا \fB\-\-portable\fP"
اجرا در حالت قابل‌حمل (portable). تمام داده‌ها در پوشهٔ tox واقع در دایرکتوری کاری جاری ذخیره خواهند شد؛ برای جزئیات بیشتر بخش \fBفایل‌ها (FILES)\fP را ببینید.

.IP "\fB\-\-allow\-root\fP"
اجازهٔ اجرای µTox با دسترسی کاربر ریشه (root). حالت پیش‌فرض، ممانعت از اجرا است.

.IP "\fB\-s\fP \fI<OPTION>\fP یا \fB\-\-set \fP\fI<OPTION>\fP"
تنظیم یک گزینه. گزینه‌های موجود عبارتند از \(lqstart\-on\-boot\(rq، \(lqshow\-window\(rq و \(lqhide\-window\(rq.

.IP "\fB\-u\fP \fI<OPTION>\fP یا \fB\-\-unset \fP\fI<OPTION>\fP"
لغو تنظیم یک گزینه. گزینهٔ موجود \(lqstart\-on\-boot\(rq است.

.IP "\fB\-v\fP یا \fB\-\-verbose\fP"
افزایش سطح خروجی اشکال‌زدایی. استفادهٔ مکرر از گزینهٔ \-v میزان پرگویی (verbosity) را افزایش می‌دهد. حداکثر مقدار 6 است.

.IP "\fB--silent\fP"
تنظیم سطح پرگویی روی 0 و غیرفعال کردن تمامی خروجی‌های اشکال‌زدایی.

.IP "\fB--debug\fP \fI<FILE>\fP"
نوشتن تمامی خروجی‌های اشکال‌زدایی در فایل مشخص‌شده.

.IP "\fB\-h\fP یا \fB\-\-help\fP"
چاپ توضیحی کوتاه دربارهٔ گزینه‌های موجود.

.IP "\fB\-\-version\fP"
چاپ نگارش برنامه و خروج.

.SH "کلیدهای میان‌بر (KEYBINDINGS)"
.IP "\fBCtrl+F\fP"
تغییر وضعیت فیلتر برخط بودن در فهرست دوستان.

.IP "\fBCtrl+f\fP"
تمرکز (فوکوس) روی فیلد ورودی جستجوی فهرست دوستان.

.IP "\fBCtrl+[num], Alt+[num]\fP"
رفتن به گفتگوی شمارهٔ [num].

.IP "\fBCtrl+Pg{Up,Down}\fP"
حرکت به بالا یا پایین در فهرست دوستان.

.IP "\fBCtrl+Pg{Home,End}\fP"
حرکت به اولین یا آخرین دوست در فهرست دوستان.

.IP "\fBEsc\fP"
برداشتن تمرکز از فیلد ورودی پیام. در حالت عدم تمرکز، فشردن هر کلیدی دوباره تمرکز را به آن بازمی‌گرداند.

.IP "\fBPg{Up,Down}\fP"
پیمایش تاریخچهٔ گفتگو به بالا یا پایین. این میان‌بر تنها زمانی کار می‌کند که فیلد ورودی پیام در حالت تمرکز نباشد.

.IP "\fBHome, End\fP"
پیمایش به ابتدا یا انتهای تاریخچهٔ گفتگو. این میان‌بر تنها زمانی کار می‌کند که فیلد ورودی پیام در حالت تمرکز نباشد.

.SH "دستورهای گفتگو (CHAT COMMANDS)"
این دستورها در پنجرهٔ گفتگو قابل استفاده هستند.
.IP "\fB/alias\fP <alias>"
نام مستعار دوست انتخاب‌شده را به <alias> تغییر می‌دهد. این نام به جای نام واقعی آن دوست نمایش داده خواهد شد.
.IP "\fB/invite\fP <name>"
دعوت از <name> به گفتگوی گروهی جاری.
.IP "\fB/sendfile\fP <path>"
ارسال فایلی واقع در <path> به دوست فعلی.
.IP "\fB/topic\fP <topic>"
تغییر نام/موضوع گفتگوی گروهی جاری به <topic>. این دستور همچنین می‌تواند با تایپ \fB/topic\fP و فشردن کلید Tab برای ویرایش موضوع فعلی استفاده شود.
.IP "\fB/me\fP <action>"
ارسال یک پیام/کنش در قالب <action> <name>؛ برای نمونه: Tox User says hi

.SH "فایل‌ها (FILES)"
تمامی فایل‌های ذکرشده در زیر در مسیر \fB$HOME/.config/tox\fP قرار دارند. اگر µTox در حالت قابل‌حمل (portable) اجرا شود، مکان آن‌ها \fB./tox\fP خواهد بود.
.IP \fBtox_save.tox\fP
فایل \fBtox_save.tox\fP فایلی است که جفت‌کلید عمومی/خصوصی، نام، وضعیت و مخاطبان را در بر دارد. این فایل با سایر کلاینت‌های Tox سازگار است.
.IP \fButox_save\fP
فایل \fButox_save\fP فایل پیکربندی دودویی (باینری) µTox است که شامل تنظیماتی مانند زبان، گزینه‌های پراکسی، DPI یا ثبت گزارش‌ها (logging) است.
.IP \fBavatars\fP
دایرکتوری \fBavatars\fP حاوی تصویر نمایهٔ (آواتار) سایر مخاطبان است. نام‌گذاری فایل‌ها بر اساس کلید عمومی مخاطبان (۶۴ نویسهٔ اول شناسه) انجام شده است.
.IP \fBTox_Auto_Accept\fP
دایرکتوری پیش‌فرض برای ذخیرهٔ فایل‌های پذیرفته‌شدهٔ خودکار در حالت قابل‌حمل.
.IP "\fB[public key].txt\fP"
این فایل‌ها تاریخچهٔ گفتگوی دوستان هستند. در حال حاضر µTox تنها از ثبت گفتگوهای یک‌به‌یک (1v1) پشتیبانی می‌کند.
.IP "\fB[public key].fmetadata\fP"
فایل فرادادهٔ دوست که در حال حاضر برای ذخیره‌سازی نام‌های مستعار استفاده می‌شود.
.IP "\fB[public key][file number].ftoutfo\fP"
وضعیت انتقال فایل‌های خروجی جاری. برای ازسرگیری فرایند انتقال پس از راه‌اندازی مجدد کلاینت استفاده می‌شود.

.SH "مشارکت‌کنندگان (CONTRIBUTORS)"
لطفاً صفحهٔ فهرست مشارکت‌کنندگان را مشاهده کنید:
.I https://github.com/uTox/uTox/graphs/contributors

.SH "گزارش باگ‌ها (BUGS)"
لطفاً خطاها و اشکالات را در این نشانی گزارش دهید:
.I https://github.com/uTox/uTox/issues

کد منبع
.B µTox
در نشانی زیر در دسترس است:
.I https://github.com/uTox/uTox