Configuration Options

On first startup, BlueTracker copies the default configuration from config.toml to bluetracker_config.toml.

This provides a template configuration file that users can easily modify to suit their specific MQTT broker settings and the devices they want to track.

[bluetooth]
consider_away = 180
scan_interval = 12
scan_timeout = 3

[mqtt]
discovery_topic_prefix = 'homeassistant'
homeassistant_token = 'a_token'
host = '127.0.0.1'
password = 'a_password'
port = 1883
username = 'a_user'

[[devices]]
mac = 'aa:bb:cc:dd:ee:f0'
name = 'Device 1'

[[devices]]
mac = 'aa:bb:cc:dd:ee:f1'
name = 'Device 2'

The available options are shown in the table below.

BlueTracker configuration

Name	Description
environment	Sets the environment for the application (production, development, or testing). This affects logging levels and other behaviors. Not required, defaults to production.
bluetooth	Bluetooth settings Name Description consider_away Seconds to wait to mark a device as away. scan_interval Seconds to wait between scans. scan_timeout Seconds to wait for a device response.
mqtt	MQTT settings Name Description discovery_topic_prefix Discovery prefix for Home Assistant. homeassistant_token Home Assistant token. host Host ip address. password Password. port Port. username Username.
devices	Bluetooth devices Name Description mac Unique device mac address. name Unique device name.