4.1 KiB
NAME
config.json – configuration file for iamb
SYNOPSIS
Configuration must be placed under ~/.config/iamb/ and is named config.json.
Example configuration usually comes bundled with your installation and can typically be found in /usr/share/iamb.
As implied by the filename, the configuration is formatted in JSON. It's structure and fields are described below.
BASIC SETTINGS
These options are primitives at the top-level of the file.
default_profile (type: string)
The default profile to connect to, unless overwritten by a commandline switch. It has to be defined in the PROFILES section.
PROFILES
These options are configured as a map under the profiles name.
user_id (type: string)
The user ID to use when connecting to the server. For example "user" for "@user:matrix.org".
url (type: string)
The URL of the users server. For example "https://matrix.org" for "@user:matrix.org".
settings (type: settings object)
Overwrite general settings for this account. The fields are identical to those in TUNABLES.
layout (type: startup layout object)
Overwrite general settings for this account. The fields are identical to those in STARTUP LAYOUT.
dirs (type: XDG overrides object)
Overwrite general settings for this account. The fields are identical to those in DIRECTORIES.
TUNABLES
These options are configured as a map under the settings key and can be overridden as described in PROFILES.
log_level (type: string)
Specifies the lowest log level that should be shown. Possible values are: trace, debug, info, warn, and error.
reaction_display (type: boolean)
Defines whether or not reactions should be shown.
reaction_shortcode_display (type: boolean)
Defines whether or not reactions should be shown as their respective shortcode.
read_receipt_send (type: boolean)
Defines whether or not read confirmations are sent.
read_receipt_display (type: boolean)
Defines whether or not read confirmations are displayed.
request_timeout (type: uint64)
Defines the maximum time per request in seconds.
typing_notice_send (type: boolean)
Defines whether or not the typing state is sent.
typing_notice_display (type: boolean)
Defines whether or not the typing state is displayed.
user (type: map)
Overrides values for the specified user. See USER OVERRIDES for details on the format.
default_room (type: string)
The room to show by default instead of a welcome-screen.
USER OVERRIDES
Overrides are mapped onto matrix User IDs such as @user:matrix.org and are maps containing the following key value pairs.
name (type: string)
Change the display name of the user.
color (type: string)
Change the color the user is shown as. Possible values are: black, blue, cyan, dark-gray, gray, green, light-blue, light-cyan, light-green, light-magenta, light-red, light-yellow, magenta, none, red, white, yellow
STARTUP LAYOUT
Specifies what initial set of tabs and windows to show when starting the client. Configured as an object under the key layout.
style (type: string)
Specifies what window layout to load when starting. Valid values are restore to restore the layout from the last time the client was exited, new to open a single window (uses the value of default_room if set), or config to open the layout described under tabs.
tabs (type: array of window objects)
If style is set to config, then this value will be used to open a set of tabs and windows at startup. Each object can contain either a window key specifying a username, room identifier or room alias to show, or a split key specifying an array of window objects.
DIRECTORIES
Specifies the directories to save data in. Configured as a map under the key dirs.
cache (type: string)
Specifies where to store assets and temporary data in.
logs (type: string)
Specifies where to store log files.
downloads (type: string)
Specifies where to store downloaded files.
SEE ALSO
iamb(1)
Full documentation is available online at <https://iamb.chat>