Skip to content

General Settings

Chris Smashe edited this page Jun 17, 2026 · 5 revisions

General Settings

The General page is where you turn on the local HTTP API, choose its port, set an optional bearer token, and install the typewhisper CLI client.

The General page: Language (Interface Language not yet implemented), Startup, Window (close-to-tray), and the Services section

Local API

The Linux app includes a local HTTP API for integrations and desktop automation. You enable and configure it here.

Setting What it does
Enable local API Turns the local HTTP API on or off.
Port The port the API listens on. Defaults to 9876.
Bearer token An optional token. When configured, requests must present it.

When enabled, TypeWhisper listens on http://localhost:<port>/. The API binds to localhost only.

The Services section: Enable local API, Port (9876), the optional Bearer token field, and the API examples with curl commands

See HTTP API for the full list of endpoints and request options.

Installing the typewhisper CLI

The Linux build ships a typewhisper CLI client that talks to the local API. You can install it directly from this page. It lands in ~/.local/bin/typewhisper.

Once installed, you can run commands like:

typewhisper status
typewhisper models
typewhisper transcribe recording.wav

See CLI for the full command and option reference.

Related pages

  • HTTP API — endpoints, request fields, and limitations.
  • CLI — commands, options, and examples for the typewhisper client.

Changelog

Date Change
2026-06-17 Initial version.
2026-06-17 Added General settings and API screenshots.
2026-06-17 Removed unused screenshot placeholders.

Clone this wiki locally