Settings

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.

Leaving Settings with unapplied changes opens a prompt with Apply and Discard. Apply sends the changes to the device and continues to the new view, Discard reverts them, and closing the prompt keeps you on Settings.

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 / Muted / Ignored).
  • Run in Background -- Keep receiving messages after closing the window (uses XDG Background Portal).
  • Autostart -- Launch Meshy automatically on login.

Message bubbles grow to at most 750 px wide (roughly 85-95 characters). There is no UI for this; to override it, run gsettings set page.codeberg.sesivany.Meshy message-width-px 900 and reopen the chat.

Radio

LoRa radio parameters and regional presets:

  • Regional Preset -- dropdown with 26 regional configurations (Australia, EU/UK, USA, Canada, Czech Republic, etc.) plus Custom. Selecting a preset fills in the frequency, bandwidth, spreading factor, and coding rate automatically. Some presets (e.g. Hungary, Slovakia, Canada, New Zealand) also prescribe the Default Path Hash Size in Routing and Messaging.
  • Radio 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". Changing the Default Path Hash Size keeps the current preset selected unless the preset prescribes a conflicting hash size.
  • Repeat Mode -- act as a portable repeater on an off-grid frequency (shown only when supported by firmware). When enabled, the frequency switches to the off-grid value while other radio parameters (bandwidth, spreading factor, coding rate) remain from the current preset and can be edited. The Device Info screen shows a "Repeat Mode" badge next to the frequency as an indicator.
  • 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.

  • Device Name -- the name your node broadcasts in advertisements and uses as your nickname in channel chats (max 31 bytes). Longer names reduce the character limit for channel messages. Meshy and most other clients use the first emoji in the name as an avatar.
  • 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 Routing -- sets the global routing strategy for all contacts: Classic or Smart. Individual contacts can override this in the contact detail dialog. See the Routing page for a detailed description of both strategies.
  • Path Attempts -- number of delivery attempts over an established path, from 1 to 10 (default 4). Used by both Classic and Smart routing.
  • Flood Attempts -- number of delivery attempts when falling back to flood routing, from 1 to 5 (default 4). Used by both Classic and Smart routing.
  • 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 this device's location service (requires location permissions).
    • Pick on Map -- opens an interactive map with a crosshair; pan and zoom to your location, then confirm.

Contacts

Online Node Database

  • Online Node Database -- toggle to import node information from map.meshcore.io. When enabled, Meshy downloads the node database (~15 MB) and adds matching nodes to your discovered contacts. Only nodes matching your device's radio preset and updated on the map in the last 3 months are imported.
    • Automatically update daily -- checkbox in the enable dialog; when checked, the database is refreshed once a day in the background.
    • When disabling, you can optionally delete all imported online node contacts.
    • On metered connections (detected via XDG portals), automatic updates are skipped to avoid unwanted data usage.

Imported nodes appear as discovered contacts on the Map and in the Discover Contacts dialog. They are marked as online imports and can be removed at any time.

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.
  • Discover Regions from Repeaters -- the search icon in the region entry scans for nearby repeaters and queries them for the regions they serve, so you can add them without typing. Repeaters are queried sequentially, and the results are offered as regions to add.
  • Default Scope -- if set, flood packets are scoped to this region, except for channels that have their own region configured. A channel's region always takes precedence; the default is only a fallback.

WiFi

Companion WiFi settings (only shown when the companion has a WiFi interface — MeshCore firmware 1.18 and newer, detected automatically over the device CLI):

  • Enable WiFi -- whether the companion joins the configured network when it starts.
  • Connection -- the current state (Connected with the IP address, or Disconnected). Use the refresh button to query it again.
  • WiFi SSID / WiFi Password -- the network to join.

WiFi changes are applied with the Apply button like the other settings, but they are sent through the companion CLI and the companion must be restarted for them to take effect. After applying, Meshy offers to restart the companion; when disabling WiFi while connected over WiFi it also warns that the connection will drop. When the companion is reachable over WiFi, Meshy also remembers its address and offers it on the connection screen.

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.