/pyTermTk

Python Terminal Toolkit - a Spiced Up Cross Compatible TUI Library 🌶️

Primary LanguagePythonMIT LicenseMIT

Linux Usage Python pyTermTk_version Test Status pypi_version pypi_version

screenshot

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

video-capture-2024-11-12_18.08.48.mini.02.mp4

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

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

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