Toggle Ecasound Verbose Engine Status Updates
This article covers how to control and toggle verbose engine status updates within Ecasound Interactive Mode (IAM). It details the primary commands used to enable or disable continuous status output during audio processing, as well as the commands required to query immediate verbose diagnostic reports from the engine.
In Ecasound Interactive Mode, periodic verbose engine status updates
are toggled using the
int-set-output-status-interval command.
Because Ecasound treats status reporting as an interval-based routine,
setting this parameter determines whether updates are actively printed
to the console:
- Enable status updates: Enter
int-set-output-status-interval [seconds](for example,int-set-output-status-interval 1to output updates once every second). - Disable status updates: Enter
int-set-output-status-interval 0to turn continuous engine status reports off.
To check the current update frequency setting, use:
int-output-status-interval
On-Demand Verbose
Diagnostics: dump-status
If you require an immediate, detailed report of the audio processing graph rather than continuous streaming updates, use:
dump-status
The dump-status command outputs a comprehensive
diagnostic dump directly to the terminal, detailing active chain setups,
inputs, outputs, operators, and current buffer states.
Basic State Queries:
engine-status
To retrieve only the high-level operating state of the engine (such
as running, stopped, or error)
without detailed stream information, use:
engine-status
Summary of Usage
- Launch Ecasound in interactive mode using
ecasound -c. - Start the processing engine with
start. - Toggle continuous verbose status reporting on by typing
int-set-output-status-interval 1. - Toggle continuous reporting off by typing
int-set-output-status-interval 0. - Request a full snapshot at any point by typing
dump-status.