TOXIC.CONF(5)

📦
version 0.16.3 · 6 versions
, in arch rolling

💖 TOXIC.CONF(5) — Toxic Manual 💖

🌸 NAME 🌸

toxic.conf — the configuration file for toxic(1). This is the toxic.conf(5) page, bestie, and it's literally the control center for your client. 🎀

✨ SYNOPSIS ✨

~/.config/tox/toxic.conf

🦋 DESCRIPTION 🦋

The toxic.conf file is the main configuration file for the toxic(1) client. It uses syntax accepted by libconfig. Lines starting with // are comments and will be ignored. 💅

🎀 EXAMPLE 🎀

// Configuration for interface
ui = {
    timestamps = true;
    alerts = false;
};

// Configuration for audio
audio = {
    input_device = 1;
};

💅 OPTIONS 💅

👑 ui

Configuration related to interface elements. This is where your screen vibes live. ✨

  • timestamps — Enable or disable timestamps. true or false.
  • time_format — Select between 24 and 12 hour time. Specify 24 or 12. Setting timestamp_format and log_timestamp_format will override this setting.
  • timestamp_format — Time format string for the interface enclosed by double quotes. See date(1).
  • log_timestamp_format — Time format string for logging enclosed by double quotes. (Note: the time portion of the format string must be enclosed by square brackets in order to be parsed by toxic). See date(1).
  • alerts — Enable or disable acoustic alerts on events. true or false.
  • show_notification_content — Show the content of desktop notifications. true or false.
  • native_colors — Select between native terminal colors and toxic color theme. true or false.
  • color_bar_bg — Set background color of chat status bars. (black, white, gray, brown, red, green, blue, cyan, yellow, magenta, orange, pink).
  • color_bar_fg — Set foreground (text) color of chat status bars. (black, white, gray, brown, red, green, blue, cyan, yellow, magenta, orange, pink).
  • color_bar_accent — Set foreground accent color of chat status bars. (black, white, gray, brown, red, green, blue, cyan, yellow, magenta, orange, pink).
  • color_bar_notify — Set foreground notify (and typing) color in chat status bar. (black, white, gray, brown, red, green, blue, cyan, yellow, magenta, orange, pink).
  • autolog — Enable or disable autologging. true or false.
  • show_typing_other — Show when others are typing in a 1-on-1 chat. true or false.
  • show_typing_self — Show others when you’re typing in a 1-on-1 chat. true or false.
  • show_welcome_msg — Show welcome message on startup. true or false.
  • show_connection_msg — Enable friend connection change notifications. true or false.
  • show_group_connection_msg — Enable group connection change notifications. true or false.
  • show_network_info — Show network information in the UI home window. true or false (only available if toxic is compiled with experimental features enabled).
  • nodelist_update_freq — How often in days to update the DHT nodes list. (integer; 0 to disable).
  • autosave_freq — How often in seconds to auto-save the Tox data file. (integer; 0 to disable).
  • history_size — Maximum lines for chat window history. Integer value. (for example: 700).
  • notification_timeout — Time in milliseconds to display a notification. Integer value. (for example: 3000).
  • line_join — Indicator for when someone connects or joins a group. Three characters max for line_ settings.
  • line_quit — Indicator for when someone disconnects or leaves a group.
  • line_alert — Indicator for alert messages.
  • line_normal — Indicator for normal messages.
  • line_padding — Pad every wrapped line of a message with enough spaces to align it to the beginning of the first line. true or false.
  • mplex_away — Set user status when attaching and detaching from GNU screen or tmux. true or false.
  • mplex_away_note — Status message to set when status is set to away due to screen/tmux detach. When attaching, the status message is set back to the original value.
  • group_part_message — Parting message that will be sent to all groupchat peers when you leave the group.

The following options control whether to output a terminal bell on certain events. Some terminals mark the window as urgent when a bell is received. Urgent windows are usually highlighted in the taskbar and some window managers even provide shortcuts to jump to the next urgent window. These options don't affect the "alerts" option. 🔔

  • bell_on_message — Enable/Disable the terminal bell when receiving a message. true or false.
  • bell_on_filetrans — Enable/Disable the terminal bell when receiving a filetransfer. true or false.
  • bell_on_filetrans_accept — Enable/Disable the terminal bell when a filetransfer was accepted. true or false.
  • bell_on_invite — Enable/Disable the terminal bell when receiving a group/call invite. true or false.

🎧 audio

Configuration related to audio devices. Mic check, bestie. 🎤

  • input_device — Audio input device. Integer value. Number corresponds to /lsdev in.
  • output_device — Audio output device. Integer value. Number corresponds to /lsdev out.
  • VAD_threshold — Voice Activity Detection threshold. Float value. Recommended values are 1.0-40.0.
  • conference_audio_channels — Number of channels for conference audio broadcast. Integer value. 1 (mono) or 2 (stereo).
  • chat_audio_channels — Number of channels for 1-on-1 audio broadcast. Integer value. 1 (mono) or 2 (stereo).
  • push_to_talk — Enable/Disable Push-To-Talk for conference audio chats (active key is F2). true or false.

