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

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

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

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

macOS

Download the macOS app, open it, then return to the setup link.

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.

Steps

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

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.

Local Identity Security

After pairing, Thalovant Voice stores the local identity and connection metadata in the current user’s app config folder. The app writes those files as private files and repairs owner-only permissions when possible.

On Linux and macOS, do not replace those files with symlinks or group/world-readable copies. If you manually move an identity file for recovery, run chmod 600 before starting Thalovant Voice.

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

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.
Identity file was copied manually	Confirm it is a real private file, then run `chmod 600` before starting the app.
Wrong computer paired	Recreate the connection and use the new setup link only on the intended computer.

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.

Open connection guidance