matterhorn/sample-config.ini

[mattermost]
# Username. Optional. If missing, you'll be asked to provide one on
# startup.
# user: <username>

# Hostname: Optional. If missing, you'll be asked to provide one on
# startup.
# host: <hostname>

# If the team setting is set, it must be the name of a team of which
# the user is a member. This is the team you'll automatically use when
# connecting and you'll bypass the team selection. If the setting is
# absent or isn't one of your teams, you'll be prompted for a choice of
# your teams.
#
# team: <team name>

# Server port. Optional; defaults to 443.
#
# port: 443

# Password command. Optional. If this and the password option are both
# missing or give the wrong password, you'll be prompted on startup.
#
# You can also just use
# pass: password
# but this is much less secure than supplying a command or being
# prompted interactively.
#
# For OS X, the built-in security command can be used to get a password
# from the OS X keychain. To make this work you'll need to put your
# Mattermost password into your keychain as follows:
#
# * Open the Keychain application (Applications -> Utilities -> Keychain
#   Access)
# * Click the "login" keychain.
# * If necessary, click the unlock icon at the top-left corner of the
#   window to unlock keychain access.
# * Click the "+" button at the bottom of the window.
# * Enter a keychain item name (e.g. "mattermost"), your Mattermost
#   username, and your password.
# * Click "Add".
#
# Now the keychain item name can be used with the "security" command
# here:
#
# passcmd: security find-generic-password -s <password name> -w
#
# On Linux, there are a number of options.  secret-tool is part of
# libsecret (in libsecret-tools on Ubuntu) and acts as a uniform
# interface to all password managers implementing the LibSecret D-Bus
# API (including kwallet and gnome-keyring).  Assuming that you have
# stored a password using
#
# $ secret-tool store --label='matterhorn' matterhorn password`
#
# You can then set:
#
# passcmd: secret-tool lookup matterhorn password

# This optional setting controls how the client displays times. If it's
# absent, you get the default behavior ("%R"). If it's present but
# empty, that turns timestamps off. Otherwise its value is used as the
# time format string.
#
# The format string is that accepted by 'formatTime':
# https://hackage.haskell.org/package/time-1.6.0.1/docs/Data-Time-Format.html#v:formatTime
#
# timeFormat: %R

# This optional setting controls how the client displays dates. If it's
# absent, you get the default behavior ("%Y-%m-%d"). Otherwise its
# value is used as the time format string.
#
# The format string is that accepted by 'formatTime':
# https://hackage.haskell.org/package/time-1.6.0.1/docs/Data-Time-Format.html#v:formatTime
#
# dateFormat: %Y-%m-%d

# Theme name
# For now, the choices are
#
#   builtin:dark (default)
#   builtin:light
#
# theme: builtin:dark

# Theme customization file
# This setting is optional. If present, it must either be:
# * A relative path to a theme customization file. In this case
#   the relative path is treated as relative to the location of the
#   configuration file. For example, if the Matterhorn configuration
#   file is at $HOME/.config/matterhorn/config.ini and this setting has
#   the value "theme.ini", then Matterhorn will look for this file at
#   $HOME/.config/matterhorn/theme.ini.
# * An absolute path to a theme customization file.
#
# themeCustomizationFile: /path/to/file

# Smart character pair insertion for "``", "**", and "__".
# Allowed values are True and False (case sensitive)
# Invalid values are ignored.
# Default is True
#
# smartbacktick = True

# Terminal bell control: ring the terminal bell whenever a new message
# arrives (for use with e.g. terminal multiplexers)
#
# Allowed values are True and False (case sensitive)
# Default is False
# activityBell = False

# Background activity display: Matterhorn communicates with the
# Mattermost server using asynchronous background thread processing.
# This parameter can be used to enable a visual display of when and
# how much background activity is occurring.
#
# Allowed values are: Disabled, Active, ActiveCount
# Default is Disabled
# showBackgroundActivity = Disabled

# The command to use to open URLs found in chat messages.
# OS X:
# urlOpenCommand = open
# Linux:
# urlOpenCommand = xdg-open

# This setting indicates whether the URL-opening command is interactive
# in the terminal. Set this to True if your urlOpenCommand is a terminal
# web browser. Set this to False otherwise.
# Default: False
# urlOpenCommandIsInteractive = False

# Whether to show a message rendering preview
# Default: False
# showMessagePreview = False

# Whether to enable the spell checker if "aspell" is present on the
# system.
# Default: False
# enableAspell = False

# Name a specific Aspell dictionary to use. See "aspell dicts" for a
# list of available dictionaries on your system.
# Default: fall back to environment / locale
# aspellDictionary = "..."

# Force Matterhorn to use HTTP instead of HTTPS. This is mostly included
# for testing purposes; you really should not use this unless you're
# absolutely sure it's what you want
# unsafeUseUnauthenticatedConnection = False

# The width of the channel list (in columns).
#
# channelListWidth = 20

# Whether to show indicators on edited messages that have not been
# edited recently.
# Default: True
#
# showOlderEdits = True