CHUCK(1)

🌸 CHUCK(1) 🌸

okay bestie, welcome to the chuck manual page — this is a General Commands Manual entry, and we're about to make it make sense. chuck is an audio programming language for real-time synthesis, composition, and performance. buckle up. 💖

---

✨ NAME ✨

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

---

✨ SYNOPSIS ✨

chuck [--halt]  [--loop]  [--audio]  [--silent]  [--dump]  [--nodump]
[--about]  [--srateN]  [--bufsizeN]  [--bufnumN]  [--dacN]  [--adcN]
[--remotehostname]  [--portN]  [--verboseN]  [--probe]  [--blocking]
[--callback]  [--add]  [--remove]  [--replace]  [--status]  [--time]
[--kill]  [--version]  [+]  [-]  [=]  [^]  [file1]  [file2]  [file2]

(yes, [file2] is in there twice. iconic. we don't question it. 💅)

---

✨ DESCRIPTION ✨

This manual page documents briefly the chuck commands. just the highlights, bestie.

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

chuck presents a new time-based concurrent programming model, which supports:

• multiple, simultaneous, dynamic control rates
• the ability to add, remove, and modify code on-the-fly
• all of that while the program is running — no stopping, no restarting, no drama 🫶

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. (all of them. we're not skipping a single one, periodt. 💯)

• --add file.ck — add a file to a running chuck server. 🎀
• --remove shrednumber — remove a shred from 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. (the glow-up shortcuts, iykyk 💅)
• --time — get the current time. ⏰
• --kill — kill the chuck server. 💀 (dramatic but accurate)
• --halt — start in halt mode (this is the default).
• --loop — start chuck in loop mode (aka daemon mode). 🔄
• --audio — start server with audio (this is the default).
• --silent — start server in silent mode. 🤫
• --dump — dump compilation result (verbose mode).
• --nodump — do not dump compilation result.
• --srateN — set sampling rate (defaults to 48000 for jack, auto detected otherwise). 🎚️
• --bufsizeN — set buffer size.
• --bufnumN — set number of buffer.
• --dacN — set output audio device.
• --adcN — set input audio device.
• --remotehostname — connect to remote hostname. 🌐
• --portN — connect/listen on port number N.
• --verboseN — 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 📖 — go read it, bestie, it's giving documentation.

---

✨ EXAMPLES ✨

okay so here's the whole vibe in action:

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

$ chuck otf_01.ck &

$ chuck --add otf_02.ck &

$ chuck + otf_0[4567].ck

$ chuck - 0

$ chuck --kill

run it, add to it, glob it, remove a shred, then kill it. main character energy from start to finish. 🔥

---

✨ 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. 📜

---

and that's the whole page, bestie — no cap, every single flag accounted for. 💖

that's a wrap on CHUCK(1) from the General Commands Manual — go make some noise, you absolute icon 👑✨🎀