Skip to main content

textual-tty

A terminal emulator for Textual apps, using bittty, my pure Python terminal emulator.

Terminals in your terminal: draggable, resizable windows running real ptys.

Demo

uvx textual-tty

Usage

from textual_tty import Terminal, TerminalWindow, Window

# A terminal as a plain widget: composes a bittty Board, never subclasses it.
yield Terminal(command="htop")

# Or in a draggable, resizable window that closes when the process exits.
yield TerminalWindow(command=["vim", "README.md"])

Terminal speaks the whole seam: bracketed paste, OSC palette/title/cwd/ clipboard/notifications, DECSCUSR cursor shapes, synchronized output, mouse reporting with drag-selection when the child isn't tracking, OSC 8 links (ctrl+click opens), and XTWINOPS — a child can move, raise, and resize its own window. Discrete events arrive as Textual messages; anything deeper is on terminal.board (the bittty emulator). Window is a bare-bones draggable/resizable window you can use for other things too.

Read the demo code (textual_tty/demo.py) for a working app.

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.

Metadata

Release files for textual-tty 0.4.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for textual-tty 0.4.0
File Size Uploaded
textual_tty-0.4.0.tar.gz 14.5 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for textual-tty 0.4.0
File Interpreter ABI Platform
textual_tty-0.4.0-py3-none-any.whl Python 3 none any Details

Total release size: 32.4 kB

Release files / textual_tty-0.4.0.tar.gz

Download URL textual_tty-0.4.0.tar.gz
Size 14.5 kB
Tags Source
SHA-256 checksum
How to use checksums
4ec0922bc01a1452c5d9036c0713305587a8a2f52f3b38582ed2d78ab9278804
BLAKE2b-256 checksum
How to use checksums
fd7f3f0685a8f1d5502a79b8e964959397a233ce7909cae89fe314216e5f6c76
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.10.20

Release files / textual_tty-0.4.0-py3-none-any.whl

Download URL textual_tty-0.4.0-py3-none-any.whl
Size 17.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
4dba7766c97a5df5a73689b781e80eacd1048ca905948089c8f6e2e82c1f0275
BLAKE2b-256 checksum
How to use checksums
5048312a3f6190730ecb4fa341a4e4219ffe1552bb9007637c4db980afc05242
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.10.20

Release history Release notifications | RSS feed

This release

0.4.0 This release

2 release files

0.3.1

2 release files

0.3.0

2 release files

0.2.4

2 release files

0.2.3

2 release files

0.2.2

2 release files

0.2.1

2 release files

0.2.0

2 release files

0.1.3

2 release files

0.1.2

2 release files

0.1.1

2 release files

0.1.0

2 release files

0.0.8

2 release files

0.0.7

2 release files

0.0.6

2 release files

0.0.5

2 release files

0.0.4

2 release files

0.0.3

2 release files

0.0.2

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page