linkorb/tty

TTY/PTY library

dev-master 2016-03-24 08:02 UTC

This package is auto-updated.

Last update: 2024-03-29 03:13:15 UTC


README

This library contains functionality for working with TTY/PTYs and related formats and protocols.

Included:

  • A ttyrec parser (extracts frames with payload and timing from ttyrec files)
  • A VT100/ANSI Terminal Emulator. Parses escape codes, CSI, OSI etc commands
  • An AsciiRenderer, to render Terminal buffers for replays and debugging
  • Examples in examples/

How to use

composer install
ttyrec tty.log
# execute some commands, like ls, df, etc
exit
php examples/ttyrec-player.php

Notes

When starting this project I had no idea what I was getting in to. VT100 is an insane protocol. I'm keeping notes on things I'm learning along the way in NOTES.md

TODO / Next steps:

  • Extract executed commands from tty sessions (initial goal of this project)
  • Solid test-cases based on pre-recorded tty sessions
  • Support more escape codes for coloring, scrolling and other more advanced use-cases

License

MIT. Please refer to the license file for details.

Brought to you by the LinkORB Engineering team

687474703a2f2f7777772e6c696e6b6f72622e636f6d2f642f6d6574612f74696572312f696d616765732f6c696e6b6f7262656e67696e656572696e672d6c6f676f2e706e67
Check out our other projects at linkorb.com/engineering.

Btw, we're hiring!