Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
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 acoustic 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

	   show_connection_msg
	       Enable friend connection	change notifications. true or false

	   nodelist_update_freq
	       How often in days to update the DHT nodes list. (0 to disable
	       updates)

	   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.

		   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.

	   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)

	   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.

       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.

	   toggle_paste_mode
	       Toggle treating linebreaks as enter key press.

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/JFreegman/toxic

       IRC channel: chat.freenode.net#tox

AUTHORS
       JFreegman <JFreegman@gmail.com>

toxic				  2016-09-20			 TOXIC.CONF(5)

NAME | SYNOPSIS | DESCRIPTION | EXAMPLE | OPTIONS | FILES | SEE ALSO | RESOURCES | AUTHORS

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=toxic.conf&sektion=5&manpath=FreeBSD+12.2-RELEASE+and+Ports>

home | help