FAKENECT-RECORD(1)

💖 FAKENECT-RECORD 💖

okay so bestie, welcome to the libfreenect manual, and today's main character is fakenect-record 💅

---

✨ NAME ✨

fakenect-record — the lil program that saves dumps from your kinect straight to a file, no cap 🎀

---

🦋 SYNOPSIS 🦋

fakenect-record [-h] [-ffmpeg] [-ffmpeg-opts options] outputdir

---

🌸 DESCRIPTION 🌸

So fakenect-record dumps the output of the kinect into the outputdir folder. It saves the acceleration, depth, and rgb data as individual files, and the names look like "TYPE-CURRENTIME-TIMESTAMP" where, bestie, let me break it down:

• TYPE is either (a)ccel, (d)epth, or (r)gb
• TIMESTAMP is the timestamp associated with the observation (or, in the case of accel, the last timestamp seen)
• CURRENTTIME is a floating point version of the time in seconds

The whole reason we're storing the current time at all is so that delays can be recreated exactly as they occurred ⭐ iconic behaviour tbh. For RGB and DEPTH, the dump is just the entirety of the data provided in PPM and PGM formats respectively (literally just a 1 line header above the raw dump, that's it). For ACCEL, the dump is the "freenect_raw_tilt_state". Only the front part of the file name gets used — the rest is left undefined (extension, extra info, etc), so don't come for it 🫶

A file called INDEX.txt also gets output, with all of the filenames local to that directory, just to simplify the format (e.g., no need to read the directory structure — we love convenience 💅).

Once it's started, the program will keep acquiring data from the kinect. When you wanna stop it, hit Ctrl-C and the signal will be caught, the runloop stopped, and everything will be stored cleanly ✨ slay.

---

🎀 OPTIONS 🎀

• -ffmpeg — if present, send the the video stream to ffmpeg (yes bestie, "the the", I said what I said 💀)
• -ffmpeg-opts options — when using ffmpeg, specify the options to be used with it. If unspecified, it will use the options "-aspect 4:3 -r 20 -vcodec msmpeg4 -b 30000k"
• -h — display the command-line help 🙈

---

🌈 SEE ALSO 🌈

fakenect(1)

---

and that's the whole vibe check, bestie — go dump some kinect data and be the main character of your own runloop 👑

libfreenect · 2012-01-29 — sending u love from the libfreenect manual, periodt 🫶💖