macOS
Download the macOS app, open it, then return to the setup link.
Install Thalovant Voice
Thalovant Voice is the room client for voice setups.
Install it on the computer that should listen and speak, then return to the setup link so the client can pair.
Start Here If
Section titled “Start Here If”- the setup page asks you to install Thalovant Voice;
- nothing opens when you choose Open Thalovant Voice;
- you need the macOS, Windows, or Linux installer;
- you are setting up a Linux computer over SSH;
- you need relay mode for an advanced voice setup.
At a Glance
Section titled “At a Glance”| Question | Simple answer |
|---|---|
| Where do I install it? | On the computer that should listen and speak. |
| What pairs the client? | The setup link, not the installer alone. |
| What is easiest on Linux? | Copy the install command from the setup or download page. |
| What is headless Linux? | A command you can paste over SSH with the setup link included. |
| What is relay mode? | An advanced voice runtime choice for special deployments. |
Before You Start
Section titled “Before You Start”Confirm:
- you are on the computer that should run voice;
- the setup link is still available;
- you know whether this is a normal room client or an advanced relay setup;
- you can install apps or run a terminal command on that computer.
If the setup link expired, create a new setup link from Connections before reinstalling.
Choose Your Platform
Section titled “Choose Your Platform”Windows
Download the Windows setup app, run it, then return to the setup link.
Linux desktop
Copy the Linux command, paste it in Terminal, and keep the setup page open.
Headless Linux
Copy the headless command and include the setup link when you paste it over SSH.
- Open the setup link. It chooses the best install action for the current computer.
- Install Thalovant Voice. Use the download or command shown for your platform.
- Return to the setup page. The setup link handles pairing and credentials.
- Open Thalovant Voice. Use the button again after installation if nothing opened the first time.
- Wait for connected. Keep the app running until Dashboard shows the first heartbeat.
Linux Commands
Section titled “Linux Commands”For Linux desktop setup, copy the Linux install command from the setup page or the downloads page. Paste it once in Terminal.
For headless Linux, copy the headless command and replace the placeholder with the setup link before running it over SSH.
The setup link inside a copied command is private. Treat the whole command like a password.
Relay Mode
Section titled “Relay Mode”Most users should choose Satellite.
Choose Relay only when the setup page or your deployment notes tell you the voice runtime should run in relay mode. Relay mode is advanced and should still use the same private setup link.
Troubleshooting
Section titled “Troubleshooting”| Symptom | First check |
|---|---|
| Nothing opens after install | Return to the setup page and choose Open Thalovant Voice again. |
| Linux command copied but no client appears | Paste the full command once and keep the setup page open. |
| Setup link is unavailable | Create a new setup link from Connections. |
| Client claimed but stays offline | Keep Thalovant Voice running and check Dashboard after the first heartbeat. |
| Wrong computer paired | Recreate the connection and use the new setup link only on the intended computer. |
Ready When
Section titled “Ready When”Thalovant Voice is ready when:
- the app is installed on the intended computer;
- the setup link was claimed once by that computer;
- Dashboard shows the expected connection;
- Live Map shows the client when live status is available;
- permissions match what the voice client should be allowed to do.