ttyrec is a program or its

file format A file format is a standard way that information is encoded for storage in a computer file. It specifies how bits are used to encode information in a digital storage medium. File formats may be either proprietary or free. Some file formats ...

capable of recording the

TTY TTY may refer to: Communications and technology * Teleprinter or teletypewriter (TTY), an electromechanical typewriter paired with a communication channel ** Sometimes used more generally for any type of computer terminal ** Sometimes used for a v ...

output of a text-mode program together with timestamps and then replaying it. It is widely used for example in the ''

NetHack ''NetHack'' is an open source single-player roguelike video game, first released in 1987 and maintained by the NetHack DevTeam. The game is a fork of the 1982 game ''Hack'', itself inspired by the 1980 game '' Rogue''. The player takes the role a ...

'' 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.

Recorders and players

* original ''ttyrec'' (Unix) * ''Term::TtyRec'' (Perl) * ''Term::TtyRec::Plus'' (Perl) * ''Tie::Handle::TtyRec'' (Perl) * ''termrec'' (Win32, Unix)

Playback only

* ''TTYPLAYER'' (Java) * ''IPBT'' (Unix)

Technical file format specification

Each chunk consists of a header using 32bit unsigned 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 In computing and telecommunication, a control character or non-printing character (NPC) is a code point (a number) in a character set, that does not represent a written symbol. They are used as in-band signaling to cause effects other than the ...

. The format does not 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'' for UTF-8 or ''\e'' for not UTF-8 and as ''\e'Y'X'' for size, but not all players will understand these codes.

Related formats

* ''nh-recorder'' *

Joey Hess Joey may refer to: People *Joey (name) Animals * Joey (marsupial), an infant marsupial * Joey, a Blue-fronted Amazon parrot who was one of the Blue Peter pets Film and television * ''Joey'' (1977 film), an American film directed by Horace ...

's modifications of ''script'' * ''RealLogs''

References

External links

How To Record And Share Terminal Screencasts Quickly

Record and share your terminal session with shelr.tv
* {{webarchive , url=https://web.archive.org/web/20080618024933/http://timjoh.com/how-to-record-and-play-nethack-games-with-ttyrec-and-ttyplay-live/ , date=June 18, 2008 , title=How to record NetHack games with ttyrec User interfaces Computer file formats Unix software