ttyrec
![](../I/m/Termrec_wwwwolf.png)
ttyrec is a program and/or its file format capable of recording the TTY output of a text-mode program together with timestamps and then replaying it.
It is widely used for example in the NetHack community for storing game replays.
It is similar to the script command, but also allows for pausing, slowing down or speeding up playback. It can also stream the recording on the network and be used to transfer files with uudecode.[1]
Recorders/players
- original ttyrec [1](Unix)
- Term::TtyRec[2] (Perl)
- Term::TtyRec::Plus[3] (Perl)
- Tie::Handle::TtyRec[4] (Perl)
- termrec [5] (Win32, Unix)
Playback only
Technical file format specification
Each chunk consists of a header using 32bit little-endian numbers:
- sec -- seconds, either since the beginning of the recording (0-based) or since the Unix epoch
- usec -- 0..999999 microseconds
- len -- length of the payload
and the actual payload written as text with vt100 control codes.
The format doesn't contain any information about the character set used nor about the terminal size needed to play back the file. termrec will inject this information as \e%G for UTF-8 or \e%@ for not UTF-8 and as \e[8;Y;Xt for size, but not all players will understand these codes.
Related formats
References
- 1 2 http://0xcc.net/ttyrec/
- ↑ https://metacpan.org/module/Term::TtyRec
- ↑ https://metacpan.org/module/Term::TtyRec::Plus
- ↑ https://metacpan.org/module/Tie::Handle::TtyRec
- ↑ http://angband.pl/termrec.html
- ↑ http://www-masu.ist.osaka-u.ac.jp/~kakugawa/misc/ttyplayer/index-en.shtml
- ↑ http://www.chiark.greenend.org.uk/~sgtatham/ipbt/
- ↑ http://nh-recorder.sourceforge.net/
- ↑ https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=68556
External links
- How To Record And Share Terminal Screencasts Quickly
- Record and share your terminal session with shelr.tv
- How to record NetHack games with ttyrec at the Wayback Machine (archived June 18, 2008)