---
name: "chuck"
section: "1"
platform: "linux"
package: "chuck"
version: "1.5.5.0-1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/chuck"
---

# chuck(1)

audio programming language for real-time synthesis, composition, and performance

## NAME

chuck — audio programming language for real-time synthesis, composition, and performance

## SYNOPSIS

**chuck** \[**--halt**\]  \[**--loop**\]  \[**--audio**\]  \[**--silent**\]  \[**--dump**\]  \[**--nodump**\]  \[**--about**\]  \[**--srate***N\]  \[***--bufsize***N\]  \[***--bufnum***N\]  \[***--dac***N\]  \[***--adc***N\]  \[***--remote***hostname\]  \[***--port***N\]  \[***--verbose***N\]  \[***--probe***\]  \[***--blocking***\]  \[***--callback***\]  \[***--add***\]  \[***--remove***\]  \[***--replace***\]  \[***--status***\]  \[***--time***\]  \[***--kill***\]  \[***--version***\]  \[***+***\]  \[***-***\]  \[***=***\]  \[***^***\]  \[file1\]  \[file2\]  \[file2\]*

## DESCRIPTION

*This manual page documents briefly the* **chuck** commands.

**chuck** is a new audio programming language  for real-time synthesis, composition, and performance, which runs on commodity  operating systems.

**chuck** presents a new time-based concurrent  programming model, which supports multiple, simultaneous, dynamic control  rates, and the ability to add, remove, and modify code, on-the-fly, while the  program is running, without stopping or restarting.

Use **chuck** for jack audio interfaces,  **chuck.alsa** to access alsa devices,  and **chuck.pulse** to access pulse devices.

## OPTIONS

A summary of options is included below.

- **--add** *file.ck*

  Add a file to a running chuck server.

- **--remove** *shrednumber*

  Remove a shred to a running chuck server.

- **--replace** *shrednumber* *file.ck*

  Replace an existing shred with another file.

- **--status**

  Print chuck server status information.

- **+** **-** **=** **^**

  Shortcuts for add, remove, replace and status.

- **--time**

  Get the current time.

- **--kill**

  Kill the chuck server.

- **--halt**

  Start in halt mode (default).

- **--loop**

  Start chuck in loop mode (daemon mode).

- **--audio**

  Start server with audio (default).

- **--silent**

  Start server in silent mode.

- **--dump**

  Dump compilation result (verbose mode).

- **--nodump**

  Do not dump compilation result.

- **--srate***N*

  Set sampling rate (default to 48000 for jack, auto  detected otherwise).

- **--bufsize***N*

  Set buffer size.

- **--bufnum***N*

  Set number of buffer.

- **--dac***N*

  Set output audio device.

- **--adc***N*

  Set input audio device.

- **--remote***hostname*

  Connect to remote hostname.

- **--port***N*

  Connect/Listen on port number N.

- **--verbose***N*

  Set verbosity level to N.

- **--probe**

  List available audio devices.

- **--blocking**

  Use blocking mode audio access.

- **--callback**

  Use callback mode audio access.

- **--about** **--help**

  Show summary of options.

- **--version**

  Show version of program.

## SEE ALSO

/usr/share/doc/chuck/ChucK\_manual.pdf

## EXAMPLES

$ cd /usr/share/doc/chuck/examples

$ chuck otf\_01.ck &

$ chuck --add otf\_02.ck &

$ chuck + otf\_0\[4567\].ck

$ chuck - 0

$ chuck --kill

## AUTHOR

This manual page was written by Paul Brossier  **\<piem@altern.org\>**.  Permission is granted to copy, distribute and/or  modify this document under the terms of the GNU General Public License,  Version 2 any later version published by the Free Software Foundation.

On Debian systems, the complete text of the GNU General Public  License can be found in /usr/share/common-licenses/GPL.