[![Supported Python Versions](https://img.shields.io/pypi/pyversions/textual/0.1.18)](https://pypi.org/project/textual/) [![PyPI version](https://badge.fury.io/py/textual.svg)](https://badge.fury.io/py/textual)

# Textual

Textual is a Python framework for creating applications within your terminal.

Textual is a Python framework for creating applications within your terminal—powered by [Rich](https://github.com/Textualize/rich).

Build sophisticated Text User Interfaces (TUIs) with just your Python skills.

## Preview

This is the [code_browser.py](./examples/code_browser.py) example which clocks in at 61 lines, *including* docstrings and blank lines.



https://user-images.githubusercontent.com/554369/189394703-364b5caa-97e0-45db-907d-7b1620d6411f.mov



## Compatibility

Textual runs on Linux, MacOS, and Windows. Rich requires Python 3.7 or above.

## Installing

Install Textual via pip:

```
pip install textual[dev]
```

The addition of `[dev]` installs some additional development tools.

## Features


![calculator screenshot](./imgs/calculator.svg)

![code browser screenshot](./imgs/codebrowser.svg)

![stopwatch light screenshot](./imgs/stopwatch_light.svg)

![stopwatch dark screenshot](./imgs/stopwatch_dark.svg)