TOXIC.CONF(5) Toxic Manual TOXIC.CONF(5)NAMEtoxic.conf - Configuration file for toxic
SYNOPSIS
~/.config/tox/toxic.conf
DESCRIPTION
The toxic.conf file is the main configuration file for 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.
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. See
date(1)
alerts
Enable or disable terminal alerts on events. true or false
native_colors
Select between native terminal colors and toxic color theme.
true or false
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
history_size
Maximum lines for chat window history. Integer value. (for
example: 700)
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.
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.
audio
Configuration related to audio devices.
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_treshold
Voice Activity Detection treshold. Float value. Recommended
values are around 40.0
tox
Configuration related to paths.
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)
chatlogs_path
Default path for chatlogs. String value. Absolute path for
chatlog files.
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.
peer_list_up
Key combination to scroll contacts list up.
peer_list_down
Key combination to scroll contacts list down.
toggle_peerlist
Toggle the peer list on and off.
FILES
~/.config/tox/toxic.conf
Main configuration file.
/usr/local/share/toxic/toxic.conf.example
Configuration example.
SEE ALSOtoxic(1)RESOURCES
Project page: https://github.com/Tox/toxic
IRC channel: chat.freenode.net#tox
AUTHORS
JFreegman <JFreegman@gmail.com>
toxic 0.7.0_r9f0feb7 2015-03-28 TOXIC.CONF(5)
