# textual

> Modern Text User Interface framework

- **URL**: https://www.freshcrate.ai/projects/textual
- **Author**: Will McGugan
- **Category**: Frameworks
- **Latest version**: `v8.2.7` (2026-05-19)
- **License**: MIT
- **Source**: https://github.com/Textualize/textual/issues
- **Homepage**: https://pypi.org/project/textual/
- **Language**: Python
- **GitHub**: 35,518 stars, 1,179 forks
- **Registry**: pypi (`textual`)
- **Tags**: `pypi`

## Description

[![Discord](https://img.shields.io/discord/1026214085173461072)](https://discord.gg/Enf6Z3qhVr)
[![Supported Python Versions](https://img.shields.io/pypi/pyversions/textual)](https://pypi.org/project/textual/)
[![PyPI version](https://badge.fury.io/py/textual.svg?)](https://badge.fury.io/py/textual)
![OS support](https://img.shields.io/badge/OS-macOS%20Linux%20Windows-red)



![textual-splash](https://github.com/user-attachments/assets/4caeb77e-48c0-4cf7-b14d-c53ded855ffd)

# Textual

<img align="right" width="250" alt="clock" src="https://github.com/user-attachments/assets/63e839c3-5b8e-478d-b78e-cf7647eb85e8" />

Build cross-platform user interfaces with a simple Python API. Run your apps in the terminal *or* a web browser.

Textual's API combines modern Python with the best of developments from the web world, for a lean app development experience.
De-coupled components and an advanced [testing](https://textual.textualize.io/guide/testing/) framework ensure you can maintain your app for the long-term.

Want some more examples? See the [examples](https://github.com/Textualize/textual/tree/main/examples) directory.

```python
"""
An App to show the current time.
"""

from datetime import datetime

from textual.app import App, ComposeResult
from textual.widgets import Digits


class ClockApp(App):
    CSS = """
    Screen { align: center middle; }
    Digits { width: auto; }
    """

    def compose(self) -> ComposeResult:
        yield Digits("")

    def on_ready(self) -> None:
        self.update_clock()
        self.set_interval(1, self.update_clock)

    def update_clock(self) -> None:
        clock = datetime.now().time()
        self.query_one(Digits).update(f"{clock:%T}")


if __name__ == "__main__":
    app = ClockApp()
    app.run()
```

> [!TIP]
> Textual is an asynchronous framework under the hood. Which means you can integrate your apps with async libraries &mdash; if you want to.
> If you don't want or need to use async, Textual won't force it on you. 



<img src="https://img.spacergif.org/spacer.gif" width="1" height="64"/>

## Widgets

Textual's library of [widgets](https://textual.textualize.io/widget_gallery/) covers everything from buttons, tree controls, data tables, inputs, text areas, and more…
Combined with a flexible [layout](https://textual.textualize.io/how-to/design-a-layout/) system, you can realize any User Interface you need.

Predefined themes ensure your apps will look good out of the box. 


<table>

<tr>

  <td>
    
  ![buttons](https://github.com/user-attachments/assets/2ac26387-aaa3-41ed-bc00-7d488600343c)
    
  </td>

  <td>
    
![tree](https://github.com/user-attachments/assets/61ccd6e9-97ea-4918-8eda-3ee0f0d3770e)
    
  </td>
  
</tr>


<tr>

  <td>
    
  ![datatables](https://github.com/user-attachments/assets/3e1f9f7a-f965-4901-a114-3c188bd17695)
    
  </td>

  <td>
    
![inputs](https://github.com/user-attachments/assets/b02aa203-7c37-42da-a1bb-2cb244b7d0d3)
    
  </td>
  
</tr>
<tr>

<td>

![listview](https://github.com/user-attachments/assets/963603bc-aa07-4688-bd24-379962ece871)

</td>

<td>

![textarea](https://github.com/user-attachments/assets/cd4ba787-5519-40e2-8d86-8224e1b7e506)
  
</td>

  
</tr>

</table>


<img src="https://img.spacergif.org/spacer.gif" width="1" height="32"/>

## Installing

Install Textual via pip:

```
pip install textual textual-dev
```

See [getting started](https://textual.textualize.io/getting_started/) for details.


<img src="https://img.spacergif.org/spacer.gif" width="1" height="32"/>

## Demo


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

```
python -m textual
```

Or try the [textual demo](https://github.com/textualize/textual-demo) *without* installing (requires [uv](https://docs.astral.sh/uv/)):

```bash
uvx --python 3.12 textual-demo
```

<img src="https://img.spacergif.org/spacer.gif" width="1" height="32"/>

## Dev Console

<img align="right" width="40%" alt="devtools" src="https://github.com/user-attachments/assets/12c60d65-e342-4b2f-9372-bae0459a7552" />


How do you debug an app in the terminal that is also running in the terminal?

The `textual-dev` package supplies a dev console that connects to your application from another terminal.
In addition to system messages and events, your logged messages and print statements will appear in the dev console.

See [the guide](https://textual.textualize.io/guide/devtools/) for other helpful tools provided by the `textual-dev` package.

<img src="https://img.spacergif.org/spacer.gif" width="1" height="32"/>

## Command Palette


Textual apps have a *fuzzy search* command palette.
Hit `ctrl+p` to open the command palette.

It is easy to extend the command palette with [custom commands](https://textual.textualize.io/guide/command_palette/) for your application.


![Command Palette](https://github.com/user-attachments/assets/94d8ec5d-b668-4033-a5cb-bf820e1b8d60)

<img src="https://img.spacergif.org/spacer.gif" width="1" height="32"/>

# Textual ❤️ W

## Recent releases

| Version | Date | Urgency | Changes |
| --- | --- | --- | --- |
| `v8.2.7` | 2026-05-19 | High | This release adds additional support for the Kitty key protocol. Which enables some additional keys on some terminals. Additionally, Textual will report modifier keys as separate key events.   Additionally there are a few more shortcuts to the Text Area.  This release sponsored by Mistral AI. See release notes for detail.  ## [8.2.7] - 2026-05-19   ### Added  - Added support for Kitty key protocol "Report all keys as escape codes" which enabled alt+backspace on Warp https://github.com/ |
| `v8.2.6` | 2026-05-13 | High | Improved text select logic. You can select text without first clicking on a content area.  May break snapshots without affecting appearance.  ## [8.2.6] - 2026-04-13  ### Fixed  - Fixed selection to the right of code fence blocks (may break some snapshots) - Fixed Markdown code fences losing content when switching themes https://github.com/Textualize/textual/pull/6537  ### Added  - Added ability to select outside of text, so the user doesn't need to be quite so precise https://githu |
| `v8.2.5` | 2026-04-30 | High | This release adds support for dedicated ansi themes, which are also exposed from the command palette.  There were a few tweaks to the theming system which may result in broken snapshots, but there should be no visual changes.   <img width="1512" height="982" alt="Screenshot 2026-04-26 at 21 39 16" src="https://github.com/user-attachments/assets/c6664c38-9898-4886-929d-8d091323fa82" />   ## [8.2.5] - 2026-04-30  ### Added  - Two new themes: "ansi-dark" and "ansi-light" https://github. |
| `8.2.4` | 2026-04-21 | Low | Imported from PyPI (8.2.4) |
| `v8.2.4` | 2026-04-19 | High | Small potatoes update, to fix a glitch with anchor.  ## [8.2.4] - 2026-04-19  ### Added  - Added `DOM.update_classes` https://github.com/Textualize/textual/pull/6478  ### Fixed  - Fixed anchor released when scrolling down with the trackpad https://github.com/Textualize/textual/pull/6503 |
| `v8.2.4` | 2026-04-19 | High | Small potatoes update, to fix a glitch with anchor.  ## [8.2.4] - 2026-04-19  ### Added  - Added `DOM.update_classes` https://github.com/Textualize/textual/pull/6478  ### Fixed  - Fixed anchor released when scrolling down with the trackpad https://github.com/Textualize/textual/pull/6503 |
| `v8.2.4` | 2026-04-19 | High | Small potatoes update, to fix a glitch with anchor.  ## [8.2.4] - 2026-04-19  ### Added  - Added `DOM.update_classes` https://github.com/Textualize/textual/pull/6478  ### Fixed  - Fixed anchor released when scrolling down with the trackpad https://github.com/Textualize/textual/pull/6503 |
| `v8.2.4` | 2026-04-19 | High | Small potatoes update, to fix a glitch with anchor.  ## [8.2.4] - 2026-04-19  ### Added  - Added `DOM.update_classes` https://github.com/Textualize/textual/pull/6478  ### Fixed  - Fixed anchor released when scrolling down with the trackpad https://github.com/Textualize/textual/pull/6503 |
| `v8.2.4` | 2026-04-19 | Medium | Small potatoes update, to fix a glitch with anchor.  ## [8.2.4] - 2026-04-19  ### Added  - Added `DOM.update_classes` https://github.com/Textualize/textual/pull/6478  ### Fixed  - Fixed anchor released when scrolling down with the trackpad https://github.com/Textualize/textual/pull/6503 |
| `v8.2.4` | 2026-04-19 | Medium | Small potatoes update, to fix a glitch with anchor.  ## [8.2.4] - 2026-04-19  ### Added  - Added `DOM.update_classes` https://github.com/Textualize/textual/pull/6478  ### Fixed  - Fixed anchor released when scrolling down with the trackpad https://github.com/Textualize/textual/pull/6503 |

## Citation

- HTML: https://www.freshcrate.ai/projects/textual
- Markdown: https://www.freshcrate.ai/projects/textual.md
- Dependencies JSON: https://www.freshcrate.ai/api/projects/textual/deps

_Generated by freshcrate.ai. Indexes pypi releases for AI-agent ecosystem packages._