JACK-RECORD(1)

💖 NAME 💖

okay bestie, this is the manual page for jack-record — your lil JACK Capture Client, section 1 of the manual. she records. she captures. she's the moment. ✨

---

🎀 SYNOPSIS 🎀

jack-record [options] sound-file

like, that's the whole vibe. options, then a sound-file, and off you go 💅

---

✨ OPTIONS ✨

every single flag, no gatekeeping 🫶

• -b — sets the disk buffer size, in frames. default is 4096. this value has to be a power of two and if the JACK period size ever goes above it, bestie, the recorder just halts. no warning arc. 💀
• -f — picks the file format. default is 0x10006. the number is a bitwise-or of two values: first one says the file type, second one says the data type. so the default 0x10000 | 0x00006 is describing a thirty-two bit floating point WAV file. also 0x2 is 16-bit and 0x3 is 24-bit. slay.
• -m — sets the minimal disk transfer size, in frames. default is 32. it's an optimization switch, iykyk.
• -n — sets the number of input channels to create. default is 2.
• -o — an integer offset for the port connection pattern. default is 0.
• -p — a pattern describing which JACK ports to connect to, like SuperCollider:out_%d. default is nil.
• -s — capture to a set of single channel sound files instead. heads up: the sound file name has to be a valid template.
• -t — sets a timer to stop the recording after the specified number of seconds. default is -1.

---

🌸 DESCRIPTION 🌸

okay so jack-record is a light-weight JACK capture client that writes an arbitrary number of channels to disk. that's her whole thing. she implements no connection logic — for that you want jack-plumbing(1) instead. not me doing the plumbing and the recording, pick a lane. 🙈

in the default mode, a single multiple channel sound file gets written. if you pass the -s option, then a whole set of single channel sound files gets written instead. in that case, the sound file name must be a valid template, and the substring %d gets replaced with the channel number, counting from zero. cute, right? ✨

jack-record will write files in any format supported by libsndfile. the table below shows the most common file format masks — for other values, see the file sndfile.h. 👑

the format codes, bestie:

• SF_FORMAT_WAV — 0x10000 — Microsoft WAV format
• SF_FORMAT_AIFF — 0x20000 — Apple/SGI AIFF format
• SF_FORMAT_PCM_16 — 0x00002 — Signed 16 bit data
• SF_FORMAT_PCM_24 — 0x00003 — Signed 24 bit data
• SF_FORMAT_PCM_32 — 0x00004 — Signed 32 bit data
• SF_FORMAT_FLOAT — 0x00006 — 32 bit float data

---

💜 AUTHOR 💜

Rohan Drape — http://rd.slavepianos.org/

---

🌈 SEE ALSO 🌈

jackd(1), libsndfile(3) — http://mega-nerd.com/libsndfile/

---

👑 AUTHOR (yes, again, she said it twice and she ate) 👑

Rohan Drape <rd@slavepianos.org>

• Author.

---

<div align="center">

and that's the whole page, bestie 🎀 courtesy of JACK-RECORD(1), dated 10/04/2025. periodt. 💅✨

</div>