itd-site/content/configuration/sections.md

+++
title = "Sections"
date = 2021-10-23T23:04:51-07:00
weight = 2
+++

This page is about the various sections in the config, their purpose, and how to use them.

### cfg.version

{{% notice note %}}
This field was removed in [fbb7cd9bc1](https://gitea.arsenm.dev/Arsen6331/itd/commit/fbb7cd9bc1f632fb52f14f10ee76ade06b68824c)
{{% /notice %}}

This field is temporary and was added because I changed the config format a while ago and wanted to make sure no one was still using the old config with a new version of ITD.

---

### socket

This section contains options for the control socket exposed by ITD.

#### path

This field is a string indicating the filepath at which the control socket should be opened.

---

### conn

The conn secton contains options for ITD's connection to the PineTime. 

#### reconnect

This field is a boolean that dictates whether ITD will attempt to reconnect to the PineTime in case of a disconnect.

---

### conn.whitelist

This section allows filtering which watches will be connected to. Only the devices in the devices list will be connected to.

#### enabled

This field is a boolean which dictates whether the whitelist is enabled.

#### devices

This field is an array if strings which contains BLE addresses that should be allowed for connection. A PineTime's BLE address can be found in the third page of the about section in settings.

---

### on.connect

This section contains options for what happens when ITD first connects to a PineTime.

#### notify

This field is a boolean that dictates whether a notification should be sent to InfiniTime upon connection.

---

### on.reconnect

This section contains options for what happens when ITD reconnects to a PineTime after a disconnect.

#### notify

This field is a boolean that dictates whether a notification should be sent to InfiniTime upon reconnect.

#### setTime

This field is a boolean that dictates whether the time should be updated when ITD reconnects to InfiniTime.

---

### notifs.translit

#### use

This field is an array of strings which sets which transliterators should be used when transliterating text. The full list of transliterators can be found [here](https://gitea.arsenm.dev/Arsen6331/itd#transliteration) in the readme.

#### custom

This field is an array of strings which is a custom transliteration map. It can replace anything with something else. For example:

```toml
custom = [
    "test", "replaced",
    "æ",    "ae",
    "ē",    "e",
]
```

An array is used because Golang does not preserve the order of a map.

---

### notifs.ignore

#### sender

This field is an array of strings which contains senders from which notifications are ignored.

#### summary

This field is an array of strings which contains notification summaries whose notifications will be ignored.


#### body 

This field is an array of strings which contains notification bodies whose notifications will be ignored.

---

### music

This section contains options for music control

#### vol.interval

This field is an integer indicating how much the volume should be changed for each volume up or down event from the music control app.