Textual: Modern Text User Interface Framework

8.2.0 · active · verified Sat Mar 28

Textual is a Python framework for building sophisticated user interfaces with a simple API. The current version is 8.2.0, released on March 27, 2026. It follows a regular release cadence, with updates approximately every few weeks.

Warnings

breaking In version 8.0.0, 'Select.BLANK' was renamed to 'Select.NULL' to avoid a name clash.
Fix: Update code to use 'Select.NULL' instead of 'Select.BLANK'.
deprecated The 'App.PAUSE_GC_ON_SCROLL_' attribute is experimental and may be removed in future versions.
Fix: Avoid using 'App.PAUSE_GC_ON_SCROLL_' in production code.

Install

pip install textual Install Textual

Imports

App
```
from textual.app import App
```
Ensure correct import path to avoid ImportError

Quickstart

A minimal Textual application with a header, footer, and placeholder.

import os
from textual.app import App
from textual.widgets import Header, Footer, Placeholder

class MyApp(App):
    async def on_mount(self) -> None:
        self.set_interval(1, self.update)

    async def update(self) -> None:
        pass

    async def on_resize(self, width: int, height: int) -> None:
        pass

if __name__ == '__main__':
    app = MyApp()
    app.run()

view raw JSON →