JACK_CAPTURE(1)

πŸ‘‘ JACK_CAPTURE β€” the Debian manual page, but make it cute πŸ’–

okay bestie, welcome to JACK_CAPTURE(1) from the General Commands Manual section. this is the page for jack_capture, a program for recording literally anything from jack. grab a snack, we're going in πŸ“


✨ NAME ✨

jack_capture β€” a program for recording anything from jack πŸŽ™οΈ


πŸ¦‹ SYNOPSIS πŸ¦‹

jack_capture [options]
bar [options]

(yes, bar is really in there. we don't ask questions, we just report the facts πŸ’…)


🌸 DESCRIPTION 🌸

so this manual page documents the jack_capture command briefly. quick lore drop: this manual page was written for the Debian distribution because the original program does not have a manual page. so we made one. you're welcome 🫢

jack_capture is a cli program for recording any audio signal from jack to audio audio formats supported by the libsndfile library (wav, aiff, ogg, flac, wavex, au, etc.) πŸ”₯

for more info about libsndfile see <http://www.mega-nerd.com/libsndfile/api.html#open> β€” well, the URL is http://www.mega-nerd.com/libsndfile/api.html#open, go read it, it's giving documentation energy ✨


πŸ’… OPTIONS πŸ’…

these programs follow the usual GNU command line syntax, with long options starting with two dashes (-). a summary of options is included below, and no we did not skip any, we would never πŸ™ˆ

  • -b, --bitdepth n β€” is by default FLOAT. it can be set to either 8, 16, 24 or 32. (for relevant formats) ⭐
  • -c, --channels n β€” is by default 2. 🎧
  • -p, --port port β€” is by default set to the two first physical outputs. the port argument can be specified more than once. πŸ‘‘
  • -d, --duration s β€” recording is stopped after s seconds. ⏱️
  • -z, --leading-zeros n β€” n is the number of zeros to in the autogenerated filename. (-z 2 -> jack_capture_001.wav, and so on.) (default is 1) πŸŽ€
  • -f, --format format β€” selects fileformat provided by libsndfile. see http://www.mega-nerd.com/libsndfile/api.html#open (default is wav for 1 or 2 channels, and wavex for more than 2.) 🌈
  • -pf, --print-formats β€” prints all sound formats provided to sndfile to screen and then exits. πŸ–¨οΈ
  • -v, --version β€” prints out version. πŸ’œ
  • -s, --silent β€” suppress some common messages printed to the terminal. 🀫
  • -V, --verbose] β€” prints some extra information to the terminal. (yes, the ] is in the original, we are simply honoring it, no cap πŸ’€)
  • -mp3, --mp3 β€” writes to an mp3 file using liblame (LAME). (the --format option has no effect using this option) 🎡
  • -mp3q, --mp3-quality n β€” selects mp3 quality provided by liblame. n=0 is best, n=9 is worst. default n is 2. (0 uses the most amount of CPU, 9 uses the least) ⚑
  • -mp3b, --mp3-bitrate n β€” selects mp3 bitrate (in kbit/s). default is set by liblame. (currently 128) πŸ“Ά
  • -ws, --write-to-stdout β€” writes 16 bit little endian to stdout. (the --format option, the --mp3 option, and some others have no effect using this option) 🫢
  • -dm, --disable-meter β€” disable console meter. πŸ™ˆ
  • -hbu, --hide-buffer-usage β€” disable buffer usage. 🚫
  • -dc, --disable-console β€” disable console updates. same as -dm -hbu. πŸ’€
  • -lm, --linear-meter β€” use linear scale for the console meter (default is dB scale). πŸ“
  • -dBr, --dB-meter-reference β€” specify reference level for dB meter. (default=0) 🎚️
  • -mb, --meterbridge β€” start up meterbridge to monitor recorded sound. πŸŒ‰
  • -mt, --meterbridge-type β€” specify type. vu (default), ppm, dpm, jf or sco. πŸŽ›οΈ
  • -mr, --meterbridge-reference β€” specify reference level for meterbidge. 🎯
  • -jt, --jack-transport β€” start program, but do not start recording until jack transport has started rolling. when jack transport stops, the recording is stopped, and the program ends. πŸš‚
  • -jtm, --jack-transport-multi β€” similar to --jack-transport, but do not end program when jack transport stops. instead, record to a new file when jack_transport start rolling again. (not implemented yet) 😭
  • -B, --bufsize s β€” initial/minimum buffer size in seconds. default is 8 seconds for mp3 files, and 4 seconds for all other formats. 🧺
  • -MB, --maxbufsize β€” maximum buffer size in seconds. jack_capture will allocate. default is 40. (buffer is automatically increased during 🫠 β€” the source text just... stops there. we report, we don't finish sentences for people.)
  • -fn, --filename β€” specify filename. (it's usually easier to set last argument instead) πŸ“

πŸ”₯ EXAMPLES πŸ”₯

jack_capture [--bitdepth n] [--channels n] [--port port] [filename]
jack_capture [-b n] [-c n] [-p port] [filename]

and now the vibe-by-vibe ones:

jack_capture

to record a stereo file of what you hear. πŸ‘‚

ack_capture -f flac

to record a stereo file of what you hear in the flac format. (yes, ack_capture β€” typo's canon now, we keep it fr fr πŸ’€)

jack_capture -f ogg

to record a stereo file of what you hear in the ogg format. 🎢

jack_capture -mp3

to record a stereo file of what you hear in the mp3 format. 🎧

jack_capture --channels 2 --port system:playback*

to record a stereo file of what you hear in the wav format. 🌊

jack_capture --port jamin:out* sound_from_jamin.wav

to record the output from jamin. πŸ“€

jack_capture --port jamin:in* sound_to_jamin.wav

to record all sound coming in to jamin. πŸ“₯

jack_capture --port jamin* sound_to_and_from_jamin.wav

to record all sound coming in and out of jamin. πŸ”

jack_capture -c 2 -p system:capture*

to record a stereo file from the soundcard. πŸ’³ (ok not a credit card, the sound card. still iconic)


🧚 SEE ALSO 🧚

jackd(1).


πŸ’– AUTHOR πŸ’–

jack_capture was written by Kjetil Matheussen. πŸ‘‘

this manual page was written by Jaromír Mikeő <mira.mikes@seznam.cz>, for the Debian project (but may be used by others). 🫢


and that's the whole thing, bestie! this lil page is from the JACK_CAPTURE(1) manual, dated July 28, 2010 β€” yes, 2010, vintage, retro, the original main character energy πŸ‘‘βœ¨ thanks for reading, mwah πŸ’…πŸŽ€πŸ¦‹