bittty

A pure Python terminal emulator.

Currently buggy and a bit slow, but it’s still somewhat usable.

Demo

Run the standalone demo:

python ./demo/terminal.py

Or use the textual demo to see it in a TUI:

uvx textual-tty

Links

• 🏠 home
• 📖 pydoc
• 🐍 pypi
• 🐱 github

License

WTFPL with one additional clause

1. Don’t blame me

Do wtf you want, but don’t blame me when it rips a hole in your trousers.

Recent changes

• DEC Special Graphics
• Faster colour/style parser
• Split out from textual-tty into separate package

bugs / todo

• gui
  • make a terminal input class, for standalone input
  • make framebuffer.py
  • choose a backend
• performance improvements
  • parse with regex over large buffer sizes
  • line cache for outputs
• scrollback buffer
  • implement logloglog for scrollback with wrapping
• bugs
  • corruption in stream - debug it
  • scroll region: scroll up in vim corrupts outside scroll region
• add terminal visuals
  • bell flash effect
• Support themes

Unhandled modes

• DECRLM (Right-to-Left-Language Mode): Enables right-to-left language support.