ecasound(1) Multimedia software ecasound(1) (NAME) ecasound - . (SYNOPSIS) ecasound [ general_options ] { [ chain_setup ] [ effect_setup ] [ input_setup ] [ output_setup ] } (DESCRIPTION) (Ecasound) . . . MIDI-CC . . (OPTIONS) ! ecasound ecasound (.ecs) . ECASOUND (ECASOUND OPTIONS) ecasound . ecasound . -c ecasound . ecasound ("start" "stop" "pause" ). ecasound-iam . -C ecasound ( '-c' '-K' ). -D (stderr) ( ncurses). -s[:]chainsetup-file (chainsetup) 'chainsetup-file' . '.ecs' . -- . (session) . ( / ). . -E "cmd1 [[args] ; cmd2 args ; ... ; cmdN]" (EIAM) . ecasound . . ecasound . '-E' . --server NetECI ecasound . ecasound . NetECI (Ecasound Programmer Guide) . ecamonitor(1) . ( ). ! ecasound (port) ecasound ! . '--daemon' ( .. ). --server-tcp-port=NNN TCP (). ecasound 2868 . '--daemon-port' ( .. ). --no-server ecasound. . '--nodaemon' ( .. ). --osc-udp-port=NNN Open Sound Control (OSC). OSC UDP NNN . OSC : OSC . .. ecasound . --keep-running,-K / . ( -c/-C ). .. ecasound . --help,-h . --version . (GLOBAL OPTIONS) -d, -dd, -ddd . -d -ddd . -d:debug_level 'debug_level'. : (1) (2) (4) (8) (16) (32) (64) (128) eiam (256). (1+2+4+8+256). ECA_LOGGER . -R[:]path-to-file ecasound ( ecasoundrc ) 'path-to-file' . ( ) . -q . -d:0. (GENERAL CHAINSETUP OPTIONS) -a:chainname1, chainname2, ... . '-a' ( -a ). . -a 'default' . 'all' . -a . (EXAMPLES) . -n:name 'name'. "command-line-setup" . . -x . . . -X . - - . -z:feature 'feature'. -z:nofeature . '-z:db,dbsize' (double-buffering) (dbsize=0 ). '-z:nodb' . '-z:intbuf' '-z:nointbuf' (realtime) . (latency) . '-z:xruns' (under/overrun) . '-z:multitrack' '-z:nomultitrack' . '-z:multitrack,offset-in-samples' . . '-z:psr' (precise-sample-rates) OSS . '-z:mixmode,sum' . '-z:mixmode,avg' . mixmode .. ecasound . ecasoundrc . (CHAINSETUP BUFFERING AND PERFORMANCE OPTIONS) -B:buffering_mode . : 'auto' () 'nonrt' 'rt' 'rtlowlatency'. -b:buffer_size . ( -b:1024 . .). . ( -B ). (realtime) . . ( ) . ( ) CPU / . / JACK / JACK ( '-p' jackd). . ( -B ). -r:sched_priority (SCHED_FIFO). ( ) . ! . 'sched_priority' (0=). . 'sched_priority-1...n' . '-1' . -z:feature -z:db,xxx (-z:nodb) -z:intbuf (-z:nointbuf). (GENERAL CHAINSETUP OPTIONS) . (PROCESSING CONTROL) -t:seconds ( ). . EIAM 'cs-set-length' . '-1' . -tl (looping). . EIAM 'cs-loop' . / (INPUT/OUTPUT SETUP) . -G:mgrtype,optstring 'mgrtype'. " (OBJECT TYPE SPECIFIC NOTES)" . -f:sample_format,channel,sample-rate,interleaving . '-f' ( '-f' ). '-i' '-o' . ( ) . . (header) . '-f' . JACK JACK . '-f' ( '-f:,2,44100') . ecasoundrc . ecasoundrc(5) . . '-x' ( ) '-f' . . "u" "s" "f" ( unsigned signed floating point). . "_le" . "_be" . . "u8" ( "8") "s16_le" ( "16") "s16_be" "s24_le" "s24_be" "s32_le" "s32_be" "f32_le" "f32_be". "" . . 'i' ( interleaved) 'n' ( noninterleaved). '-b' . 'i' . -y:seconds / . .ewf . -i[:]input-file-or-device[,params] ( '-a:...' ). . ( ). . () (backquotes) . RIFF WAVE (.wav) (.cdr) EWF (.ewf) RAW (.raw) MPEG (.mp2 .mp3). libaudiofile libsndfile ( ). MikMod (.xm .mod .s3m .it ). MIDI (.mid) Timidity++ . Ogg Vorbis (.ogg) ogg123 vorbize FLAC (.flac) flac libsndfile AAC (.aac/.m4a/.mp4) faad2/faac . OSS (/dev/dsp*) loopback ALSA JACK. ( '-' ) . -o[:]output-file-or-device[,params] -i . ( ~/.ecasoundrc ). . ( MikMod MIDI ). (OBJECT TYPE SPECIFIC NOTES) ALSA - 'alsa' ALSA : -i[:]alsa,pcm_device_name. ALSA - 'alsahw', 'alsaplugin' : -i[:]alsahw,card_number,device_number,subdevice_number. ALSA PCM . ALSA pcm . : -i[:]alsaplugin,card_number,device_number,subdevice_number. / aRts - 'arts' aRts . -i:arts -o:arts . - 'audioloop', 'select', 'playat' - . -i:audioloop,file.ext,params . ( Ecasound) . . N ( "-i audioloop,foo.wav,bar1,bar2" "bar1,bar2" "foo.wav" )..IP -i:select,start-time,duration,file.ext,params . "duration" "file.ext" "start-time" . ( "2.25") ( "25000sa") . N . -i:playat,play-at-time,file.ext,params . "play-at-time" "file.ext" . ( "2.25") ( "25000sa") . N . Ecasound (EWF) - '*.ewf' ( ) (loop) . Ecasound . Ecasound . 'audioloop' 'select' 'playat' . / JACK - JACK . . / JACK - 'jack' Ecasound JACK . JACK -i jack -o jack . JACK "ecasound:in_N" "ecasound:out_n" ('N' ). Ecasound JACK ( -f:bits,channels,rate ). JACK ( / ). ( "QJackCtl" "jack_connect") . / JACK - 'jack,clientname,portprefix' "jack,clientname" Ecasound Ecasound . "jack" -o jack,clientname. -o jack,system . . ( "in" "ecasound:in_N") "jack" -o jack,,fxout. "in" "out" . / JACK - 'jack_multi' 'jack' 'jack_multi' . jack_multi,destport1,...,destportN . 'jack_multi' JACK JACK 'destport1' 'destport2' . "-f:32,2,44100 -o jack_multi,foo:in,bar:in" Ecasound JACK . Ecasound . Ecasound . / JACK - 'jack_alsa' 'jack_auto' 'jack_generic' (** .. **) . Ecasound "jack_alsa" "jack_auto" "jack_generic" "jack" ( ). / JACK - JACK -G:jack,client_name,operation_mode . 'client_name' Ecasound JACK . 'operation_mode' "notransport" Ecasound (transport) JACK "send" JACK "recv" Ecasound JACK "sendrecv" . ( '-c') "sendrecv" (batchmode) "notransport" . -G . Ecasound JACK Ecasound . Libaudiofile - 'audiofile' libaudiofile Ecasound libaudiofile / . -i:audiofile,foobar.ext ( -o ). Libsndfile - 'sndfile' libsndfile Ecasound libsndfile / . -i:sndfile,foobar.ext[,.format-ext] ( -o ). "format" ( AIFF "foo.wav" ). - 'loop' (loop) () . -[io][:]loop,tag . loop '1' loop '1' . ( '-i:loop,1') ( "-i:loop,vocals"). / loop / . : 'loop' 'audioloop' ( .. ecasound ). Mikmod - 'mikmod' mikmod Ecasound Mikmod / . -i:mikmod,foobar.ext . / - 'null' "null" "/dev/null" . . "rtnull" "null" / (realtime) . - 'resample' 'resample' (chainsetup) . : ecasound -f:16,2,44100 -i resample,22050,foo.wav -o /dev/dsp . . . 'auto' . Ecasound . wav . 'auto' : ecasound -f:16,2,44100 -i resample,auto,foo.wav -o /dev/dsp. N ( "-i resample,22050,foo.wav,bar1,bar2" "bar1,bar2" "foo.wav" ). Ecasound libsamplerate 'resample-hq' . Ecasound 'resampler-lq' ( ) . - 'reverse' 'reverse' . : ecasound -i reverse,foo.wav -o /dev/dsp 'foo.wav' ( ) . . ! (seek) ( mp3) . (wav raw) . N ( "-i reverse,foo.wav,bar1,bar2" "bar1,bar2" "foo.wav" ). - 'stdin' 'stdout' stdin stdout . (.raw) . (named pipes) . - 'tone' -i:tone,type,freq,duration-secs . 'type' : 'sine' () . 'freq' 'duration-secs' . . Ecasound .. . - 'typeselect' 'typeselect' Ecasound . : ecasound -i typeselect,.mp3,an_mp3_file.wav -o /dev/dsp 'an_mp3_file.wav' mp3 wav typeselect . N ( "-i typeselect,.au,foo.wav,bar1,bar2" "bar1,bar2" "foo.wav" ). MIDI (MIDI SETUP) / MIDI - MIDI MIDI ( ecasoundrc(5) ). -Md:rawmidi,device_name / rawmidi MIDI . 'device_name' MIDI . OSS rawmidi (/dev/midi00) ALSA rawmidi (/dev/snd/midiC2D0) ( mkfifo ) . -Md:alsaseq,sequencer-port ALSA MIDI . 'sequencer-port' . ( 128:1) ( "KMidimon"). -Mms:device_id ("Deferred Play") ("Stop") MMC 'device_id'. Ecasound MMC Ecasound / JACK JackMMC JackCtlMMC ( ) MMC JACK . -Mss MIDI ( "MIDI Start" "MIDI Stop") MIDI . Ecasound MIDI-clock start stop . (EFFECT SETUP) (PRESETS) Ecasound . Ecasound . -pf:preset_file.eep 'preset_file.eep' . -pn:preset_name 'preset_name' . ecasoundrc . (SIGNAL ANALYSIS) -ev (clipping). '-ea' () . . -evp (peak amplitude watcher). . . -ezf DC. -ezx . (GENERAL SIGNAL PROCESSING ALGORITHMS) -eS:stamp-id (Audio stamp). (snapshot) 'stamp-id' ( ) . . -ea:amplify% 'amplify%' ( 'amplify%/100' ). '-eadb' . -eac:amplify%,channel 'channel' amplify-% ( 'amplify%/100' ). 'channel' 1 n n . '-eadb' . -eadb:gain-dB[,channel] 'gain-dB' 0dB . 'channel' ( 1 n) . 'channel' . -eaw:amplify%,max-clipped-samples amplify-%. (clipped) 'max-clipped-samples' ( [-1,1] ) . -eal:limit-% (Limiter). 'limit-%' ( ) 100% . -ec:rate,threshold-% ( ). 'rate' ('rate' 1dB ). 'threshold' 0.0 () 1.0 ( ) . -eca:peak-level-%, release-time-sec, fast-crate, crate ( John S. Dyson). 0 . 'peak-level-%' 69% . 'release_time' . (release) . 'fastrate' 1.0 0.50 2:1 0.25 2:1 . 'rate' 1.0 0.5 . -enm:threshold-level-%,pre-hold-time-msec,attack-time-msec,post-hold-time-msec,release-time-msec (Noise gate). ( ). 'threshold_level_%' (100% ) . 'th_time' 'attack' (fade out) . 'threshold_level' 'hold' 'release' . -ei:pitch-shift-% (Pitch shifter). . -epp:right-% (Stereo panner). . 'right-%' 0 () '100' () . -ezx:channel-count,delta-ch1,...,delta-chN DC 'delta-chX' X . -ezf . (ENVELOPE MODULATION) -eemb:bpm,on-time-% ( bpm ). -eemp:freq-Hz,on-time-% . -eemt:bpm,depth-% (Tremolo) ( bpm ). (FILTER EFFECTS) -ef1:center_freq, width (Resonant bandpass filter). 'center_freq' . . -ef3:cutoff_freq, reso, gain (Resonant lowpass filter). 'cutoffr_freq' . 'reso' () 1.0 2.0 . 'gain' (1.0 ) ..IP -ef4:cutoff, resonance ( Stefan M. Fendt). RC-lowpass . [0,1] [0,infinity) . -efa:delay-samples,feedback-% (Allpass filter). . . -efc:delay-samples,radius (Comb filter). . 'radius' [0, 1.0) . -efb:center-freq,width (Bandpass filter). 'center_freq' . . -efh:cutoff-freq (Highpass filter). 'cutoff_freq' . -efi:delay-samples,radius (Inverse comb filter). . 'delay_in_samples-2' . 'radius' [0, 1.0) . -efl:cutoff-freq (Lowpass filter). 'cutoff_freq' . -efr:center-freq,width (Bandreject filter). 'center_freq' . . -efs:center-freq,width (Resonator). 'center_freq' . . . CHANNEL MIXING / ROUTING -chcopy:from-channel, to-channel 'from_channel' 'to_channel'. 'to_channel' . 1 . .. ecasound . -chmove:from-channel, to-channel 'from_channel' 'to_channel' (mute) 'from_channel'. 1 . .. ecasound . -chorder:ch1,...,chN / . 'N' . . '-chorder:2,1' ('out1,out2' = 'in2,in1'). '-chorder:2,2' ('out1,out2' = 'in2,in2'). 'chX' 'X' . .. ecasound . -chmix:to-channel 'to_channel'. 'to_channel' . 1 . .. ecasound . -chmute:channel 'channel'. 1 . .. ecasound . -erc:from-channel,to-channel -chcopy . -erm:to-channel -chmix . TIME-BASED EFFECTS -etc:delay-time-msec,variance-time-samples,feedback-%,lfo-freq (Chorus). -etd:delay-time-msec,surround-mode,number-of-delays,mix-%,feedback-% (Delay). 'delay time' . 'surround-mode' : 0 = 1 = (surround) 2 = (stereo-spread). 'number_of_delays' CPU . 'mix-%' 0 100 50 () . 'feedback-%' 'number_of_delays' 'mix-%' 100% ( ). -ete:room_size,feedback-%,wet-% ( / Reverb) ( Stefan M. Fendt). 'room_size' 'feedback-%' 'wet-%' . -etf:delay-time-msec (Fake- stereo). ( 'delay time' ) . -etl:delay-time-msec,variance-time-samples,feedback-%,lfo-freq (Flanger). -etm:delay-time-msec,number-of-delays,mix-% (Multitap delay). 'delay time' 'number_of_delays' 'mix-%' (wet) . -etp:delay-time-msec,variance-time-samples,feedback-%,lfo-freq (Phaser). -etr:delay-time,surround-mode,feedback-% (Reverb). 'delay time' 'surround-mode' 'surround' 'feedback-%' . LADSPA-PLUGINS -el:plugin_unique_name,param-1,...,param-N LADSPA ( ) . N . / . ( LADSPA ). (.so) . @prefix@/lib/ladspa ( "/usr/local/lib/ladspa") LADSPA_PATH . ecasoundrc ecasoundrc(5) . . LADSPA LAD . LADSPA LADSPA . -eli:plugin_unique_number,param-1,...,param-N (-el) . LADSPA . LV2 PLUGINS -elv2:plugin-id-uri,param-1,...,param-N LV2 . LV2 . / . ( LV2 ). LV2 . GATE SETUP -gc:start-time,len (Time crop gate). . 'start-time' 'len' . . -ge:open-threshold-%,close-thold-%,volume-mode,reopen-count (Threshold gate). . 'othreshold' . 'cthold' 'reopen-count' . 'value_mode' 'rms' RMS . . 'reopen-count' reopen count 1 . 'reopen-count' . 'reopen-count' . . / . -gm:state (Manual gate). 'state' 1 . 'state' . ( ) . CONTROL ENVELOPE SETUP . (= / ) . . 'fx_param' . '1' '2' . 'start_value' 'end_value' . (EXAMPLES) . -kos:fx-param,start-value,end-value,freq,i-phase 'freq' 'i_phase' (pi). -kog:fx-param,start-value,end-value,freq,mode,point-pairs,first-value,last-value,pos1,value1,... (Generic oscillator). 'freq' '0' '1' . 'point-pairs' 'posN' - 'valueN' . 'first-value' 'last-value' ( 0.0/ 1.0/) . 'posN' 'valueN' 0.0 1.0 . 'posN' 'pos1 < pos2 < ... < posN' . -kf:fx-param,start-value,end-value,freq,mode,genosc-number (Generic oscillator). 'genosc_number' . '0' '1' . ./ecasoundrc ( ecasoundrc ). -kl:fx-param,start-value,end-value,time-seconds 'start_value' 'time_in_seconds' 'end_value' . (fade-in) (fade-out) . -kl2:fx-param,start-value,end-value,1st-stage-length-sec,2nd-stage-length-sec (fade-in fade-out). '1st_stage_length' 'start_value' '2nd_stage_length' 'end_value' . -klg:fx-param,low-value,high-value,point_count,pos1,value1,...,posN,valueN (Generic linear envelope). . 'point_count' . . 'point_count' ( 'N==point_count'). 'posX' ( ) . (float) '[0,1]' . '[low-value,high-value]' '0' 'low-value' '1' 'high-value' . '[0,pos1]' 'value1' ( 'low-value') . -km:fx-param,start-value,end-value,controller,channel MIDI ( Control Change). MIDI 'channel' 'controller' . MIDI 1 16 . 0 127 . MIDI -Md . MIDI ~ecasound/ecasoundrc ( ecasoundrc ). /dev/midi . . 'stamp-id' ( '-eS:id' ) . 'rms-toggle' RMS-volume . (peak-amplitude) . -kx . -kx . . (INTERACTIVE MODE) ecasound-iam(1) . (ENVIRONMENT) ECASOUND ECASOUND ecasound . ECASOUND_LOGFILE . ECASOUND_LOGFILE . ECI/EIAM . ECASOUND_LOGLEVEL ECASOUND_LOGFILE . -d:level . . -d:319 ( 'functions (64)' 'continuous (128)'). COLUMNS Ecasound (trace) COLUMNS . COLUMNS 74 . TMPDIR Ecasound ( "cs-edit") . "/tmp" TMPDIR . (RETURN VALUES) ecasound . () : 1 (chainsetup) . . 2 . . 3 . : . 4 / . 'SIGNALS' . (SIGNALS) ecasound POSIX SIGINT (ctrl-c) SIGHUP SIGTERM SIGQUIT . . ecasound ( POSIX) ecasound . . . Ecasound '4' . SIGINT (ctrl-c) . SIGINT ecasound 'stderr' . SIGINT ( ) . ~/.ecasound ecasound. ecasoundrc (5) . *.ecs Chainsetup ecasound. . *.ecp Chain Preset ecasound. (effect) . ecasound . *.ews Ecasound Wave Stats. . (EXAMPLES) ecasound : http://nosignal.fi/ecasound/Documentation/examples.html (SEE ALSO) ecatools (1) ecasound-iam (1) ecasoundrc (5) " HTML Documentation" (BUGS) BUGS . ecasound (debug level) . (AUTHORS) Kai Vehmanen, > 05.05.2011 ecasound(1)