DragonFly On-Line Manual Pages

TOXIC.CONF(5)                    Toxic Manual                    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.

       /usr/local/share/toxic/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>

toxic 0.7.0_r9f0feb7              2015-03-28                     TOXIC.CONF(5)