ecasound-iam

GLOBAL

rewind 'time-in-seconds', rw 'time-in-seconds'

Rewind the current position by 'time-in-seconds' seconds.

forward 'time-in-seconds', fw 'ttime-in-seconds'

The current position is forwarded by 'time-in-seconds' seconds.

setpos 'time-in-seconds'

Sets the current position to 'time-in-seconds' seconds from the beginning.

status','st','u'

General status info.

DIRECT ARGUMENTS

CHAINSETUPS

cs-add 'name'

Add a new chainsetup with name 'name'. 'name' is now the selected chainsetup.

cs-remove

Remove currently selected chainsetup.

cs-select 'name'

Select chainsetup 'name'.

cs-index-select 'cs_index'

Select chainsetup based on a short index string. Chainsetup names can be rather long. This command can be used to avoid typing these long names. 'cs_index' format is "c<number>". You can get a list of all chainsetups (and their indexes) with the 'cs-status' command.

cs-load 'filename'

Add a new chainsetup by loading it from file 'filename'. 'filename' is now the selected chainsetup.

cs-save

Save currently selected chainsetup to file. If chainsetup was loaded from a file, it's saved to the same file. If it doesn't have a default filename, it's saved to "chainsetup_name.ecs".

cs-save-as 'filename'

Save currently selected chainsetup to file 'filename'.

cs-edit

Currently selected chainsetup is saved to a temporary file. This file is loaded to an external editor (see ecasoundrc(5)). After editing, the chainsetup is loaded back to ecasound.

cs-connect

Connect currently selected chainsetup to engine. Only one chainsetup can be connected at a time.

cs-disconnect

Disconnect currently connected chainsetup.

cs-length 'seconds'

Set processing time in seconds (doesn't have to be an integer value).

cs-loop

Enable looping. When processing is finished, engine will start again from the initial position.

cs-set

Interpret general chainsetup parameters like for example "-b" (buffersize), "-m" (mixmode), "-n" (name), etc. See ecasound(1) for more info.

cs-format 'bits,channels,sample_rate'

Set the default sample parameters for currently selected chainsetup. For example cd-quality audio would be "16,2,44100". This does the same as command-line argument "-f" (see ecasound(1)).

cs-status, cstatus, cs, a

Print status info about all chainsetups.

CHAINS

c-add 'cname1,...,cnameN'

Add chains. Added chains are automatically selected.

c-select 'cname1,...,cnameN'

Select chains.

c-select-all

Select all chains.

c-remove

Remove selected chains.

c-clear

Clear selected chains by removing all chain operators and controllers. Doesn't change how chains are connected to inputs and outputs.

c-name 'new_name'

Rename selected chains. When using this command, only one chain must selected.

c-muting

Toggle chain muting. When chain is muted, all data that goes through is muted.

c-bypass

Toggle chain bypassing. When chain is bypassed, sample data is passed through untouched.

c-forward 'time_in_seconds', c-fw 'time_in_seconds'

Inputs and outputs connected to selected chains are forwarded by 'time-in-seconds' seconds. Time should be given as a floating point value (eg. 0.001 is the same as 1ms). If audio objecst are connected to multiple selected chains, they will be forwarded multiple times.

c-rewind 'time_in_seconds', c-rw 'time_in_seconds'

Inputs and outputs connected to selected chains are rewinded by 'time-in-seconds' seconds. Time should be given as a floating point value (eg. 0.001 is the same as 1ms). If audio objecst are connected to multiple selected chains, they will be forwarded multiple times.

c-setpos 'time_in_seconds'

Set position of all inputs and outputs connected to selected chains to 'time_in_seconds'.

c-status

Print status info about all chains.

AUDIO INPUT/OUTPUT OBJECTS

aio-add-input 'input_format_string'

Add a new input object. See ecasound(1) man page for more info about the argument format ('-i' option).

aio-add-output 'output_format_string'

Add a new output object. See ecasound(1) man page for more info about the argument format ('-o' option).

aio-select 'aobject_name'

Select some audio object. 'aobject_name' is usually a file name, but not always.

aio-index-select 'aobject_index'

Select some audio object based on short index string. Especially file names can be rather long. This command can be used to avoid typing these long names when selecting audio objects. 'aobject_index' format is "i<number>" for inputs and similarly "o<number>" for outputs. You can get a list of all audio objects and their indexes with the 'aio-status' command.

aio-attach

Attach currently selected audio object to all selected chains.

aio-remove

Remove currently selected audio object.

aio-status

Audio object status (index strings, position, length, etc).

aio-forward 'time_in_seconds', aio-fw 'time_in_seconds'

Selected audio object is forwarded by 'time-in-seconds' seconds. Time should be given as a floating point value (eg. 0.001 is the same as 1ms).

aio-rewind 'time_in_seconds', aio-rw 'time_in_seconds'

Selected audio object is rewinded by 'time-in-seconds' seconds. Time should be given as a floating point value (eg. 0.001 is the same as 1ms).

aio-setpos 'time_in_seconds'

Set audio object position to 'time_in_seconds'.

aio-wave-edit

Currently selected audio object is loaded into an external wave editor (see ecasoundrc(5)).

CHAIN OPERATORS

cop-add 'cop_format_string'

Add a new chain operator. Argument format is "-<id_string>:par1,...,parN". See ecasound(1) man page for more info.

cop-remove 'chainop_id'

Remove chain operator.

cop-add-controller 'copc_format_string'

Add a new controller and attach it to currently selected chain operator. Argument format is "-<id_string>:<param_id>,<range_low>, <range_high>,par1,...,parN". See ecasound(1) man page for more info.

cop-set 'chainop_id, param_id, value'

Change the value of a single chain operator parameter. Unlike other chain operator commands, this can also be used during processing.

cop-remove-controller 'param_id'

Remove the controller that is attached to the currently selected chain operator.

cop-status

Info about chain operator status.

SEE ALSO

ecasound(1), qtecasound (1), ecatools (1), ecasoundrc(5)

AUTHOR

Kai Vehmanen, <kaiv@wakkanet.fi>