TOXIC.CONF(5)                    Toxic Manual                    TOXIC.CONF(5)

نام (NAME)
       toxic.conf - فایل پیکربندی برای toxic

خلاصه دستور (SYNOPSIS)
       ~/.config/tox/toxic.conf

توضیحات (DESCRIPTION)
       فایل toxic.conf، فایل پیکربندی اصلی برای کلاینت toxic(1) است. این فایل
       از نحو پذیرفته‌شده توسط libconfig استفاده می‌کند. خطوطی که با «//» آغاز
       می‌شوند، توضیحات (کامنت) هستند و نادیده گرفته خواهند شد.

مثال (EXAMPLE)
           // پیکربندی رابط کاربری
           ui = {
               timestamps = true;
               alerts = false;
           };

           // پیکربندی صدا
           audio = {
               input_device = 1;
           };

گزینه‌ها (OPTIONS)
       ui
           پیکربندی مربوط به عناصر رابط کاربری.

           timestamps
               فعال یا غیرفعال کردن برچسب‌های زمانی. true یا false

           time_format
               انتخاب میان قالب زمانی ۲۴ ساعته و ۱۲ ساعته. ۲۴ یا ۱۲ را مشخص
               کنید. تنظیم timestamp_format و log_timestamp_format این تنظیم
               را لغو خواهد کرد.

           timestamp_format
               رشته قالب زمان برای رابط کاربری که درون گیومه دوتایی قرار
               می‌گیرد.  date(1) را ببینید.

           log_timestamp_format
               رشته قالب زمان برای لاگ‌گیری که درون گیومه دوتایی قرار می‌گیرد.
               (توجه: بخش زمان رشته قالب باید درون کروشه قرار گیرد تا توسط
               toxic تجزیه شود).  date(1) را ببینید.

           alerts
               فعال یا غیرفعال کردن هشدارهای صوتی هنگام رویدادها. true یا
               false

           show_notification_content
               نمایش محتوای اعلان‌های دسکتاپ. true یا false

           native_colors
               انتخاب میان رنگ‌های بومی ترمینال و تم رنگی toxic. true یا false

           color_bar_bg
               تنظیم رنگ پس‌زمینه نوارهای وضعیت گفتگو. (black، white، gray،
               brown، red، green، blue، cyan، yellow، magenta، orange، pink)

           color_bar_fg
               تنظیم رنگ پیش‌زمینه (متن) نوارهای وضعیت گفتگو. (black، white،
               gray، brown، red، green، blue، cyan، yellow، magenta، orange،
               pink)

           color_bar_accent
               تنظیم رنگ اکسنت (تأکیدی) پیش‌زمینه نوارهای وضعیت گفتگو. (black،
               white، gray، brown، red، green، blue، cyan، yellow، magenta،
               orange، pink)

           color_bar_notify
               تنظیم رنگ پیش‌زمینه اعلان (و در حال نوشتن) در نوار وضعیت گفتگو.
               (black، white، gray، brown، red، green، blue، cyan، yellow،
               magenta، orange، pink)

           autolog
               فعال یا غیرفعال کردن ثبت خودکار وقایع (لاگ‌گیری). true یا false

           show_typing_other
               نمایش در حال تایپ بودن دیگران در گفتگوی دونفره (۱ به ۱). true
               یا false

           show_typing_self
               نمایش در حال تایپ بودن شما برای دیگران در گفتگوی دونفره (۱ به
               ۱). true یا false

           show_welcome_msg
               نمایش پیام خوش‌آمدگویی هنگام راه‌اندازی. true یا false

           show_connection_msg
               فعال کردن اعلان‌های تغییر وضعیت اتصال دوستان. true یا false

           show_group_connection_msg
               فعال کردن اعلان‌های تغییر وضعیت اتصال گروه. true یا false

           show_network_info
               نمایش اطلاعات شبکه در پنجره اصلی رابط کاربری. true یا false
               (تنها در صورتی در دسترس است که toxic با قابلیت‌های آزمایشی فعال
               کامپایل شده باشد)

           nodelist_update_freq
               بسامد به‌روزرسانی فهرست گره‌های DHT بر حسب روز. (عدد صحیح؛ 0 برای
               غیرفعال کردن)

           autosave_freq
               بسامد ذخیره خودکار فایل داده Tox بر حسب ثانیه. (عدد صحیح؛ 0
               برای غیرفعال کردن)

           history_size
               حداکثر تعداد خطوط تاریخچه پنجره گفتگو. مقدار عددی صحیح. (به
               عنوان مثال: 700)

           notification_timeout
               مدت زمان نمایش اعلان بر حسب میلی‌ثانیه. مقدار عددی صحیح. (به
               عنوان مثال: 3000)

           line_join
               نشانگر زمان اتصال یا پیوستن شخصی به یک گروه. حداکثر ۳ نویسه
               برای تنظیمات line_.

           line_quit
               نشانگر زمان قطع اتصال یا خروج شخصی از یک گروه.

           line_alert
               نشانگر پیام‌های هشدار.

           line_normal
               نشانگر پیام‌های عادی.

           line_padding
               پر کردن هر خط شکسته‌شده از پیام با فاصله‌های کافی برای تراز کردن
               آن با ابتدای خط نخست. true یا false

           mplex_away
               تنظیم وضعیت کاربر هنگام اتصال به و قطع اتصال از GNU screen یا
               tmux. true یا false

           mplex_away_note
               پیام وضعیتی که هنگام تنظیم وضعیت روی away به دلیل جدا شدن
               (detach) از screen/tmux تنظیم می‌شود. هنگام اتصال مجدد (attach)،
               پیام وضعیت به مقدار اولیه بازگردانده می‌شود.

           group_part_message
               پیام خروجی که هنگام ترک گروه برای همه اعضای گفتگوی گروهی ارسال
               خواهد شد.

                   گزینه‌های زیر کنترل می‌کنند که آیا در رویدادهای مشخص، زنگ ترمینال (terminal bell) به صدا درآید یا خیر.
                   برخی ترمینال‌ها هنگام دریافت زنگ، پنجره را به عنوان فوری (urgent) علامت‌گذاری می‌کنند. پنجره‌های فوری معمولاً در نوار وظیفه برجسته می‌شوند و حتی برخی مدیر پنجره‌ها کلیدهای میانبری برای رفتن به پنجره فوری بعدی ارائه می‌دهند.
                   این گزینه‌ها بر گزینه "alerts" تأثیری ندارند.

           bell_on_message
               فعال/غیرفعال کردن زنگ ترمینال هنگام دریافت پیام. true یا false

           bell_on_filetrans
               فعال/غیرفعال کردن زنگ ترمینال هنگام دریافت انتقال فایل. true یا
               false

           bell_on_filetrans_accept
               فعال/غیرفعال کردن زنگ ترمینال زمانی که یک انتقال فایل پذیرفته
               شد. true یا false

           bell_on_invite
               فعال/غیرفعال کردن زنگ ترمینال هنگام دریافت دعوت به گروه/تماس.
               true یا false

       audio
           پیکربندی مربوط به دستگاه‌های صوتی.

           input_device
               دستگاه ورودی صوتی. مقدار عددی صحیح. این عدد متناظر است با
               /lsdev in

           output_device
               دستگاه خروجی صوتی. مقدار عددی صحیح. این عدد متناظر است با
               /lsdev out

           VAD_threshold
               آستانه تشخیص فعالیت صوتی (VAD). مقدار ممیز شناور. مقادیر
               پیشنهادی ۱.۰-۴۰.۰ است.

           conference_audio_channels
               تعداد کانال‌ها برای پخش صوتی کنفرانس. مقدار عددی صحیح. 1 (مونو)
               یا 2 (استریو)

           chat_audio_channels
               تعداد کانال‌ها برای پخش صوتی گفتگوی دونفره (۱ به ۱). مقدار عددی
               صحیح. 1 (مونو) یا 2 (استریو)

           push_to_talk
               فعال/غیرفعال کردن فشار دادن برای صحبت (Push-To-Talk) برای
               گفتگوهای صوتی کنفرانس (کلید فعال‌ساز F2 است). true یا false

       tox
           پیکربندی مربوط به مسیرها.

           download_path
               مسیر پیش‌فرض برای بارگیری‌ها. مقدار رشته‌ای. مسیر مطلق برای
               فایل‌های بارگیری‌شده.

           avatar_path
               مسیر آواتار (تصویر نمایه) شما (فایل باید png. باشد و نباید از
               ۱۶.۳ کیلوبایت بیشتر شود)

           autorun_path
               مسیر هرگونه اسکریپتی که باید هنگام راه‌اندازی اجرا شود

           chatlogs_path
               مسیر پیش‌فرض برای تاریخچه گفتگوها (chatlogs). مقدار رشته‌ای. مسیر
               مطلق برای فایل‌های تاریخچه گفتگو.

           password_eval
               جایگزینی اعلان گذرواژه با اجرای این دستور و استفاده از خروجی آن
               به عنوان گذرواژه.

       friends
           تنظیمات اختصاصی دوستان (دارای اولویت بالاتر نسبت به تنظیمات سراسری)

           alias
               تنظیم نام مستعار برای این دوست. مقدار رشته‌ای.

           auto_accept_files
               فعال یا غیرفعال کردن پذیرش خودکار انتقال فایل‌های ورودی. true یا
               false

           autolog
               فعال یا غیرفعال کردن ثبت خودکار وقایع (لاگ‌گیری). true یا false

           show_connection_msg
               فعال کردن اعلان‌های تغییر وضعیت اتصال. true یا false

           tab_name_colour
               رنگ نام برگه (تب) پنجره دوست. (black، white، gray، brown، red،
               green، blue، cyan، yellow، magenta، orange، pink)

       groupchats
           تنظیمات اختصاصی گفتگوی گروهی (دارای اولویت بالاتر نسبت به تنظیمات
           سراسری)

           autolog
               فعال یا غیرفعال کردن ثبت خودکار وقایع (لاگ‌گیری). true یا false

           tab_name_colour
               رنگ نام برگه (تب) پنجره گروه. (black، white، gray، brown، red،
               green، blue، cyan، yellow، magenta، orange، pink)

       conferences
           تنظیمات اختصاصی کنفرانس (دارای اولویت بالاتر نسبت به تنظیمات
           سراسری)

           autolog
               فعال یا غیرفعال کردن ثبت خودکار وقایع (لاگ‌گیری). true یا false

           tab_name_colour
               رنگ نام برگه (تب) پنجره کنفرانس. (black، white، gray، brown،
               red، green، blue، cyan، yellow، magenta، orange، pink)

       blocked_words
           فهرستی از واژگان ناوابسته به بزرگی و کوچکی حروف (case-insensitive)
           که نمی‌توانند در پیام‌ها ارسال شوند. مقدار رشته‌ای. باید درون گیومه
           دوتایی قرار گیرد و حداکثر ۲۵۶ نویسه باشد.

       sounds
           پیکربندی مربوط به صداهای اعلان. مقدار ویژه "silent" می‌تواند برای
           غیرفعال کردن یک اعلان خاص استفاده شود.

           هر مقدار رشته‌ای است که متناظر با مسیر مطلق یک فایل صوتی wav است.

           notif_error
               صدایی که هنگام رخ دادن یک خطا پخش می‌شود.

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

           self_log_out
               صدایی که هنگام خروج شما از سیستم پخش می‌شود.

           user_log_in
               صدایی که هنگام برخط (آنلاین) شدن یک مخاطب پخش می‌شود.

           user_log_out
               صدایی که هنگام برون‌خط (آفلاین) شدن یک مخاطب پخش می‌شود.

           call_incoming
               صدایی که هنگام دریافت یک تماس ورودی پخش می‌شود.

           call_outgoing
               صدایی که هنگام برقراری یک تماس خروجی پخش می‌شود.

           generic_message
               صدایی که هنگام رخ دادن یک رویداد پخش می‌شود.

           transfer_pending
               صدایی که هنگام دریافت درخواست انتقال فایل پخش می‌شود.

           transfer_completed
               صدایی که هنگام تکمیل انتقال فایل پخش می‌شود.

       keys
           پیکربندی مربوط به تعامل با رابط کاربری. موارد پشتیبانی‌شده کنونی:
           کلیدهای ترکیبی با Ctrl، کلید Tab، کلیدهای PAGEUP و PAGEDOWN.

           هر مقدار رشته‌ای است که با یک ترکیب کلید متناظر است.

           next_tab
               ترکیب کلید برای رفتن به برگه (تب) بعدی.

           prev_tab
               ترکیب کلید برای رفتن به برگه (تب) قبلی.

           scroll_line_up
               ترکیب کلید برای پیمایش یک خط به بالا.

           scroll_line_down
               ترکیب کلید برای پیمایش یک خط به پایین.

           half_page_up
               ترکیب کلید برای پیمایش نیم‌صفحه به بالا.

           half_page_down
               ترکیب کلید برای پیمایش نیم‌صفحه به پایین.

           page_bottom
               ترکیب کلید برای پیمایش به انتهای صفحه.

           toggle_peerlist
               فعال یا غیرفعال کردن نمایش فهرست همتایان (peers).

           toggle_paste_mode
               تغییر حالت تلقی شکستن خط به عنوان فشردن کلید Enter.

           reload_config
               بارگذاری مجدد فایل پیکربندی Toxic.

