mirror of
https://github.com/Tha14/toxic.git
synced 2024-11-16 07:43:01 +01:00
421 lines
9.0 KiB
Groff
421 lines
9.0 KiB
Groff
'\" t
|
|
.\" Title: toxic.conf
|
|
.\" Author: [see the "AUTHORS" section]
|
|
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
|
|
.\" Date: 2021-05-24
|
|
.\" Manual: Toxic Manual
|
|
.\" Source: toxic __VERSION__
|
|
.\" Language: English
|
|
.\"
|
|
.TH "TOXIC\&.CONF" "5" "2021\-05\-24" "toxic __VERSION__" "Toxic Manual"
|
|
.\" -----------------------------------------------------------------
|
|
.\" * Define some portability stuff
|
|
.\" -----------------------------------------------------------------
|
|
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
.\" http://bugs.debian.org/507673
|
|
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
|
|
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
.ie \n(.g .ds Aq \(aq
|
|
.el .ds Aq '
|
|
.\" -----------------------------------------------------------------
|
|
.\" * set default formatting
|
|
.\" -----------------------------------------------------------------
|
|
.\" disable hyphenation
|
|
.nh
|
|
.\" disable justification (adjust text to left margin only)
|
|
.ad l
|
|
.\" -----------------------------------------------------------------
|
|
.\" * MAIN CONTENT STARTS HERE *
|
|
.\" -----------------------------------------------------------------
|
|
.SH "NAME"
|
|
toxic.conf \- Configuration file for toxic
|
|
.SH "SYNOPSIS"
|
|
.sp
|
|
~/\&.config/tox/toxic\&.conf
|
|
.SH "DESCRIPTION"
|
|
.sp
|
|
The \fItoxic\&.conf\fR file is the main configuration file for \fBtoxic\fR(1) client\&. It uses syntax accepted by \fBlibconfig\fR\&. Lines starting with "//" are comments and will be ignored\&.
|
|
.SH "EXAMPLE"
|
|
.sp
|
|
.if n \{\
|
|
.RS 4
|
|
.\}
|
|
.nf
|
|
// Configuration for interface
|
|
ui = {
|
|
timestamps = true;
|
|
alerts = false;
|
|
};
|
|
|
|
// Configuration for audio
|
|
audio = {
|
|
input_device = 1;
|
|
};
|
|
.fi
|
|
.if n \{\
|
|
.RE
|
|
.\}
|
|
.SH "OPTIONS"
|
|
.PP
|
|
\fBui\fR
|
|
.RS 4
|
|
Configuration related to interface elements\&.
|
|
.PP
|
|
\fBtimestamps\fR
|
|
.RS 4
|
|
Enable or disable timestamps\&. true or false
|
|
.RE
|
|
.PP
|
|
\fBtime_format\fR
|
|
.RS 4
|
|
Select between 24 and 12 hour time\&. Specify 24 or 12\&. Setting timestamp_format and log_timestamp_format will override this setting\&.
|
|
.RE
|
|
.PP
|
|
\fBtimestamp_format\fR
|
|
.RS 4
|
|
Time format string for the interface enclosed by double quotes\&. See
|
|
\fBdate\fR(1)
|
|
.RE
|
|
.PP
|
|
\fBlog_timestamp_format\fR
|
|
.RS 4
|
|
Time format string for logging enclosed by double quotes\&. See
|
|
\fBdate\fR(1)
|
|
.RE
|
|
.PP
|
|
\fBalerts\fR
|
|
.RS 4
|
|
Enable or disable acoustic alerts on events\&. true or false
|
|
.RE
|
|
.PP
|
|
\fBnative_colors\fR
|
|
.RS 4
|
|
Select between native terminal colors and toxic color theme\&. true or false
|
|
.RE
|
|
.PP
|
|
\fBcolor_bar_bg\fR
|
|
.RS 4
|
|
set background color of chat status bars\&. (black, white, red, green, blue, cyan, yellow, magenta)
|
|
.RE
|
|
.PP
|
|
\fBcolor_bar_fg\fR
|
|
.RS 4
|
|
set foreground (text) color of chat status bars\&. (black, white, red, green, blue, cyan, yellow, magenta)
|
|
.RE
|
|
.PP
|
|
\fBcolor_bar_accent\fR
|
|
.RS 4
|
|
set foreground accent color of chat status bars\&. (black, white, red, green, blue, cyan, yellow, magenta)
|
|
.RE
|
|
.PP
|
|
\fBcolor_bar_notify\fR
|
|
.RS 4
|
|
set foreground notify (and typing) color in chat status bar\&. (black, white, red, green, blue, cyan, yellow, magenta)
|
|
.RE
|
|
.PP
|
|
\fBautolog\fR
|
|
.RS 4
|
|
Enable or disable autologging\&. true or false
|
|
.RE
|
|
.PP
|
|
\fBshow_typing_other\fR
|
|
.RS 4
|
|
Show when others are typing in a 1\-on\-1 chat\&. true or false
|
|
.RE
|
|
.PP
|
|
\fBshow_typing_self\fR
|
|
.RS 4
|
|
Show others when you\(cqre typing in a 1\-on\-1 chat\&. true or false
|
|
.RE
|
|
.PP
|
|
\fBshow_welcome_msg\fR
|
|
.RS 4
|
|
Show welcome message on startup\&. true or false
|
|
.RE
|
|
.PP
|
|
\fBshow_connection_msg\fR
|
|
.RS 4
|
|
Enable friend connection change notifications\&. true or false
|
|
.RE
|
|
.PP
|
|
\fBnodelist_update_freq\fR
|
|
.RS 4
|
|
How often in days to update the DHT nodes list\&. (integer; 0 to disable)
|
|
.RE
|
|
.PP
|
|
\fBautosave_freq\fR
|
|
.RS 4
|
|
How often in seconds to auto\-save the Tox data file\&. (integer; 0 to disable)
|
|
.RE
|
|
.PP
|
|
\fBhistory_size\fR
|
|
.RS 4
|
|
Maximum lines for chat window history\&. Integer value\&. (for example: 700)
|
|
.RE
|
|
.PP
|
|
\fBnotification_timeout\fR
|
|
.RS 4
|
|
Time in milliseconds to display a notification\&. Integer value\&. (for example: 3000)
|
|
.RE
|
|
.PP
|
|
\fBline_join\fR
|
|
.RS 4
|
|
Indicator for when someone connects or joins a group\&. Three characters max for line_ settings\&.
|
|
.RE
|
|
.PP
|
|
\fBline_quit\fR
|
|
.RS 4
|
|
Indicator for when someone disconnects or leaves a group\&.
|
|
.RE
|
|
.PP
|
|
\fBline_alert\fR
|
|
.RS 4
|
|
Indicator for alert messages\&.
|
|
.RE
|
|
.PP
|
|
\fBline_normal\fR
|
|
.RS 4
|
|
Indicator for normal messages\&.
|
|
.RE
|
|
.PP
|
|
\fBmplex_away\fR
|
|
.RS 4
|
|
Set user status when attaching and detaching from GNU screen or tmux\&. true or false
|
|
.RE
|
|
.PP
|
|
\fBmplex_away_note\fR
|
|
.RS 4
|
|
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\&.
|
|
.sp
|
|
.if n \{\
|
|
.RS 4
|
|
.\}
|
|
.nf
|
|
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\*(Aqt affect the "alerts" option\&.
|
|
.fi
|
|
.if n \{\
|
|
.RE
|
|
.\}
|
|
.RE
|
|
.PP
|
|
\fBbell_on_message\fR
|
|
.RS 4
|
|
Enable/Disable the terminal bell when receiving a message\&. true or false
|
|
.RE
|
|
.PP
|
|
\fBbell_on_filetrans\fR
|
|
.RS 4
|
|
Enable/Disable the terminal bell when receiving a filetransfer\&. true or false
|
|
.RE
|
|
.PP
|
|
\fBbell_on_filetrans_accept\fR
|
|
.RS 4
|
|
Enable/Disable the terminal bell when a filetransfer was accepted\&. true or false
|
|
.RE
|
|
.PP
|
|
\fBbell_on_invite\fR
|
|
.RS 4
|
|
Enable/Disable the terminal bell when receiving a group/call invite\&. true or false
|
|
.RE
|
|
.RE
|
|
.PP
|
|
\fBaudio\fR
|
|
.RS 4
|
|
Configuration related to audio devices\&.
|
|
.PP
|
|
\fBinput_device\fR
|
|
.RS 4
|
|
Audio input device\&. Integer value\&. Number corresponds to
|
|
/lsdev in
|
|
.RE
|
|
.PP
|
|
\fBoutput_device\fR
|
|
.RS 4
|
|
Audio output device\&. Integer value\&. Number corresponds to
|
|
/lsdev out
|
|
.RE
|
|
.PP
|
|
\fBVAD_threshold\fR
|
|
.RS 4
|
|
Voice Activity Detection threshold\&. Float value\&. Recommended values are 1\&.0\-40\&.0
|
|
.RE
|
|
.PP
|
|
\fBconference_audio_channels\fR
|
|
.RS 4
|
|
Number of channels for conference audio broadcast\&. Integer value\&. 1 (mono) or 2 (stereo)
|
|
.RE
|
|
.PP
|
|
\fBchat_audio_channels\fR
|
|
.RS 4
|
|
Number of channels for 1\-on\-1 audio broadcast\&. Integer value\&. 1 (mono) or 2 (stereo)
|
|
.RE
|
|
.PP
|
|
\fBpush_to_talk\fR
|
|
.RS 4
|
|
Enable/Disable Push\-To\-Talk for conference audio chats (active key is F2)\&. true or false
|
|
.RE
|
|
.RE
|
|
.PP
|
|
\fBtox\fR
|
|
.RS 4
|
|
Configuration related to paths\&.
|
|
.PP
|
|
\fBdownload_path\fR
|
|
.RS 4
|
|
Default path for downloads\&. String value\&. Absolute path for downloaded files\&.
|
|
.RE
|
|
.PP
|
|
\fBavatar_path\fR
|
|
.RS 4
|
|
Path for your avatar (file must be a \&.png and cannot exceed 16\&.3 KiB)
|
|
.RE
|
|
.PP
|
|
\fBautorun_path\fR
|
|
.RS 4
|
|
Path for any scripts that should be run on startup
|
|
.RE
|
|
.PP
|
|
\fBchatlogs_path\fR
|
|
.RS 4
|
|
Default path for chatlogs\&. String value\&. Absolute path for chatlog files\&.
|
|
.RE
|
|
.PP
|
|
\fBpassword_eval\fR
|
|
.RS 4
|
|
Replace password prompt by running this command and using its output as the password\&.
|
|
.RE
|
|
.RE
|
|
.PP
|
|
\fBsounds\fR
|
|
.RS 4
|
|
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\&.
|
|
.PP
|
|
\fBnotif_error\fR
|
|
.RS 4
|
|
Sound to play when an error occurs\&.
|
|
.RE
|
|
.PP
|
|
\fBself_log_in\fR
|
|
.RS 4
|
|
Sound to play when you log in\&.
|
|
.RE
|
|
.PP
|
|
\fBself_log_out\fR
|
|
.RS 4
|
|
Sound to play when you log out\&.
|
|
.RE
|
|
.PP
|
|
\fBuser_log_in\fR
|
|
.RS 4
|
|
Sound to play when a contact become online\&.
|
|
.RE
|
|
.PP
|
|
\fBuser_log_out\fR
|
|
.RS 4
|
|
Sound to play when a contact become offline\&.
|
|
.RE
|
|
.PP
|
|
\fBcall_incoming\fR
|
|
.RS 4
|
|
Sound to play when you receive an incoming call\&.
|
|
.RE
|
|
.PP
|
|
\fBcall_outgoing\fR
|
|
.RS 4
|
|
Sound to play when you start a call\&.
|
|
.RE
|
|
.PP
|
|
\fBgeneric_message\fR
|
|
.RS 4
|
|
Sound to play when an event occurs\&.
|
|
.RE
|
|
.PP
|
|
\fBtransfer_pending\fR
|
|
.RS 4
|
|
Sound to play when you receive a file transfer request\&.
|
|
.RE
|
|
.PP
|
|
\fBtransfer_completed\fR
|
|
.RS 4
|
|
Sound to play when a file transfer is completed\&.
|
|
.RE
|
|
.RE
|
|
.PP
|
|
\fBkeys\fR
|
|
.RS 4
|
|
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\&.
|
|
.PP
|
|
\fBnext_tab\fR
|
|
.RS 4
|
|
Key combination to switch next tab\&.
|
|
.RE
|
|
.PP
|
|
\fBprev_tab\fR
|
|
.RS 4
|
|
Key combination to switch previous tab\&.
|
|
.RE
|
|
.PP
|
|
\fBscroll_line_up\fR
|
|
.RS 4
|
|
Key combination to scroll one line up\&.
|
|
.RE
|
|
.PP
|
|
\fBscroll_line_down\fR
|
|
.RS 4
|
|
Key combination to scroll one line down\&.
|
|
.RE
|
|
.PP
|
|
\fBhalf_page_up\fR
|
|
.RS 4
|
|
Key combination to scroll half page up\&.
|
|
.RE
|
|
.PP
|
|
\fBhalf_page_down\fR
|
|
.RS 4
|
|
Key combination to scroll half page down\&.
|
|
.RE
|
|
.PP
|
|
\fBpage_bottom\fR
|
|
.RS 4
|
|
Key combination to scroll to page bottom\&.
|
|
.RE
|
|
.PP
|
|
\fBtoggle_peerlist\fR
|
|
.RS 4
|
|
Toggle the peer list on and off\&.
|
|
.RE
|
|
.PP
|
|
\fBtoggle_paste_mode\fR
|
|
.RS 4
|
|
Toggle treating linebreaks as enter key press\&.
|
|
.RE
|
|
.RE
|
|
.SH "FILES"
|
|
.PP
|
|
~/\&.config/tox/toxic\&.conf
|
|
.RS 4
|
|
Main configuration file\&.
|
|
.RE
|
|
.PP
|
|
__DATADIR__/toxic\&.conf\&.example
|
|
.RS 4
|
|
Configuration example\&.
|
|
.RE
|
|
.SH "SEE ALSO"
|
|
.sp
|
|
\fBtoxic\fR(1)
|
|
.SH "RESOURCES"
|
|
.sp
|
|
Project page: https://github\&.com/JFreegman/toxic
|
|
.sp
|
|
IRC channel: irc\&.libera\&.chat#tox
|
|
.SH "AUTHORS"
|
|
.sp
|
|
JFreegman <JFreegman@gmail\&.com>
|