Clatter CLI

Use the Clatter command-line executable to generate audio and save it as a .wav file.

Download:

Linux OSX Windows 

Linux and OS X users may need to run chmod +x clatter after downloading.

Example call to write impact audio:

./clatter.exe --primary_material glass_1 --primary_amp 0.2 --primary_resonance 0.2 --primary_mass 1 --secondary_material stone_4 --secondary_amp 0.5 --secondary_resonance 0.1 --secondary_mass 100 --speed 1 --type impact --path out.wav

Example call to write scrape audio:

./clatter.exe --primary_material glass_1 --primary_amp 0.2 --primary_resonance 0.2 --primary_mass 1 --secondary_material stone_4 --secondary_amp 0.5 --secondary_resonance 0.1 --secondary_mass 100 --speed 1 --type scrape --scrape_material ceramic --duration 3 --path out.wav

Not all arguments are shown in these examples. For a full list of arguments:

./clatter.exe --help

The --path argument is optional; if you omit it, the wav data (without a header) will be written to standard out, which can allow you to treat the clatter CLI as a library. In this example, we call clatter.exe from a Python script, read stdout and play the audio using pygame:

from time import sleep
from subprocess import run, PIPE
import pygame.mixer

resp = run(['./clatter.exe',
            '--primary_material', 'glass_1',
            '--primary_amp', '0.2',
            '--primary_resonance', '0.2',
            '--primary_mass', '1',
            '--secondary_material', 'stone_4',
            '--secondary_amp', '0.5',
            '--secondary_resonance', '0.1',
            '--secondary_mass', '100',
            '--speed', '1',
            '--type', 'impact'],
           check=True,
           stdout=PIPE)
pygame.mixer.init(allowedchanges=pygame.AUDIO_ALLOW_CHANNELS_CHANGE)
sound = pygame.mixer.Sound(resp.stdout)
sound.play()
sleep(sound.get_length())