scritcher/doc/README.md
2019-10-25 07:09:39 -03:00

5.7 KiB

scritcher command reference

scritcher scripts are shell-like commands separated by a semicolon.

parameters of the arg type

some commands allow a :N syntax where N is an integer to use a given argument when scritcher is called. so, for example, calling a script:

load :0;
showpath;

and then doing scritcher path/to/script.scri arg will print arg on the screen and then exit.

split and index arguments

plugin commands have a split and an index argument so that you can select where in the file you want the plugin to be ran.

so, if you did plugin 3 1..., it would split the file in 3, then get the part that is of index 1 (starting at 0).

Keep in mind parts start from the bottom of the file.

load path_or_arg

Load a file into memory. The file MUST end with the bmp extension (and so MUST be a bmp. feel free to put other files, no warranties are given.)

amp split index gain

Run the eg-amp plugin over the given slice of the file.

rflanger split index delay_depth_avg law_freq

Run the Retro Flanger script from the SWH plugins.

Parameters:

  • delay_depth_avg: Average stall (ms), 0..10, default 2.5
  • law_freq: Flange frequency (Hz), 0.5..8, default 1

eq split index lo mid hi

Run the DJ EQ plugin from the SWH plugins.

lo, mid, and hi are the respective dB gains for each frequency range.

All three ranges accept gains from -70dB to +6dB. Default is 0 for all (no action taken).

phaser split index lfo_rate lfo_depth fb spread

Run the LFO Phaser plugin from the SWH plugins.

Parameters:

  • lfo_rate: LFO Rate (Hz), 0..100, default 25
  • lfo_depth: LFO depth, 0..1, default 0.25
  • fb: Feedback, -1..1, default 0
  • spread: Spread (octaves), 0..2, default 1

mbeq split index band_1 band_2 band_3 band_4 band_5 band_6 band_7 band_8 band_9 band_10 band_11 band_12 band_13 band_14 band_15

Multiband EQ from the SWH plugins.

In respective order, the band arugments represent the: 50Hz, 100Hz, 156Hz, 220Hz, 311Hz, 440Hz, 622Hz, 880Hz 1250Hz, 1750Hz, 2500Hz, 3500Hz, 5000Hz, 10000Hz and 20000Hz frequencies.

All of them represent the band's gain in dB. The range is -70 to +30dB, default is 0.

chorus split index voices delay_base voice_spread detune law_freq attendb

Multivoice Chrorus from the SWH plugins.

Parameters:

  • voices: Number of voices (int), 1..8, default 1
  • delay_base: Delay base (ms), 10..40, default 10
  • voice_spread: Voice separation (ms), 0-2, default 0.5
  • detune: Detune (%), 0..5, default 1
  • law_freq: LFO frequency (Hz), 2..30, default 9
  • attendb: Output attenuation (dB), -20..0, default 0

pitchscaler split index mult

Runs the Higher Quality Pitch Scaler from the SWH plugins.

The mult parameter is the pitch coefficient, range from 0.5..2, default 1.

reverb split index roomLength roomWidth roomHeight sourceLR sourceFB listLR listFB hpf warmth diffusion

Run the Early Reflection Reverb from the Invada Studio plugins.

Parameters:

  • roomLength: Room Length, 3..100, default 25
  • roomWidth: Room Length, 3..100, default 30
  • roomHeight: Room Length, 3..100, default 10
  • sourceLR: Source Pan, -1..1, default -0.01
  • sourceFB: Source (F/B), 0.5..1, default 0.8
  • listLR: Listener Pan, -1..1, default 0.01
  • listFB: Listener (F/B), 0..0.5, default 0.2
  • hpf: HPF (High Pass Filter), 20..2000, default 1000 (most likely you want 20)
  • warmth: Warmth, 0..100, default 50
  • diffusion: Diffusion, 0..100, default 50

highpass split index freq gain noClip

Run the High Pass Filter from the Invada Studio plugins.

Parameters:

  • freq: Frequency. 20..20000, default 1000
  • gain: Gain, 0..12, default 0
  • noClip: Soft Clip (assumed boolean), 0..1, default 0

delay split index seed gain feedback_pc tap_count first_delay delay_range delay_scale delay_rand_pc gain_scale wet

Parameters:

  • seed: Random seed, 0..1000, default 0
  • gain: Input gain (dB), -96..24, default 0
  • feedback_pc: Feedback (%), 0..100, default 0
  • tap_count: Number of taps, 2..128, default 2
  • first_delay: First delay (s), 0..5, default 0
  • delay_range: Delay range (s), 0..6, default 6
  • delay_scale: Delay change, 0..5, default 1
  • delay_rand_pc: Delay random (%), 0..100, default 0
  • gain_scale: Amplitude change, 0.2..5, default 1
  • wet: Dry/wet mix, 0..1, default 1

vinyl split index year warp click wear

VyNil effect from SWH.

Parameters:

  • year: Year (int), 1900..1990, default 1990
  • rpm: RPM (int), 33..78, default 33
  • warp: Surface Warping, 0..1, default 0
  • click: Crackle, 0..1, default 0
  • wear: Wear, 0..1, default 0

revdelay split index delay_time dry_level wet_level feedback xfade_samp

Parameters:

  • delay_time: Delay time (s), 0..5, default 0
  • dry_level: Dry Level (dB), -70..0, default 0
  • wet_level: Wet Level (dB), -70..0, default 0,
  • feedback: Feedback, 0..1, default 0
  • xfade_samp: Crossfade samples (int), 0..5000, default 1250

wildnoise/noise split index seed repeat_bytes

Inject random noise on the image.

the wildnoise version gives a harder version than noise.

Parameters:

  • seed, Random seed
  • repeat_bytes, Amount of bytes to preload with random data and repeat throughout the image slice

rotate deg bgfill

Rotate the image by deg degrees, filling the resulting triangles with bgfill.

bgfill is a hex string, e.g #000000.

embed split index path_to_file

embed an audio file in the given image. the file is opened with libsndfile, which means some formats, like mp3, will not be opened.

quicksave

Save the file on the same directory of the file specified by load, but with a suffix on the filename (before extension).

Doing consecutive quicksaves will not overwrite any files, the suffixes will just be different.