+++
title = "Settings"
weight = 7
+++

The **Settings** view lets you configure your companion device and application preferences. All device changes require clicking **Apply** in the header bar to be sent to the device. Navigating away without applying discards changes.

## Application

Application-level preferences (applied immediately):

- **Style** -- Follow System, Light, Dark, or Palette Theme. When Palette Theme is selected, a **Palette Theme** row appears to pick a custom theme.
- **Channel Notifications** -- Default notification level for all channels (All Messages / Mentions Only / None).
- **Run in Background** -- Keep receiving messages after closing the window (uses XDG Background Portal).
- **Autostart** -- Launch Meshy automatically on login.

## Radio

LoRa radio parameters and regional presets:

- **Regional Preset** -- dropdown with 23 regional configurations (Australia, EU/UK, USA/Canada, Czech Republic, etc.) plus 3 Off-Grid presets. Selecting a preset fills in the frequency, bandwidth, spreading factor, and coding rate automatically.
- **Preset Configuration** -- expandable section showing the radio parameters set by the preset:
  - **Frequency** (MHz)
  - **Bandwidth** (kHz)
  - **Spreading Factor** (SF 5-12)
  - **Coding Rate** (4/5 to 4/8)
  Editing these manually resets the preset to "Custom".
- **Repeat Mode** -- act as a portable repeater on an off-grid frequency (shown only when supported by firmware).
- **TX Power** (dBm) -- transmission power (2-30 dBm), capped by device hardware maximum.

**Important:** Changing radio parameters means your device will no longer communicate with nodes on different settings. All nodes in your mesh must use the same frequency, bandwidth, spreading factor, and coding rate.

## Advert

- **Device Name** -- the name your node broadcasts in advertisements (max 31 bytes).
- **Include Location in Advert** -- toggle whether your position is included in advertisements sent to other nodes.

## Routing and Messaging

Path routing and message delivery settings:

- **Default Path Hash Size** -- 1-byte (max 64 hops), 2-byte (max 32 hops), or 3-byte (max 21 hops). Larger sizes reduce routing collisions in dense networks. Availability depends on firmware version.
- **Direct Message Confirmations** -- number of ACKs sent when receiving a direct message (1 or 2). Higher values improve delivery reliability at the cost of additional airtime.

## Location

Set your companion's position via GPS or manually:

- **Companion GPS** -- enable GPS on the companion device; your position will update automatically (shown when the device supports GPS).
- **Set Location Manually** -- expandable section with methods to set a fixed position:
  - **Latitude / Longitude** -- manual coordinate entry (decimal degrees).
  - **Use My Location** -- fills coordinates from your computer's location service (requires location permissions).
  - **Pick on Map** -- opens an interactive map with a crosshair; pan and zoom to your location, then confirm.

## Auto-Add Contacts

Configure which types of nodes are automatically added to your contact list when their advertisements are heard:

- **Auto-Add Contacts** -- master toggle.
- **Auto-Add Settings** -- expandable section with per-type toggles:
  - **Chat Nodes** -- regular user devices.
  - **Repeaters** -- relay nodes.
  - **Room Servers** -- chat room hosts.
  - **Sensors** -- environmental sensors.
  - **Overwrite oldest when full** -- if the contact list is full, replace the oldest entry.
  - **Hop limit** -- maximum number of hops for auto-added nodes (0-63, empty for no limit).

## Telemetry Privacy

Control what telemetry data others can query from your device. Each category has a visibility level:

- **Battery & Sensors** -- battery, voltage, temperature, current.
- **Location** -- GPS coordinates.
- **Environment** -- humidity, pressure, air quality.

## Regions

Limit flood scope of channel messages to specific regions:

- **Add Region** -- enter a region name (e.g. "Prague") to add it to the device.
- **Default Scope** -- if set, all flood packets will be scoped to this region.

## Bluetooth

Bluetooth pairing settings (shown when connected via Bluetooth):

- **Pairing PIN** -- set a custom pairing PIN. After changing the PIN, restart the device, then unpair and re-pair. Setting 0 resets the PIN to default.

## Applying Changes

Click the **Apply** button in the header bar to send all modified settings to the device. The button only becomes active when changes are detected. If you navigate away without applying, all changes are discarded.
