Chuck Examples

The following are example programs that demonstrate basic language features, tools, and techniques. All of these examples files can be found in the distribution (download page) under the folder examples. Additionally, they can be accessed from within miniAudicle, under "File > Open Example..." Many of these examples are also linked from the ChucK API Reference. Good luck and have fun!

Jump to Section

various basic examples

basic demonstrations
"deep" stuff
more fun examples

language features

types
arrays
operators
time and duration
control structures
functions
shreds & concurrency
virtual machine functions

tools & techniques

classes & objects
@import system
extending unit generators
events
input/output (including file I/O)
HID (keyboard, mouse, joystick)
MIDI input/output
Open Sound Control
serial I/O
stereo & multi-channel
live sampling & granular synthesis
string utilities

(more) examples

filters
Synthesis Toolkit (STK)
unit analyzer examples
ChucK for AI (ChAI)

Various Basic Examples

A selection of examples that demonstrate basic sound generation, timing, and control in ChucK. As with all examples here, feel free to try and experiment!

Basic Demonstrations
time and duration	demo0
variable assignment and use	demo1
chucking & unchucking ugens	demo2
modulating ugen parameters	demo3
using command line arguments	args
mic input	adc
ADSR method	adsr
a chuckian alarm clock (no warranties!)	alarm
digital delay	delay \| delay2
simple comb filter using Delay	comb
echo effect	echo
using Envelope	envelope \| envelope2
knuckleheads (time shifted phase locking)	larry \| curly \| moe
knuckleheads++ (with glottal voicing)	larry++ \| curly++ \| moe++
function demo	func
po-tweet!	chirp \| chirp2
the uh, whole tone scale	whole
sinosc + blit (bandlimited oscillators)	foo \| foo2 \| blit \| blit2 \| blit3
FM synthesis "by hand"	fm
FM synthesis with two sinosc	fm2
FM (actual frequency modulation)	fm3
oscillators	oscillatronx
mic input and simple comb filter	i-robot
impulse generator	imp
low-frequency oscillator	lfo
recording (via WvOut)	rec \| rec-auto \| rec-auto-stereo
clocks (useful when recording and other)	tick \| tick2
basic ring-mod (demonstrate ugen input)	ring
sndbuf (file read/write/playback)	sndbuf \| doh
sndbuf.valueat() - random access samples	valueat
step ugen	step
unchuck	unchuck
whirl	whirl
noise & filters	wind \| wind2
function test	zerox
math.isinf() also math.isnan()	infnan
input/output (including FileIO) examples	[directory: io]
"Deep" Stuff
formant-based singing synthesis	chant
audio dithering "by hand"	dither
how phones dial	dtmf
one pole envelope follower	follower
karplus strong plucked string	plu.ck
plucked string with mandolin body excitation	plu2.ck
tuned plucked string (a la jaffe/smith)	plu3.ck
karplus strong comb-filter bank chugraph	ks-chord.ck
say "ChucK" through synthesis	say-chu.ck
Shepard Tone generator	shepard
Super Mario Bros. theme, recreated in ChucK	smb
THX Deep Note emulator (info)	thx
Reich's Clapping Music using glottal pulses	unclap
More Fun Experiments
variations on towers of hanoi sonification	hanoi (no sound) \| hanoi2 \| hanoi3
on-the-fly synchronization (concurrent)	otf_01 \| otf_02 \| otf_03 \| otf_04 \| otf_05 \| otf_06 \| otf_07 \| data/
Can't decide? Flip a coin with *maybe*!	maybe
Different shades of RNG	randomize
Okay, not that fun, but really useful	map

Language Features

These examples demonstrate features described in the ChucK Language Specification.