🌈 tox

Configuration related to paths. The little map of where your stuff lives. 🗺️

  • download_path — Default path for downloads. String value. Absolute path for downloaded files.
  • avatar_path — Path for your avatar (file must be a .png and cannot exceed 16.3 KiB).
  • autorun_path — Path for any scripts that should be run on startup.
  • chatlogs_path — Default path for chatlogs. String value. Absolute path for chatlog files.
  • password_eval — Replace password prompt by running this command and using its output as the password.

🫶 friends

Friend-specific settings (prioritized over global settings). Per-bestie customization, periodt. 💖

  • alias — Set an alias for this friend. String value.
  • auto_accept_files — Enable or disable auto-accepting inbound file transfers. true or false.
  • autolog — Enable or disable autologging. true or false.
  • show_connection_msg — Enable connection change notifications. true or false.
  • tab_name_colour — The colour of the friend’s tab window name. (black, white, gray, brown, red, green, blue, cyan, yellow, magenta, orange, pink).

🧚 groupchats

Groupchat-specific settings (prioritized over global settings). Group chat energy only. 💬

  • autolog — Enable or disable autologging. true or false.
  • tab_name_colour — The colour of the group’s tab window name. (black, white, gray, brown, red, green, blue, cyan, yellow, magenta, orange, pink).

🦋 conferences

Conference-specific settings (prioritized over global settings). Big-call behavior, slay. 📞

  • autolog — Enable or disable autologging. true or false.
  • tab_name_colour — The colour of the conferences’s tab window name. (black, white, gray, brown, red, green, blue, cyan, yellow, magenta, orange, pink).

🍓 blocked_words

A list of case-insensitive words that cannot be sent in messages. String value. Must be enclosed in double quotes and must be ⇐ 256 characters.

🎵 sounds

Configuration related to notification sounds. Special value "silent" can be used to disable a specific notification. ✨

Each value is a string which corresponds to the absolute path of a wav sound file.

  • notif_error — Sound to play when an error occurs.
  • self_log_in — Sound to play when you log in.
  • self_log_out — Sound to play when you log out.
  • user_log_in — Sound to play when a contact become online.
  • user_log_out — Sound to play when a contact become offline.
  • call_incoming — Sound to play when you receive an incoming call.
  • call_outgoing — Sound to play when you start a call.
  • generic_message — Sound to play when an event occurs.
  • transfer_pending — Sound to play when you receive a file transfer request.
  • transfer_completed — Sound to play when a file transfer is completed.

🎹 keys

Configuration related to user interface interaction. Currently supported: Ctrl modified keys, Tab, PAGEUP and PAGEDOWN. 🫶

Each value is a string which corresponds to a key combination.

  • next_tab — Key combination to switch next tab.
  • prev_tab — Key combination to switch previous tab.
  • scroll_line_up — Key combination to scroll one line up.
  • scroll_line_down — Key combination to scroll one line down.
  • half_page_up — Key combination to scroll half page up.
  • half_page_down — Key combination to scroll half page down.
  • page_bottom — Key combination to scroll to page bottom.
  • toggle_peerlist — Toggle the peer list on and off.
  • toggle_paste_mode — Toggle treating linebreaks as enter key press.
  • reload_config — Reload the Toxic config file.

💀 BUGS 💀

  • -Non-default colours (gray, brown, orange, and pink) will not work on terminal emulators that don’t support 256-colors. Konsole, qterminal and possibly others are also known to have issues with them. If you’re using screen or tmux, try to configure it to use the xterm-256color TERM environment variable.
  • -When reloading the config file during a live session, some UI changes may be buggy and require a full client restart.

🗂️ FILES 🗂️

  • ~/.config/tox/toxic.conf — Main configuration file.
  • /usr/share/toxic/toxic.conf.example — Configuration example.

✨ RESOURCES ✨

okay so bestie, if you wanna go straight to the source (pun fully intended 🫶), here's where the project lives:

and if you're the kind of girlie who likes to verify things cryptographically — which, honestly? iconic behavior — here is the Tox development group's public key, copied exactly, no typos, do not retype it by hand, please:

360497DA684BCE2A500C1AF9B3A5CE949BBB9F6FB1F91589806FB04CA039E313

lowkey that key is giving "trust me bro" energy but in the verifiable way, y'know? 🔐💅

🌸 AUTHORS 🌸

shoutout to the person who made this whole thing happen, main character energy fr fr:

  • JFreegman <JFreegman@gmail.com>

give them a little crown 👑 they earned it.

🦋 SEE ALSO 🦋

if you're hungry for more manual-page content (and honestly? same), go check out:

that's the actual program this config file belongs to, so like... yeah, probably worth a peek. iykyk 💜

that's a wrap, bestie 💖 you officially know everything this page has to say about toxic.conf. now go forth and make your config cute ✨

this was toxic 0.16.3_r2322 vibes, dated 2026-01-16, and that's periodt 🎀

📦 where this page comes from