TOXIC.CONF(5)

NAME
toxic.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.

__DATADIR__/toxic.conf.example
    Configuration example.

SEE ALSO

toxic(1)

RESOURCES

Project page: https://github.com/Tox/toxic

IRC channel: chat.freenode.net#tox

AUTHORS

JFreegman <JFreegman@gmail.com>