SENSE_PLAY(1)

💖 SENSE_PLAY(1) 💖

okay bestie, welcome to the sense-emu manual page for sense_play — it's the Sense HAT emulator playback tool and honestly? she's iconic for it. 🎀

---

✨ NAME ✨

sense_play — Sense HAT emulator playback

Replays readings recorded from a Raspberry Pi Sense HAT, via the Sense HAT emulation library. no cap, that's literally the whole job. 🫶

---

🌸 SYNOPSIS 🌸

sense_play [-h] [--version] [-q] [-v] [-l FILE] [-P] input

that's it, that's the whole vibe check. one input, a lil handful of flags, slay. 💅

---

🦋 DESCRIPTION 🦋

here's every flag she takes, no gatekeeping, fr fr:

• -h, --help — show this help message and exit. your classic "wait what does this do again" button 💖
• --version — show this program's version number and exit. she'll tell you exactly how old she is ✨
• -q, --quiet — produce less console output. for when you want her to stop yapping 🔇
• -v, --verbose — produce more console output. for when you want her to yap more 👑
• -l FILE, --log-file FILE — log messages to the specified file. receipts, but on disk 🎀
• -P, --pdb — run under PDB (debug mode). main character energy for when something's acting up 🐛

---

🌈 EXAMPLES 🌈

wanna play back an experiment you recorded from the Sense HAT? bestie, you literally just hand sense_play the filename and go:

$ sense_play experiment.hat

playback starts immediately and continues in real-time — like, at the recording rate — until the file is exhausted. she does not rush, she does not dawdle. periodt. ⏱️

and if you wanna start an emulated script at the exact same time as playback, you can use the shell's job control facilities, because your shell is also a queen:

$ sense_play experiment.hat & python experiment.py

okay and this part is lowkey genius: if you specify - as the input file, sense_play will read from stdin. which means you can play back compressed recordings (peep the Examples section under sense_rec) without burning any disk space on decompression. obsessed. 😭

$ gunzip -c experiment.hat.gz | sense_play -

NOTE: if playback is going too slowly — like, say the Pi is too busy with other tasks, or the data can't be read quickly enough off the SD card — sense_play will skip records and print a warning to the console at the end of playback with the number of records skipped. she'll always tell you how many she dropped. she keeps it honest. 💀

---

🎀 AUTHOR 🎀

Raspberry Pi Foundation 💜

---

⭐ COPYRIGHT ⭐

2016-2021 Raspberry Pi Foundation

---

and that's the whole page bestie! this was version 1.2, dated Sep 02, 2021, brought to you by sense-emu — go replay something cute, you've got this 🧚💖