Types
Survey of chuck's primitive types	type_primitives
Object type (more later)	type_object
The 'auto' type	type_auto
Polymorphism in ChucK	polymorph
Analysis-related type	type_analysis
Working with the Type type	type_type
Querying active types in the VM	type_query
Vectors 3D + 4D	vec3 \| vec4
Using vec3 as a slewing interpolator	interpolate
Arrays
store and retrieve values	array_storage
appending to an array	array_append
for-each in array	foreach-1 \| foreach-2 \| foreach-3 \| foreach-4 \| foreach-5 \| foreach-6
for-each in array (with auto type)	foreach-auto1 \| foreach-auto2
arrays are automatically resized (e.g., using append and popBack)	array_dynamic
erasing elements in an array	array_erase \| array_erase2
array @=> assignment	array_assign
instantiating multidimensional arrays	array_mdim
reassigning sub-arrays	array_sub_assign
array as function argument	array_argument
multi-dimensional array instantiation	array_mdim
mixed associative and linear array	array_mmixed
generating arrays containing ranges of values	array_range
resizing arrays	array_resized
negative indexing of arrays	array_negative
reversing an array	array_reverse
shuffling an array	array_shuffle
zeroing the elements an array	array_zero
Operators
operators for assignment	oper_assign
logical operators	oper_logic
pre/post increment	oper_pre_inc \| oper_post_inc
arithmetic operators	oper_arith_chuck
Time & Timing
time and duration	time_types
reasoning about time	time_operations
Control Structures
for loop	ctrl_for_loop
for-each loop	ctrl_foreach
repeat	ctrl_repeat
until	ctrl_until
do-until	ctrl_do_until
while	ctrl_while
do-while	ctrl_do_while
break	ctrl_break
break w/ nesting	ctrl_break_nested
continue w/ nested blocks	ctrl_continue
Philip's sequencer	ctrl_sequencer
Functions
function overloading	func_overload \| func_overload_member \| func_overload_multi
recursive function calls	func_recursion
objects as function arguments	func_obj_arg
Shreds & Concurrency
sporking shreds	spork \| spork2
sporking many shreds	powerup
Machine.add() .remove() .replace()	machine
Virtual Machine functions
evaluating string as code	eval \| eval-global
VM operations hodge-podge	machine-help \| version \| is-realtime \| intsize \| crash

Tools and Techniques

These examples demonstrate pratical tools ranging from unit generators, events, mouse / keyboard / joystick input, file I/O, MIDI, Open Sound Control, how to extend ChucK unit generators, and more.

