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

toxic.conf - فایل پیکربندی برای toxic

~/.config/tox/toxic.conf

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

// پیکربندی رابط کاربری
ui = {
    timestamps = true;
    alerts = false;
};
// پیکربندی صدا
audio = {
    input_device = 1;
};

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.

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

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

~/.config/tox/toxic.conf

فایل پیکربندی اصلی.

/usr/share/toxic/toxic.conf.example

نمونه فایل پیکربندی.

صفحه پروژه: https://github.com/JFreegman/toxic

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

JFreegman <JFreegman@gmail.com>

toxic(1)

2026-01-16 toxic 0.16.2_r2309