Ttyrec

program together with timestamps and then replaying it.

It is widely used for example in the NetHack community for storing game replays.

Recorders/players

* original "ttyrec" [http://0xcc.net/ttyrec/] (Unix)
* "Term::TtyRec" [http://search.cpan.org/dist/Term-TtyRec/] (Perl)
* "Term::TtyRec::Plus" [http://search.cpan.org/dist/Term-TtyRec-Plus/] (Perl)
* "Tie::Handle::TtyRec" [http://search.cpan.org/dist/Tie-Handle-TtyRec/] (Perl)
* "termrec" [http://angband.pl/termrec.html] (win32, Unix [crippled] )

Playback only

* "TTYPLAYER" [http://www-masu.ist.osaka-u.ac.jp/~kakugawa/misc/ttyplayer/index-en.shtml] (Java)
* "IPBT" [http://www.chiark.greenend.org.uk/~sgtatham/ipbt/] (Unix)

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 payloadand 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 or "e" [@ for Unicodeness and as "e" [8;"Y";"X"t for size, but this is a hack outside of the format specification, not guaranteed to work on all terminals.

Related formats

* "nh-recorder" [http://nh-recorder.sourceforge.net/]
* Joey Hess's modifications of "script"
* "RealLogs"

External links

* [http://timjoh.com/how-to-record-and-play-nethack-games-with-ttyrec-and-ttyplay-live/ How to record NetHack games with ttyrec]