Skip to content

Settings

Settings

Configuration file

Configuration file card

Your router credentials, peer name, last room and interface choice live in a settings.json:

Platform Location
macOS ~/Library/Application Support/telemersive-gateway/settings.json
Windows %APPDATA%\telemersive-gateway\settings.json
Linux ~/.config/telemersive-gateway/settings.json

Reveal in Finder / Explorer and Open in default editor take you there. Your rack — which devices are on which channels, and how they are configured — is saved next to it in rack.json.

settings.json contains your router password in plain text

Do not attach it to bug reports or commit it anywhere.

Switchboard

Proxy status poll interval controls how often the channel proxy indicators refresh, between 1 and 60 seconds. The default of 5 is a reasonable compromise; lower it while debugging a channel, raise it if you would rather the app stayed quiet.

Tools & compatibility

Covered on its own page — see Tools & compatibility.

Re-check all re-runs the check without restarting. Reveal app data folder opens the directory holding settings, rack and logs.

Saving and loading racks

The File menu has more than the Settings screen shows:

Item
Save (Cmd+S / Ctrl+S) write settings and rack now, instead of waiting for the autosave
Save Rack As… export the current rack to a file you can keep or share
Save Settings As… export settings to a file
Open Rack… load a rack file, applied on your next room join
Open Settings… load a settings file

Rack files are how you keep a production setup. Build the channel layout once, save it, and reload it for the next rehearsal instead of rebuilding by hand.

Open Rack… and Open Settings… are disabled while you are connected — both take effect at join time, so they have to be chosen before you connect.

Rack files are not portable between peers as-is

A rack records your local ports and device settings. Loading someone else's rack gives you their layout, but addresses pointing at their machines. Treat a shared rack as a starting point.

What is saved automatically

Everything, continuously. Any change to your own devices or settings is written to disk shortly after you make it, so an unexpected quit costs you nothing. The one thing that is not preserved is your peer ID, which is new every launch.