General Usage

These arguments control the overall operation and behavior of Synthalingua.

Arguments

Flag	Description
--version	Show the current Synthalingua version and exit.
--about	Display information about the app and contributors.
--checkupdate	Compare the local version with the latest GitHub release and exit.
--updatebranch	Choose which branch to check for updates (master, dev-testing, bleeding-under-work, disable).
--no_log	Only show the last line of the transcription (not a running log).
--keep_temp	Keep temporary audio files (may use more disk space over time).
--retry	Retry the transcription if it fails (may increase processing time).
--debug	Enable detailed debugging output for troubleshooting.
--timeout	Set the timeout duration for the transcription worker process (in seconds).
--condition_on_previous_text	Use previous output as prompt for next window (reduces repetition).
--serverip	Bind the web interface to a specific IP address (defaults to 127.0.0.1).

Details & Examples

--about

Shows information about Synthalingua, including contributors and version. Example:

python synthalingua.py --about

--checkupdate

Checks for available updates by comparing the local version with the latest GitHub release. Shows current version, remote version, and whether an update is available, then exits. Example:

python synthalingua.py --checkupdate

--version

Displays the current Synthalingua version and exits immediately. Example:

python synthalingua.py --version

--updatebranch

Controls which branch is checked for updates. Example:

python synthalingua.py --updatebranch dev-testing

--no_log

Only the most recent line of output is shown, instead of a running log. Useful for a cleaner console.

--keep_temp

Prevents deletion of temporary audio files. Useful for debugging or archiving.

--retry

Retries transcription if it fails, which may increase processing time but improves reliability.

--debug

Enable detailed debugging output for troubleshooting. Shows internal processing steps, model loading details, audio chunk information, timing data, and error traces. Use when experiencing issues with transcription accuracy, performance problems, or unexpected behavior. Significantly increases console output volume.

--timeout

Set the timeout duration for the transcription worker process (in seconds). Use this to prevent hanging processes during transcription. Default is 0 (no timeout).

--condition_on_previous_text

Use previous transcription output as context for next audio window to improve consistency and flow. Enabled: better coherence but may get stuck repeating errors. Disabled: each segment processed independently, more resilient to errors but may have inconsistent terminology. Recommended for longer conversations or presentations.

--serverip

Sets the network interface that the built-in web interface binds to when launched with --portnumber or --https. Use 127.0.0.1 (default) to keep the UI accessible only from the local machine, or 0.0.0.0 to listen on every available interface. Example:

python synthalingua.py --portnumber 8080 --serverip 0.0.0.0

---

Back to Index