Unload or Clear Chainsetups in Ecasound

Managing audio routing dynamically in Ecasound Interactive Mode requires understanding how chainsetups are engaged and released. This guide explains the exact commands used to unload an active chainsetup from the real-time engine and clear it completely from memory during an interactive session.

The Primary Commands

In Ecasound Interactive Audio Mode (EIAM), clearing an active chainsetup involves two key commands depending on whether you want to detach it from the audio engine or delete it entirely:

cs-disconnect: Unloads the currently active chainsetup from the audio subsystem and processing engine.
cs-remove: Completely clears and deletes the selected chainsetup from memory.

Step-by-Step Procedure to Clear an Active Chainsetup

An active chainsetup cannot be removed while audio processing is actively running. Follow this workflow within the interactive prompt:

Halt Audio Processing
If the engine is running, stop it by entering:
```
stop
```
Unload the Chainsetup from the Engine
Disconnect the active setup from the engine using:
```
cs-disconnect
```
This unloads all associated input, output, and effect objects from the real-time processing loop while keeping the configuration saved in session memory.
Permanently Clear the Chainsetup
To delete the chainsetup entirely from your current interactive session, run:
```
cs-remove
```
If you have multiple chainsetups loaded, verify or target a specific setup first using cs-select <chainsetup_name> before executing cs-remove.

Verification

To confirm that the chainsetup has been cleared, check the status of all available configurations:

cs-list

If executed properly, the removed chainsetup will no longer appear in the list, leaving Ecasound ready for a new chainsetup to be created (cs-add) or loaded from a file (cs-load).