mirror of
https://github.com/youwen5/iamb.git
synced 2025-06-20 13:49:52 -07:00
113 lines
3.2 KiB
Markdown
113 lines
3.2 KiB
Markdown
# 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*.
|
||
|
||
**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_
|
||
|
||
# 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\>
|