Configuration file

List of options for config file:

OptionTypeValuesDefaultDescription
look_save_on_exitboolean'on' or 'off''on'Save config file on exit
look_set_titleboolean'on' or 'off''on'Set title for window (terminal for Curses GUI) with name and version
look_startup_logoboolean'on' or 'off''on'Display WeeChat logo at startup
look_startup_versionboolean'on' or 'off''on'Display WeeChat version at startup
look_weechat_sloganstringany string'the geekest IRC client!'WeeChat slogan (if empty, slogan is not used)
look_charset_decode_isostringany string'ISO-8859-1'ISO charset for decoding messages from server (used only if locale is UTF-8) (if empty, messages are not converted if locale is UTF-8)
look_charset_decode_utfstringany string'UTF-8'UTF charset for decoding messages from server (used only if locale is not UTF-8) (if empty, messages are not converted if locale is not UTF-8)
look_charset_encodestringany string''Charset for encoding messages sent to server, examples: UTF-8, ISO-8859-1 (if empty, messages are not converted)
look_charset_internalstringany string''Forces internal WeeChat charset (should be empty in most cases, that means detected charset is used)
look_one_server_bufferboolean'on' or 'off''off'Use same buffer for all servers
look_open_near_serverboolean'on' or 'off''off'Open new channels/privates near server
look_scroll_amountintegerbetween 1 and 21474836473How many lines to scroll by with scroll_up and scroll_down
look_buffer_timestampstringany string'[%H:%M:%S]'Timestamp for buffers
look_color_nicks_numberintegerbetween 1 and 1010Number of colors to use for nicks colors
look_color_actionsboolean'on' or 'off''on'Display actions with different colors
look_nicklistboolean'on' or 'off''on'Display nicklist window (for channel windows)
look_nicklist_positionstring'left', 'right', 'top', 'bottom''right'Nicklist position (top, left, right (default), bottom)
look_nicklist_min_sizeintegerbetween 0 and 1000Min size for nicklist (width or height, depending on look_nicklist_position (0 = no min size))
look_nicklist_max_sizeintegerbetween 0 and 1000Max size for nicklist (width or height, depending on look_nicklist_position (0 = no max size; if min == max and > 0, then size is fixed))
look_no_nicknamestringany string'-cmd-'Text to display instead of nick when not connected
look_nickmodeboolean'on' or 'off''on'Display nick mode ((half)op/voice) before each nick
look_nickmode_emptyboolean'on' or 'off''off'Display space if nick mode is not (half)op/voice
look_nick_prefixstringany string''Text to display before nick in chat window
look_nick_suffixstringany string' |'Text to display after nick in chat window
look_align_nickstring'none', 'left', 'right''right'Nick alignment (fixed size for nicks in chat window (none, left, right))
look_align_otherboolean'on' or 'off''on'Alignment for other messages (not beginning with a nick)
look_align_sizeintegerbetween 8 and 6414Size for aligning nick and other messages
look_align_size_maxintegerbetween 8 and 6420Max size for aligning nick and other messages (should be >= to look_align_size)
look_nick_completorstringany string':'The string inserted after nick completion
look_nick_completion_ignorestringany string'[]-^'Chars ignored for nick completion
look_nick_complete_firstboolean'on' or 'off''off'Complete only with first nick found
look_infobarboolean'on' or 'off''on'Enable info bar
look_infobar_timestampstringany string'%B, %A %d %Y'Timestamp for time in infobar
look_infobar_secondsboolean'on' or 'off''on'Display seconds in infobar time
look_infobar_delay_highlightintegerbetween 0 and 21474836477Delay (in seconds) for highlight messages in infobar (0 = disable highlight notifications in infobar)
look_hotlist_names_countintegerbetween 0 and 323Max number of names in hotlist (0 = no name displayed, only buffer numbers)
look_hotlist_names_levelintegerbetween 1 and 1512Level for displaying names in hotlist (combination of: 1=join/part, 2=message, 4=private, 8=highlight, for example: 12=private+highlight)
look_hotlist_names_lengthintegerbetween 0 and 320Max length of names in hotlist (0 = no limit)
look_day_changeboolean'on' or 'off''on'Display special message when day changes
look_day_change_timestampstringany string'%a, %d %b %Y'Timestamp for date displayed when day changed
look_read_markerstringany string' 'Use a marker on servers/channels to show first unread line
look_input_formatstringany string'[%n(%m)] 'Format for input prompt ('%c' is replaced by channel or server, '%n' by nick and '%m' by nick modes)
col_real_whiteboolean'on' or 'off''off'If set, uses real white color, disabled by default for terms with white background (if you never use white background, you should turn on this option to see real white instead of default term foreground color)
col_separatorcolorCurses or Gtk color'blue'Color for window separators (when splited)
col_titlecolorCurses or Gtk color'default'Color for title bar
col_title_bgcolorCurses or Gtk color'blue'Background for title bar
col_chatcolorCurses or Gtk color'default'Color for chat text
col_chat_timecolorCurses or Gtk color'default'Color for time in chat window
col_chat_time_sepcolorCurses or Gtk color'brown'Color for time separator (chat window)
col_chat_prefix1colorCurses or Gtk color'lightcyan'Color for 1st and 3rd char of prefix
col_chat_prefix2colorCurses or Gtk color'white'Color for middle char of prefix
col_chat_servercolorCurses or Gtk color'brown'Color for server name
col_chat_joincolorCurses or Gtk color'lightgreen'Color for join arrow (prefix)
col_chat_partcolorCurses or Gtk color'lightred'Color for part/quit arrow (prefix)
col_chat_nickcolorCurses or Gtk color'lightcyan'Color for nicks in actions (chat window)
col_chat_hostcolorCurses or Gtk color'cyan'Color for hostnames (chat window)
col_chat_channelcolorCurses or Gtk color'white'Color for channel names in actions (chat window)
col_chat_darkcolorCurses or Gtk color'green'Color for dark separators (chat window)
col_chat_highlightcolorCurses or Gtk color'yellow'Color for highlighted nick (chat window)
col_chat_bgcolorCurses or Gtk color'default'Background for chat window
col_chat_read_markercolorCurses or Gtk color'yellow'Color for unread data marker
col_chat_read_marker_bgcolorCurses or Gtk color'magenta'Background for unread data marker
col_statuscolorCurses or Gtk color'default'Color for status bar
col_status_delimiterscolorCurses or Gtk color'cyan'Color for status bar delimiters
col_status_channelcolorCurses or Gtk color'white'Color for current channel in status bar
col_status_data_msgcolorCurses or Gtk color'yellow'Color for window with new messages (status bar)
col_status_privatecolorCurses or Gtk color'lightmagenta'Color for window with private message (status bar)
col_status_highlightcolorCurses or Gtk color'lightred'Color for window with highlight (status bar)
col_status_data_othercolorCurses or Gtk color'default'Color for window with new data (not messages) (status bar)
col_status_morecolorCurses or Gtk color'white'Color for window with new data (status bar)
col_status_bgcolorCurses or Gtk color'blue'Background for status window
col_infobarcolorCurses or Gtk color'black'Color for info bar text
col_infobar_delimiterscolorCurses or Gtk color'blue'Color for infobar delimiters
col_infobar_highlightcolorCurses or Gtk color'white'Color for info bar highlight notification
col_infobar_bgcolorCurses or Gtk color'cyan'Background for info bar window
col_inputcolorCurses or Gtk color'default'Color for input text
col_input_servercolorCurses or Gtk color'brown'Color for input text (server name)
col_input_channelcolorCurses or Gtk color'white'Color for input text (channel name)
col_input_nickcolorCurses or Gtk color'lightcyan'Color for input text (nick name)
col_input_delimiterscolorCurses or Gtk color'cyan'Color for input text (delimiters)
col_input_bgcolorCurses or Gtk color'default'Background for input window
col_nickcolorCurses or Gtk color'default'Color for nicknames
col_nick_awaycolorCurses or Gtk color'cyan'Color for away nicknames
col_nick_chanownercolorCurses or Gtk color'lightgreen'Color for chan owner symbol (specific to unrealircd)
col_nick_chanadmincolorCurses or Gtk color'lightgreen'Color for chan admin symbol (specific to unrealircd)
col_nick_opcolorCurses or Gtk color'lightgreen'Color for operator symbol
col_nick_halfopcolorCurses or Gtk color'lightmagenta'Color for half-operator symbol
col_nick_voicecolorCurses or Gtk color'yellow'Color for voice symbol
col_nick_morecolorCurses or Gtk color'lightmagenta'Color for '+' when scrolling nicks
col_nick_sepcolorCurses or Gtk color'blue'Color for nick separator
col_nick_selfcolorCurses or Gtk color'white'Color for local nick
col_nick_color1colorCurses or Gtk color'cyan'Color for nick
col_nick_color2colorCurses or Gtk color'magenta'Color for nick
col_nick_color3colorCurses or Gtk color'green'Color for nick
col_nick_color4colorCurses or Gtk color'brown'Color for nick
col_nick_color5colorCurses or Gtk color'lightblue'Color for nick
col_nick_color6colorCurses or Gtk color'default'Color for nick
col_nick_color7colorCurses or Gtk color'lightcyan'Color for nick
col_nick_color8colorCurses or Gtk color'lightmagenta'Color for nick
col_nick_color9colorCurses or Gtk color'lightgreen'Color for nick
col_nick_color10colorCurses or Gtk color'blue'Color for nick
col_nick_privatecolorCurses or Gtk color'default'Color for other nick in private window
col_nick_bgcolorCurses or Gtk color'default'Background for nicknames
col_chat_dcc_selectedcolorCurses or Gtk color'white'Color for selected DCC (chat window)
col_dcc_waitingcolorCurses or Gtk color'lightcyan'Color for "waiting" dcc status
col_dcc_connectingcolorCurses or Gtk color'yellow'Color for "connecting" dcc status
col_dcc_activecolorCurses or Gtk color'lightblue'Color for "active" dcc status
col_dcc_donecolorCurses or Gtk color'lightgreen'Color for "done" dcc status
col_dcc_failedcolorCurses or Gtk color'lightred'Color for "failed" dcc status
col_dcc_abortedcolorCurses or Gtk color'lightred'Color for "aborted" dcc status
history_max_linesintegerbetween 0 and 21474836474096Maximum number of lines in history for one server/channel/private window (0 = unlimited)
history_max_commandsintegerbetween 0 and 2147483647100Maximum number of user commands in history (0 = unlimited)
history_display_defaultintegerbetween 0 and 21474836475Maximum number of commands to display by default in history listing (0 = unlimited)
log_auto_serverboolean'on' or 'off''off'Automatically log server messages
log_auto_channelboolean'on' or 'off''off'Automatically log channel chats
log_auto_privateboolean'on' or 'off''off'Automatically log private chats
log_plugin_msgboolean'on' or 'off''off'Log messages from plugins (scripts)
log_pathstringany string'%h/logs/'Path for WeeChat log files ('%h' will be replaced by WeeChat home, ~/.weechat by default)
log_timestampstringany string'%Y %b %d %H:%M:%S'Timestamp for log (see man strftime for date/time specifiers)
log_hide_nickserv_pwdboolean'on' or 'off''on'Hide password displayed by nickserv
irc_display_awaystring'off', 'local', 'channel''off'Display message when (un)marking as away
irc_show_away_onceboolean'on' or 'off''on'Show remote away message only once in private
irc_default_msg_partstringany string'WeeChat %v'Default part message (leaving channel) ('%v' will be replaced by WeeChat version in string)
irc_default_msg_quitstringany string'WeeChat %v'Default quit message ('%v' will be replaced by WeeChat version in string)
irc_notice_as_pvboolean'on' or 'off''off'Display notices as private messages
irc_away_checkintegerbetween 0 and 21474836470Interval between two checks for away (in minutes, 0 = never check)
irc_away_check_max_nicksintegerbetween 0 and 21474836470Do not check away nicks on channels with high number of nicks (0 = unlimited)
irc_lag_checkintegerbetween 30 and 214748364760Interval between two checks for lag (in seconds)
irc_lag_min_showintegerbetween 0 and 21474836471Minimum lag to show (in seconds)
irc_lag_disconnectintegerbetween 0 and 21474836475Disconnect after important lag (in minutes, 0 = never disconnect)
irc_fifo_pipeboolean'on' or 'off''off'Create a FIFO pipe for remote control
irc_highlightstringany string''Comma separated list of words to highlight (case insensitive comparison, words may begin or end with "*" for partial match)
irc_colors_receiveboolean'on' or 'off''on'When off, colors codes are ignored in incoming messages
irc_colors_sendboolean'on' or 'off''on'Allow user to send colors with special codes (%B=bold, %Cxx,yy=color, %U=underline, %R=reverse)
dcc_auto_accept_filesboolean'on' or 'off''off'Automatically accept incoming dcc files
dcc_auto_accept_chatsboolean'on' or 'off''off'Automatically accept dcc chats (use carefully!)
dcc_timeoutintegerbetween 5 and 2147483647300Timeout for dcc request (in seconds)
dcc_blocksizeintegerbetween 1024 and 10240065536Block size for dcc packets in bytes (default: 65536)
dcc_fast_sendboolean'on' or 'off''on'Does not wait for ACK when sending file
dcc_port_rangestringany string''Restricts outgoing dcc to use only ports in the given range (useful for NAT) (syntax: a single port, ie. 5000 or a port range, ie. 5000-5015, empty value means any port)
dcc_own_ipstringany string''IP or DNS address used for outgoing dcc (if empty, local interface IP is used)
dcc_download_pathstringany string'%h/dcc'Path for writing incoming files with dcc (default: user home)
dcc_upload_pathstringany string'~'Path for reading files when sending thru dcc (when no path is specified)
dcc_convert_spacesboolean'on' or 'off''on'Convert spaces to underscores when sending files
dcc_auto_renameboolean'on' or 'off''on'Rename incoming files if already exists (add '.1', '.2', ...)
dcc_auto_resumeboolean'on' or 'off''on'Automatically resume dcc transfer if connection with remote host is loosed
proxy_useboolean'on' or 'off''off'Use a proxy server to connect to irc server
proxy_typestring'http', 'socks4', 'socks5''http'Proxy type (http (default), socks4, socks5)
proxy_ipv6boolean'on' or 'off''off'Connect to proxy in ipv6
proxy_addressstringany string''Proxy server address (IP or hostname)
proxy_portintegerbetween 0 and 655353128Port for connecting to proxy server
proxy_usernamestringany string''Username for proxy server
proxy_passwordstringany string''Password for proxy server
plugins_pathstringany string'%h/plugins'Path for searching plugins ('%h' will be replaced by WeeChat home, ~/.weechat by default)
plugins_autoloadstringany string'*'Comma separated list of plugins to load automatically at startup, "*" means all plugins found (names may be partial, for example "perl" is ok for "libperl.so")
plugins_extensionstringany string'.so'Standard plugins extension in filename, used for autoload (if empty, then all files are loaded when autoload is "*")
server_namestringany string''Name associated to IRC server (for display only)
server_autoconnectboolean'on' or 'off''on'Automatically connect to server when WeeChat is starting
server_autoreconnectboolean'on' or 'off''on'Automatically reconnect to server when disconnected
server_autoreconnect_delayintegerbetween 0 and 6553530Delay (in seconds) before trying again to reconnect to server
server_addressstringany string''IP address or hostname of IRC server
server_portintegerbetween 0 and 655356667Port for connecting to server
server_ipv6boolean'on' or 'off''off'Use IPv6 protocol for server communication
server_sslboolean'on' or 'off''off'Use SSL for server communication
server_passwordstringany string''Password for IRC server
server_nick1stringany string''Nickname to use on IRC server
server_nick2stringany string''Alternate nickname to use on IRC server (if nickname is already used)
server_nick3stringany string''2nd alternate nickname to use on IRC server (if alternate nickname is already used)
server_usernamestringany string''User name to use on IRC server
server_realnamestringany string''Real name to use on IRC server
server_hostnamestringany string''Custom hostname/IP for server (optional, if empty local hostname is used)
server_commandstringany string''Command(s) to run when connected to server (many commands should be separated by ';', use '\;' for a semicolon)
server_command_delayintegerbetween 0 and 50Delay (in seconds) after command was executed (example: give some time for authentication)
server_autojoinstringany string''Comma separated list of channels to join when connected to server (example: "#chan1,#chan2,#chan3 key1,key2")
server_autorejoinboolean'on' or 'off''on'Automatically rejoin channels when kicked
server_notify_levelsstringany string''Comma separated list of notify levels for channels of this server (format: #channel:1,..)
server_charset_decode_isostringany string''Comma separated list of charsets for server and channels, to decode ISO (format: server:charset,#channel:charset,..)
server_charset_decode_utfstringany string''Comma separated list of charsets for server and channels, to decode UTF (format: server:charset,#channel:charset,..)
server_charset_encodestringany string''Comma separated list of charsets for server and channels, to encode messages (format: server:charset,#channel:charset,..)

Colors for Curses GUI are:

KeywordColor
defaultdefault color (transparent for background)
blackblack
reddark red
lightredlight red
greendark green
lightgreenlight green
brownbrown
yellowyellow
bluedark blue
lightbluelight blue
magentadark magenta
lightmagentalight magenta
cyandark cyan
lightcyanlight cyan
whitewhite