Skip to main content

Modern Text User Interface framework

Project description

Textual splash image



Textual is a Rapid Application Development framework for Python.

Build sophisticated user interfaces with a simple Python API. Run your apps in the terminal and a web browser!

🎬 Demonstration

A quick run through of some Textual features.


Textual adds interactivity to Rich with an API inspired by modern web development.

On modern terminal software (installed by default on most systems), Textual apps can use 16.7 million colors with mouse support and smooth flicker-free animation. A powerful layout engine and re-usable components makes it possible to build apps that rival the desktop and web experience.


Textual runs on Linux, macOS, and Windows. Textual requires Python 3.8 or above.


Install Textual via pip:

pip install textual

If you plan on developing Textual apps, you should also install the development tools with the following command:

pip install textual-dev

See the docs if you need help getting started.


Run the following command to see a little of what Textual can do:

python -m textual

Textual demo


Head over to the Textual documentation to start building!

Join us on Discord

Join the Textual developers and community on our Discord Server.


The Textual repository comes with a number of examples you can experiment with or use as a template for your own projects.

🎬 Code browser

This is the example which clocks in at 61 lines (including docstrings and blank lines).

📷 Calculator

This is which demonstrates Textual grid layouts.

calculator screenshot

🎬 Stopwatch

This is the Stopwatch example from the tutorial.

Reference commands

The textual command has a few sub-commands to preview Textual styles.

🎬 Easing reference

This is the easing reference which demonstrates the easing parameter on animation, with both movement and opacity. You can run it with the following command:

textual easing

🎬 Borders reference

This is the borders reference which demonstrates some of the borders styles in Textual. You can run it with the following command:

textual borders

🎬 Colors reference

This is a reference for Textual's color design system.

textual colors

Project details

Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

textual-0.61.0.tar.gz (1.3 MB view hashes)

Uploaded Source

Built Distribution

textual-0.61.0-py3-none-any.whl (552.2 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page