Metadata-Version: 2.4
Name: PyTermGUI
Version: 7.8.0
Summary: Python TUI framework with mouse support, modular widget system, customizable and rapid terminal markup language and more!
Project-URL: homepage, https://github.com/bczsalba/PyTermGUI
Project-URL: repository, https://github.com/bczsalba/PyTermGUI
Project-URL: documentation, https://ptg.bczsalba.com
Author-email: Balázs Cene <bczsalba@gmail.com>
License: MIT
License-File: LICENSE
Keywords: ANSI,TUI,UI,framework,markup,terminal,user-interface,xterm
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Console
Classifier: Framework :: IPython
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: MacOS
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Topic :: Software Development :: Libraries
Classifier: Topic :: Terminals
Classifier: Topic :: Text Processing :: Markup
Classifier: Typing :: Typed
Requires-Python: >=3.8
Requires-Dist: typing-extensions
Requires-Dist: wcwidth>=0.5
Provides-Extra: docs
Requires-Dist: mkdocs-gen-files; extra == 'docs'
Requires-Dist: mkdocs-literate-nav; extra == 'docs'
Requires-Dist: mkdocs-material; extra == 'docs'
Requires-Dist: mkdocstrings[python]; extra == 'docs'
Requires-Dist: termage; extra == 'docs'
Provides-Extra: yaml
Requires-Dist: pyyaml; extra == 'yaml'
Description-Content-Type: text/markdown

