TkEasyGUI - the easiest library for GUI

TkEasyGUI is the easiest library for creating GUIs in Python.

This library allows you to easily create GUI applications with Python. Since it is based on Tkinter, it runs consistently on Windows, macOS, and Linux. With a variety of built-in dialogs and customizable forms, you can develop applications effortlessly.

👉日本語 / 👉中文 / 👉한국어

Platform

Windows / macOS / Linux (Tkinter required)

Install

Install package from PyPI.

# Install package from PyPI
pip install TkEasyGUI
# or
python -m pip install TkEasyGUI

Install package from GitHub Repository.

# Install package from GitHub Repository
python -m pip install git+https://github.com/kujirahand/tkeasygui-python
# or
# Clone the repository and install
git clone https://github.com/kujirahand/tkeasygui-python
cd tkeasygui-python
python -m pip install .

Features of This Library

Python's standard UI library Tkinter, is often considered to have a high barrier to entry and to be difficult to use. By using this library, you can create GUI applications easily and intuitively.
This package supports type hints, allowing property selection via code completion. Python 3.9 or later is required.
In the event model, it is compatible with the well-known GUI library PySimpleGUI.
This project adopts the lenient MIT license. This license will not change in the future. Let's enjoy creating GUI programs.

Using TkEasyGUI is simple. If you only want to display a dialog, it requires just two lines of code.

import TkEasyGUI as eg
# Show Text dialog
eg.print("A joyful heart is good medicine.")

Ask the user for their name and display that name in the window.

import TkEasyGUI as eg
# Show Input dialog
name = eg.input("What is your name?")
eg.print(f"Hello, {name}.")

Furthermore, a dialog is available that allows specifying multiple input fields.

import TkEasyGUI as eg
# Show Form dialog
form = eg.popup_get_form(["Name", "Age", "Hobbies"])
if form:
    name = form["Name"]
    age = form["Age"]
    hobbies = form["Hobbies"]
    eg.print(f"name={name}, age={age}, hobby={hobbies}")

A file selection dialog is also available.

import TkEasyGUI as eg
# Show File dialog
file_path = eg.popup_get_file("Select a file")
eg.print(f"You selected: {file_path}")

More Dialogs

TkEasyGUI provides a variety of dialogs. For example, a color selection dialog, a file selection dialog, and a calendar dialog.

Docs > Dialogs

How to use - widgets

To create a simple window with only labels and buttons, you would write as follows:

import TkEasyGUI as eg
# define layout
layout = [
    [eg.Text("Hello, World!")],
    [eg.Button("OK")]
]
# create a window
with eg.Window("Hello App", layout) as window:
    # event loop
    for event, values in window.event_iter():
        if event == "OK":
            eg.print("Thank you.")
            break

You can describe it using an event model similar to the famous GUI library, PySimpleGUI.

import TkEasyGUI as eg

# define layout
layout = [
    [eg.Text("Hello, World!")],
    [eg.Button("OK")]
]
# create a window
window = eg.Window("Hello App", layout)
# event loop
while True:
    event, values = window.read()
    if event in ["OK", eg.WINDOW_CLOSED]:
        eg.popup("Thank you.")
        break
# close window
window.close()

Docs > What kind of elements can be used?

Samples

We have prepared a selection of samples to demonstrate simple usage. Please check them out.

samples.

Running tests/file_viewer.py allows all samples to be easily launched.

Development and Testing

This project uses Just as a task runner. You can run various development tasks (formatting, linting, testing, etc.) by installing just and running:

just

To run the automated tests located in pytest_tests, install pytest and run:

python -m pip install -U pytest
just test

Documents

Below is a detailed list of classes and methods.

docs

Tutorial

Japanese tutorials:

There are other helpful articles as well.

Compatibility with PySimpleGUI

When using basic functionalities, it is compatible with PySimpleGUI. Programs can be written using the same event-driven model as PySimpleGUI.
The names of basic GUI components are kept the same, but some property names differ.
TkEasyGUI has been completely reimplemented from scratch and is licensed under the MIT License.
However, full compatibility with PySimpleGUI is not intended.

TkEasyGUI features

Using a for loop and window.event_iter() enables straightforward event processing.
Custom popup dialogs, such as a color selection dialog(eg.popup_color), a list dialog(eg.popup_listbox), form dialog(eg.popup_get_form) are available.
The Image class supports not only PNG but also JPEG formats.
Convenient event hooks and features for bulk event registration are provided - docs/custom_events.
Methods such as Copy, Paste, and Cut are added to text boxes (Multiline/Input).
The system's default color scheme is utilized.

Additional Information

How to run on Raspberry Pi?

It works on Raspberry Pi OS as well. Please pay attention to the following points during installation:

Use Python 3.9 or higher.
Pillow (not PIL) is required. Please run the following command:
- pip install --upgrade --force-reinstall pillow
- If this does not work, uninstall the old system version of Pillow and reinstall it:
  - sudo apt remove python3-pil
  - pip install pillow
Tkinter is pre-installed on Raspberry Pi, but the python3-tk package is required. Please run the following command:
- sudo apt-get install python3-tk

Link

Metadata

Release files for TkEasyGUI 1.0.45

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

Source distribution (sdist)

Source distribution for TkEasyGUI 1.0.45
File	Size	Uploaded
tkeasygui-1.0.45.tar.gz	68.8 kB	Jul 17, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for TkEasyGUI 1.0.45
File	Interpreter	ABI	Platform	Reset
tkeasygui-1.0.45-py3-none-any.whl 66.6 kB Jul 17, 2026	Python 3	none	any	Details

Total release size: 135.4 kB

Release files / tkeasygui-1.0.45.tar.gz

Download URL	tkeasygui-1.0.45.tar.gz
Size	68.8 kB
Tags	Source
SHA-256 checksum How to use checksums	`aa959d2ef11477e48ee62116dca47328151452bece2355cfa84819456f68be72`
BLAKE2b-256 checksum How to use checksums	`d62e5eef0001187a69b661b0e0faf7aaf02d32046447ac1468e2f3e6d292499e`
Upload date	Jul 17, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.2.0 CPython/3.13.9`

Release files / tkeasygui-1.0.45-py3-none-any.whl

Download URL	tkeasygui-1.0.45-py3-none-any.whl
Size	66.6 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`26cfbcdd8be181f6474c128dc121a9b8a2ed7413df9da85dd2c8aa7b41f5b592`
BLAKE2b-256 checksum How to use checksums	`94063fde1f51821bb3917878accbecb371c062b1e52d15da474606c6bad19709`
Upload date	Jul 17, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.2.0 CPython/3.13.9`