TTYPLAY(1)

✨ NAME ✨

ttyplay — bestie, it's the player for tty sessions that got recorded by ttyrec 💖 (this page lives in the General Commands Manual, section 1, just so you know where you are 🎀)

---

🌸 SYNOPSIS 🌸

ttyplay [-s SPEED] [-n] [-p] file

---

🦋 DESCRIPTION 🦋

ttyplay plays the tty session sitting inside file, and that file is one that got recorded earlier by ttyrec(1). Like, it's the rewind button on somebody's whole terminal existence 👑

When the -p option is in the mix, ttyplay outputs the file as it grows. Which means — and this is the iconic part — you can literally watch the "live" shell session that another user is running right now. Main character energy, but it's their shell 🫶

Now here's the fun bit: if you hit any key during playback, it jumps right to the next character that got typed. Genuinely so handy when you're examining a session where the user just... sat at a prompt for a million years 😭

And on top of that, there are some special keys defined, and they are lowkey the best part:

• + or f — double the speed of playback. zoom zoom 🚀
• - or s — halve the speed of playback. slow it down, we're savouring 🍓
• 0 — set playback speed to 0, pausing playback. full freeze, nobody move 💀
• 1 — set playback to speed 1.0 again. back to normal, we're so back 🌈
• q — quit. bye bestie 💅

---

💅 OPTIONS 💅

• -s SPEED — multiply the playing speed by SPEED (default is 1). yes, the default is literally just 1, no cap ⭐
• -n — no wait mode. Ignore the timing information in file. it's giving "I don't have time for your pauses" 🙈
• -p — peek another person's tty session. respectfully 👀

---

🎀 SEE ALSO 🎀

script(1), ttyrec(1), ttytime(1)

---

quick vibe check: -p is you watching someone else's live shell, and -n throws the timing data straight in the bin. both are choices and both are iconic in their own way ✨

and that's the whole page, fr fr — brought to you by the General Commands Manual, filed under TTYPLAY(1) 💜 go record something with ttyrec and play it back, you deserve it 🧚