Classes & Objects
Dinky instrument implemented as class	dinky
class constructors and destructor	constructors \| ctors-dtor \| destructor
class static variables	static-init \| import-test-3
learning about objects with .help()	help
a file that used the class Dinky	try
@import
@import CK files (see @import documentation)	Foo (target) \| import-test-1 (importer) \| import-test-1e (importer)
a more extensive example	ks-chord (target) \| import-test-2 (importer)
Extending ChucK Unit Generators
chugraph (rhymes with "u-graph")	chugraph
chugen (rhymes with "ugen")	chugen
chugin (rhymes with "plugin")	see "3 ways to extend ChucK"
Events
event broadcast method	broadcast
event signal method	signal \| signal4
extending events (creating custom events)	event-extend \| event-extend2
Input/Ouput
chout ("shout") and cherr ("Cher")	chout
file directory access	dir
file input: reading ints	read-int \| read-int.txt
file input: reading floats	read-float \| read-float.txt
file input: reading lines	read-line \| read-line.txt
file input: reading tokens	read-tokens \| jabberwocky.txt
file input: reading strings	read-str \| read-str.txt
file input (binary mode): reading bytes	read-byte \| read-byte.txt
file input (binary mode): parsing a WAV file	read-wav-raw \| saigon44.wav
file output	write \| write2
file output (binary mode): writing bytes	write-byte
HID Input (Joystick, Mouse, Keyboard)
Joystick demo	joy \| joy-fm \| joy-noise \| joy-shake
Mouse demo	mouse \| mouse-abs \| mouse-fm
Keyboard demo	kb \| keyboard-organ
Gametrak demo	gametra.ck
"SMELT: Small Musically Expressive Laptop Toolkit"	S.M.E.L.T.
Keyboard (terminal only; see HID usage above)	kbhit \| kbhit2
MIDI
MIDI input	gomidi \| gomidi2
MIDI input with polophony	polyfony \| polyfony2
MIDI file reader / player!	midifile-play \| bwv772.mid
MIDI output	midiout \| midiout2
Open Sound Control (OSC)
OSC message sender and receiver	s (sender) \| r (receiver) \| r2 (receiver; alternate)
OSC multiple message at different rate	s-multi-msg \| r-multi-msg
OSC one sender to many receivers	s-sender \| r.ck
OSC multicast (broadcast to local area hosts)	s-multicast \| r.ck
OSC message dumper	osc-dump
Serial I/O
reading byte(s)	byte \| bytes
reading ascii/binary	ints-ascii \| ints-binary \| lines
writing	write-bytes \| write
listing serial devices	list
Arduino INO file	ckserial.ino
Stereo / Multi-channel
Stereo noise (using Pan2)	stereo-noise
Stereo powerup	powerup2
Stereo => arrays of mono UGens	ugen-array
Stereo Stooges	moe2 \| larry2 \| curly2
Multi-channel demos	n-chan (i) \| n-chan (n) \| we-robot
Live Sampling and Granular Synthesis Using LiSa
Basics of live sampling using LiSa	readme-LiSa1 \| readme-LiSa2
Live sampling simple looping	LiSa-simplelooping
LiSa2 stereo	LiSa-stereo
Granular sampling examples	LiSa-munger1 \| LiSa-munger2 \| LiSa-munger3
Granular synthesis example from Twilight (2013)	twilight-granular-kb \| twilight-granular-kb-interp \| twilight-granular.aiff \| folder
Granular synthesis example: Scream-o-Matic 2000	scream-o-matic \| data files
Loading an audio file into a LiSa	LiSa-load
LiSa tracking mode examples	LiSa-track1 \| LiSa-track2 \| LiSa-track3 \| LiSa-track4 \| LiSa-track5 \| geetar.wav
Input-driven LiSA trigger	LiSa-trigger
String Utilities
String operations	strops \| strops2
String escape sequences	escape
String input + tokenize (hacked; temporary)	readline \| token
(More) Unit Generators Examples
> Filters
low pass filter	lpf
resonance low pass filter	rlpf
high pass filter	hpf
resonance high pass filter	rlpf
resonance filter with equal-gain zeros	resonz
band pass filter	bpf
band reject filter	brf
> STK ( Synthesis ToolKit ) demos
BandedWG (Banded Waveguide)	bandedwg \| band-o-matic
BlowBotl	blowbotl \| blowbotl2
BlowHole	blowhole
Bowed	bowed
Brass	brass
Clarinet	clarinet
Flute	flute
FrncHrn	frenchrn-aglo2
HevyMetl => acoustic guitar	hevymetl-acoustic-algo3
HevyMetl => power chords	hevymetl-dance-now
HevyMetl => trumpet	hevymetl-trumpet-algo3
HnkyTonk	honkeytonk-algo1 \| jacobass-algo1 \| nylon-guitar-algo1
KrstlChr	krstlchr-algo7
Mandolin	mandolin \| mand-o-matic
ModalBar	modalbar \| mode-o-test \| mode-o-matic
Moog (r.i.p. bob)	moog \| moogie
Rhodey (Rhodes synth)	rhodey
A lovely littel number made with Rhodey...	rhodey-song
Saxofony	saxofony
Shakers	shake-o-matic
Sitar	sitar
StifKarp	stifkarp \| stif-o-karp
TubeBell	tubebell-algo5
VoicForm	voic-o-form
Wurley (Wurlitzer model)	wurley \| wurley2 \| wurley3
Unit Analyzers
> Transformations
FFT	fft \| fft2 \| fft3
IFFT	ifft \| ifft2 \| ifft3
DCT	dct
Windowing	win
Flip / UnFlip	flip
auto-correlation-based pitch detection	autocorr
cross-correlation delay detection	xcorr
(really bad) spectral cross-synthesis	xsynth
> Feature Extractors
Centroid	centroid
Chroma	chroma
Flux	flux \| flux0
Kurtosis	kurtosis
MFCC	mfcc-basic \| mfcc-mean
RMS	rms
RollOff	rolloff
SFM	sfm
ZeroX	zerox
Feature Collector	features-combined
Feature Collector (alt use)	concat
Feature-based Genre Classification (part of chai)	features-extract \| genre-classify \| x-validate
ChucK for AI (ChAI) see ChAI landing page and the AI Tools API reference for examples!

ChucK | Examples version: 1.5.x.x (chai)

Chuck Examples

Various Basic Examples

Language Features

Tools and Techniques

ChucK | Examples

version: 1.5.x.x (chai)