Dictate into a remote SSH host¶

Run YazSes on your local machine — where the microphone and the STT engine live — and have the transcribed text typed into an application on a remote host you reach over SSH. Your voice never leaves your laptop as audio; only the final text is forwarded over the encrypted SSH tunnel.

[ your laptop ]                                   [ remote host ]
 mic → STT → text  ──SSH reverse tunnel──▶  yazses-agent → types into the focused app

What runs where¶

Machine	What runs	Why
Local (your laptop)	the YazSes daemon (`yazses start`)	captures audio, runs faster-whisper
Remote (SSH host)	`yazses-agent`	receives text and injects it into the focused window

yazses-agent is deliberately lightweight — it has no audio or faster-whisper dependencies, just a text injector. Install YazSes on the remote host the same way you install it locally.

1. Start the daemon locally¶

yazses start

The remote command talks to a running daemon, so it must be up first.

2. Forward voice typing to the remote host¶

yazses remote dev.example.com                 # forward over SSH (default port 22)
yazses remote dev.example.com -p 2222         # non-default SSH port
yazses remote dev.example.com -i ~/.ssh/id_ed25519   # explicit private key

Under the hood this opens an SSH reverse tunnel and launches the agent on the remote host, roughly equivalent to:

ssh -R 9875:127.0.0.1:9875 dev.example.com yazses-agent --listen 9875

Once connected, hold your hotkey and speak as usual — the text lands in whatever window is focused on the remote host. Make sure the remote application you want to type into has keyboard focus.

3. Disconnect¶

yazses remote dev.example.com --stop

Running the agent manually¶

If you prefer to start the agent yourself on the remote host (for example under a process manager), run:

yazses-agent --listen 9875      # default port is 9875

Then point the tunnel at that port. The agent listens on 127.0.0.1 only, so it is reachable exclusively through the SSH tunnel — not exposed on the network.

Defaults and config¶

The [remote] section of config.toml sets the defaults the remote command uses when you omit flags:

[remote]
default_host = ""        # host to use when none is given
ssh_port = 22
agent_port = 9875        # must match `yazses-agent --listen`
key_file = ""            # SSH private key path

Requirements¶

ssh must be installed and on your PATH locally.
Key-based SSH auth to the remote host (so the tunnel opens without a password prompt).
YazSes (for yazses-agent) installed on the remote host, with a working text injector for its display server (the same injection prerequisites as a normal local install).