![title](https://github.com/bczsalba/pytermgui/raw/master/assets/readme/screenshot.png)

> Python TUI framework with mouse support, modular widget system, customizable and rapid terminal markup language and more!

```bash
pip3 install pytermgui
```

<p align=center>
   <a href="https://pypi.org/project/pytermgui">
      <img alt="PyPi project" src="https://img.shields.io/pypi/v/pytermgui?color=brightgreen">
   </a>
   <a href="https://ptg.bczsalba.com/">
      <img src="https://img.shields.io/badge/documentation-gray">
   </a>
   <a href="https://github.com/bczsalba/pytermgui/actions/workflows/pytest.yml">
      <img src="https://github.com/bczsalba/pytermgui/actions/workflows/pytest.yml/badge.svg">
   </a>
 </p>
</p>

<hr>

## Archival notice

PyTermGUI is no longer in development. The latest release will remain available, alongside its documentation. The MIT license allows for free modification of the library, as long as you include credit to its original author. Thank you for everything.

<hr>

## Why?

Mostly because terminals are cool, but creating terminal apps has historically been difficult. PyTermGUI aims to provide a simple, readable and modular way to make the app of your dreams!

Terminal apps are (often):

- Easier to install
- Faster & more resource efficient
- Less prone to differences between environments (no IE7 here!)

...than their web or native counterparts.

## How?

We provide a couple of things to make your life easier:

- Sensible abstractions over most terminal standards
- A fully fledged, desktop-inspired window manager system with modals and completely customizable windows
- Mouse support out of the box with **0** configuration
- YAML (or Python) based styling engines
- TIM, our markup language for creating styled terminal text with expressive text, including systems for aliases & macros
- A bunch of things I can't think of right now :slightly_smiling_face:

Additionally, there are a couple of neat tools to make your general Python development easier:

- An inspection utility
- A pretty printer for both the REPL and IPython
- A way to create SVG and HTML screenshots of your terminal

### Terminal compatibility

PyTermGUI relies on ANSI virtual-terminal sequences for rendering, cursor reports,
keyboard input, and mouse input. On Windows, support depends on the terminal emulator's
ANSI compatibility. [Windows Terminal](https://github.com/microsoft/terminal) supports
the expected cursor and mouse protocols, while the legacy Windows Console Host
(`conhost.exe`) may provide reduced functionality. This does not depend on whether
PowerShell or Command Prompt is running inside the emulator. Mouse support also depends
on the emulator forwarding the requested events.

## Latest release

### [7.8.0] - 2026-08-10

### Additions

- Add grapheme-aware wrapping with correct widths for CJK and emoji sequences
- Preserve ANSI styles and hyperlinks when wrapping text
- Document terminal compatibility and the project's archived status

### Bugfixes

- Fix terminal clearing, synchronized frame recording, and resize handling
- Fix multiline input cursor placement and nested container scrolling
- Fix uneven splitter columns and automatically sized scrollable windows
- Fix ANSI bright magenta, cyan, and white color mappings
- Fix cursor-home and erase sequences in ANSI exports
- Avoid busy-waiting for input on Windows

### Maintenance

- Modernize linting and packaging configuration
- Remove obsolete project assets and tooling


Read the full changelog [here](https://github.com/bczsalba/pytermgui/blob/master/CHANGELOG.md).



[7.8.0]: https://github.com/bczsalba/pytermgui/compare/v7.7.4...v7.8.0
[7.7.4]: https://github.com/bczsalba/pytermgui/compare/v7.7.3...v7.7.4
[7.7.3]: https://github.com/bczsalba/pytermgui/compare/v7.7.2...v7.7.3
[7.7.2]: https://github.com/bczsalba/pytermgui/compare/v7.7.1...v7.7.2
[7.7.1]: https://github.com/bczsalba/pytermgui/compare/v7.7.0...v7.7.1
[7.7.0]: https://github.com/bczsalba/pytermgui/compare/v7.6.0...v7.7.0
[7.6.0]: https://github.com/bczsalba/pytermgui/compare/v7.5.0...v7.6.0
[7.5.0]: https://github.com/bczsalba/pytermgui/compare/v7.4.0...v7.5.0
[7.4.0]: https://github.com/bczsalba/pytermgui/compare/v7.3.0...v7.4.0
[7.3.0]: https://github.com/bczsalba/pytermgui/compare/v7.2.0...v7.3.0
[7.2.0]: https://github.com/bczsalba/pytermgui/compare/v7.1.0...v7.2.0
[7.1.0]: https://github.com/bczsalba/pytermgui/compare/v7.0.0...v7.1.0
[7.0.0]: https://github.com/bczsalba/pytermgui/compare/v6.4.0...v7.0.0
[6.4.0]: https://github.com/bczsalba/pytermgui/compare/v6.0.0...v6.4.0
[6.3.0]: https://github.com/bczsalba/pytermgui/compare/v6.2.2...v6.3.0
[6.2.2]: https://github.com/bczsalba/pytermgui/compare/v6.2.1...v6.2.2
[6.2.1]: https://github.com/bczsalba/pytermgui/compare/v6.2.0...v6.2.1
[6.2.0]: https://github.com/bczsalba/pytermgui/compare/v6.1.0...v6.2.0
[6.1.0]: https://github.com/bczsalba/pytermgui/compare/v6.0.0...v6.1.0
[6.0.0]: https://github.com/bczsalba/pytermgui/compare/v5.0.0...v6.0.0
[5.0.0]: https://github.com/bczsalba/pytermgui/compare/v4.3.2...v5.0.0
[4.3.2]: https://github.com/bczsalba/pytermgui/compare/v4.3.1...v4.3.2
[4.3.1]: https://github.com/bczsalba/pytermgui/compare/v4.3.0...v4.3.1
[4.3.0]: https://github.com/bczsalba/pytermgui/compare/v4.2.0...v4.3.0
[4.2.1]: https://github.com/bczsalba/pytermgui/compare/v4.2.0...v4.2.1
[4.2.0]: https://github.com/bczsalba/pytermgui/compare/v4.1.0...v4.2.0
[4.1.0]: https://github.com/bczsalba/pytermgui/compare/v4.0.0...v4.1.0
[4.0.1]: https://github.com/bczsalba/pytermgui/compare/v4.0.0...v4.0.1
[4.0.0]: https://github.com/bczsalba/pytermgui/compare/v3.2.1...v4.0.0