اشکالات (BUGS)
       -رنگ‌های غیرپیش‌فرض (gray، brown، orange و pink) در شبیه‌سازهای ترمینالی
       که از ۲۵۶ رنگ پشتیبانی نمی‌کنند کار نخواهند کرد. شبیه‌سازهای Konsole،
       qterminal و احتمالاً موارد دیگر نیز دارای مشکلاتی با این رنگ‌ها شناخته
       شده‌اند. اگر از screen یا tmux استفاده می‌کنید، آن را طوری پیکربندی کنید
       که از متغیر محیطی TERM با مقدار xterm-256color استفاده کند.

       -هنگام بارگذاری مجدد فایل پیکربندی در یک نشست فعال، برخی از تغییرات
       رابط کاربری ممکن است دچار اشکال شوند و نیاز به راه‌اندازی مجدد کامل
       کلاینت داشته باشند.

فایل‌ها (FILES)
       ~/.config/tox/toxic.conf
           فایل پیکربندی اصلی.

       /usr/share/toxic/toxic.conf.example
           نمونه فایل پیکربندی.

منابع (RESOURCES)
       صفحه پروژه: https://github.com/JFreegman/toxic

       کلید عمومی گروه توسعه Tox:
       360497DA684BCE2A500C1AF9B3A5CE949BBB9F6FB1F91589806FB04CA039E313

نویسندگان (AUTHORS)
       JFreegman <JFreegman@gmail.com>

همچنین ببینید (SEE ALSO)
       toxic(1)

toxic 0.16.2_r2309                2026-01-16                     TOXIC.CONF(5)