Skip to main content
Pre-release

This release is a pre-release and may not be stable for production use.

Serial Linux Windows OSX HTML5

pypi_version Static Badge Static Badge

Python Test Status pyTermTk_version pypi_version Usage

pyTermTk_snyk advisor pyTermTk_piptrends age pyTermTk_piptrends downloads pyTermTk_piptrends downloads

hero

pyTermTk

(python Terminal Toolkit) is a Text-based user interface library (TUI) Evolved from the discontinued project pyCuT and inspired by a mix of Qt5,GTK, and tkinter api definition with a touch of personal interpretation

https://github.com/user-attachments/assets/888e745a-ea00-4d03-b6ec-273319d54ea7

Features


Try the Sandbox straight from your browser

SandBox

Powered by Pyodide and xterm.js and CodeMirror5 and w2ui


the Tutorials and the Examples

Be inspired by the Tutorials and the Examples

Api Definitions

Don't get bored by the Api Definitions

ttkode

Burn your fingers with the Terminal Studio Kode

ttkDesigner

Smell deliciousness with the official pyTermTk tool for designing and building Text-based user interfaces (TUIs)

theDumbPaintTool

Unravel your inner artist with The Terminal ASCII Photoshop


Install/Upgrade

pyTermTk is available on PyPI

pip3 install --upgrade pyTermTk

Install from the dev branch:

pip install --upgrade git+https://github.com/ceccopierangiolieugenio/pyTermTk.git#subdirectory=libs/pyTermTk

Quick Test/Try - no install required

Clone

git clone https://github.com/ceccopierangiolieugenio/pyTermTk.git
cd pyTermTk

Demos

# Press CTRL-C to exit (CTRL-Break on Windows)

# Showcase Demo
python3 demo/demo.py -f -t

# run the ttkDesigner
run.ttkDesigner.sh

# run The Dumb Paint Tool
# it require pillow
#   pip install pillow
run.dumbPaintTool.sh

# Text edit with "Pygments" highlight integrated
# it require pygments
#   pip install pygments
python3 tests/test.ui.018.TextEdit.Pygments.py README.md

Projects using pyTermTk

  • ttkDesigner - the official pyTermTk tool for designing and building Text-based user interfaces (TUIs)
  • the DumbPaintTool - The Terminal ASCII Photoshop
  • tlogg - A fast, advanced log explorer.
  • ttkode - TerminalToolKit (Studio) Code (editor)
  • pytest-fold - A Pytest plugin to make console output more manageable when there are multiple failed tests
  • pytest-tui - A Text User Interface (TUI) for Pytest, automatically launched after your test run is finished
  • breakoutRL - Breakout the Roguelike
  • 7drl-2024 - A Snake🐍 on a Plane✈️ - The Roguelike

Related Projects

  • Honourable mention

    • bpytop - Linux/OSX/FreeBSD resource monitor
      This was the base inspiration for my core library
  • Python

    • urwid - Console user interface library for Python
    • pyTermGUI - A simple yet powerful TUI framework for your Python (3.7+) applications
    • Textual - TUI (Text User Interface) framework for Python inspired by modern web development
    • Rich - Python library for rich text and beautiful formatting in the terminal
    • PyCuT - terminal graphic library loosely based on QT api (my previous failed attempt)
    • pyTooling.TerminalUI - A set of helpers to implement a text user interface (TUI) in a terminal.
  • Non Python

Release files for pyTermTk 0.50.0a0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for pyTermTk 0.50.0a0
File Size Uploaded
pytermtk-0.50.0a0.tar.gz 375.5 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for pyTermTk 0.50.0a0
File Interpreter ABI Platform
pytermtk-0.50.0a0-py3-none-any.whl Python 3 none any Details

Total release size: 943.3 kB

Release files / pytermtk-0.50.0a0.tar.gz

Download URL pytermtk-0.50.0a0.tar.gz
Size 375.5 kB
Tags Source
SHA-256 checksum
How to use checksums
4603340f6f3fa5025b17353d41c152e223afd97af3d343b8b73c81c390caee2f
BLAKE2b-256 checksum
How to use checksums
cbec3fd7c78c2d049192b7aa829853c64e7dabdc175ffa4d0b2023e71e7f65bc
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.14.3

Release files / pytermtk-0.50.0a0-py3-none-any.whl

Download URL pytermtk-0.50.0a0-py3-none-any.whl
Size 567.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
0ef1ec3ff7b21fef90f9e0d11029008f7fe6849b4dc4d3bead6c98f9868bb729
BLAKE2b-256 checksum
How to use checksums
bb2e0b59f77af16bcbd50bc8a46284a038e151284573445a0f861a7e50b58965
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.14.3

Release history Release notifications | RSS feed

This release

0.50.0a0 This release

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page