CHUCK(1)

💖 CHUCK(1) — the manual, but make it a group chat 💖

okay so bestie, welcome to the chuck page — that's section 1 of the General Commands Manual, which is the "user commands" corner of the man-page universe, iykyk. This is the audio programming language for real-time synthesis, composition, and performance, and I'm about to walk you through it like we're texting at 2am. 🎀

---

✨ 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]

---

🌸 DESCRIPTION 🌸

So this manual page is the brief lowdown on the chuck commands — like the trailer, not the whole movie. 🍓

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

Here's the iconic part: chuck presents a new time-based concurrent programming model. It supports multiple, simultaneous, dynamic control rates, and — this is the slay — the ability to add, remove, and modify code on-the-fly while the program is running, without stopping or restarting. Not me being able to hot-swap my own code mid-performance. 😭👑

Use chuck for jack audio interfaces, chuck.alsa to access alsa devices, and chuck.oss to access oss devices. 💜

---

👑 OPTIONS 👑

A summary of options is included below. (Yes, all of them. We do not skip. 💅)

• --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.
• --srateN — set sampling rate (default 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, it's giving the whole lore. 📖

---

🌈 EXAMPLES 🌈

Real talk, here's the whole demo arc:

$ 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.

---

and that's the whole page, bestie 🫶 the footer at the very bottom just says CHUCK(1) again — same section 1, same General Commands Manual — so if you ever forget where you are, the top and the bottom of the page are matching, like a lil outfit. 💖✨ periodt.