Home

Awesome

Repository for Officially Supported ChuGins

Build CI

A chugin (or ChuGin) is a plug-in for the ChucK audio programming language. Chugins are loaded at runtime by ChucK or miniAudicle and are fundmental to extending the capabilities of the language by adding class libraries and audio Unit Generators (UGens) and Unit Analyzers (UAnae). This repository contains a number of chugins maintained for all supported platforms (macOS, Linux, Windows) by the ChucK Team in collaboration with their respective authors (see list below). The ChucK Team invites developers to envision and create new chugins, and to help maintain and evolve existing ones. Join us! ChucK Discord Server | ChucK Community.

Read more about it in the original chugins paper and three ways to extend ChucK.

Prepackaged Binaries

Binaries for most chugins in this repository are automatically included by the ChucK installers for macOS and Windows. Install the latest at http://chuck.stanford.edu/release/. You can read the class library reference for these packaged chugins. Linux users (and advanced users on macOS and Windows) can build chugins from source.

Building ChuGins

Clone this repository:

git clone --recurse-submodules https://github.com/ccrma/chugins.git
cd chugins

To compile all chugins in this repository, run make linux (Linux) or make osx (macOS). Windows users can compile using the Visual Studio solution chugins.sln.

Optionally, (Linux and macOS, requires administrative privileges) install the chugins:

sudo make install

Working with Chugins

Chugins are loaded automatically when command-line chuck starts, or when miniAudicle starts the ChucK VM. Once loaded, the contents of chugins can be used directly from the language (see class library documentation for the pre-packaged chugins).

For a chugin to load properly:

  1. the chugin version must be compatible with the host version
  2. the chugin must be located somewhere within one of the default search directories, or be explicitly specified, e.g., using the --chugin:<file> flag on the command line.

To see which chugins are being loaded on your system and their versions (and to detect any version incompatibilities), do one of the following.

If you are using command-line chuck, use the --chugin-probe flag (need chuck-1.5.0.4 or higher) to see a diagnostic of chugins on your system. (Note this option does not actually run any chuck programs.)

chuck --chugin-probe

You can increase the amount of information by additionally specifying the verbosity with --verbose or simply -v:

chuck --chugin-probe -v5

In addition to the chugins and their versions (and any errors), -v5 will show you the default search directories that chuck is scanning for chugins (see below).

Alternately, if you are running chuck programs, you can simply add the -v flag (we recommend -v3 or higher) to whatever chuck files you are running, e.g.,

chuck FILE1.ck foo.ck -v3

You can also toggle whether to load chugins using the --chugin-load command line flag, for example, to run chuck with chugins disabled:

chuck  FILE1.ck FILE2.ck --chugin-load:off

If you are using miniAudicle, you can similarly configure and probe chugins in Preferences. From the main menu, navigate to File->Preferences...->ChuGins tab (see image below). Here you can enable/disable chugins loading, configure the chuings search path, and perform some chugins diagnostic. Pressing the Probe ChuGins button, for example, will print the diagnostic to the miniAudicle Console Monitor. You can control the verbosity level from the main menu: ChucK->Log Level.

<img width="720" alt="ma-mac-probe-chug" src="https://github.com/ccrma/chugins/assets/669967/9f12d3bf-1d7b-4b1c-9dfe-6623c198e11f">

Chugins Search Paths

By deafult, the chugin loader searches recursively in the following directories for chugins (.chug) and chuck extensions (.ck). It is possible to customize these search paths using the --chugin-path:<path> flag with command-line chuck or through Preferences/ChuGins tab in miniAudicle. Note: some of these requires chuck-1.5.0.4 or higher; we recommend always using the latest released version or the main development branch of this repository.

macOS

/usr/local/lib/chuck
/Library/Application Support/ChucK/chugins
~/Library/Application Support/ChucK/chugins
~/.chuck/lib

Linux

/usr/local/lib/chuck
~/.chuck/lib/

Windows

C:\Windows\system32\ChucK
C:\Program Files\ChucK\chugins
C:\Program Files (x86)\ChucK\chugins
C:\Users\%USERNAME%\Documents\ChucK\chugins

List of Chugins in This Repository

Chugins That We Are Working On

Chugins We Would Like to See Happen