PySimpleGUI - The Tkinter Port
The primary port of PySimpleGUI uses tkinter. To use this port, you will pip install PySimpleGUI and import PySimpleGUI.
This port has had the most development effort put into it. It also has the largest group of users among the 4 ports. When new features are added to the tkinter port, they tend to be architected in a way that will work with the other ports.
Some Elements are unique to the tkinter port. These include:
Additionally, a number of the Pseduo-elements have not yet been added to the other ports. Some examples are:
- Custom Titlebar
- Push (in the Qt port, the
Stretchelement can be used instead)
PySimpleGUI is installed via pip.
To install PySimpleGUI you will run:
python -m pip install PySimpleGUI
If you use the command
python3 on your computer to invoke Python, then you'll run
python3 instead of
python3 -m pip install PySimpleGUI
To use PySimpleGUI, you will use this import statement:
There is an implementation of the
SystemTray object and feature set in the tkinter port itself, but it will not display an icon in the system tray itself. Instead an "icon" is placed on the desktop.
The PySimpleGUI project's
psgtray library adds a system tray icon in the system tray. You will need to install this library separately from PySimpleGUI. More information on this pacakge can be found in the System Tray section.
Depending on your Operating System, how you get tkinter onto it will vary. Windows is the easiest and will happen automatically when you install Python. Linux often requires an explicit install of tkinter and Mac varies in how tkinter is supplied.
The one universal constant for all installations is that unlike the other 3 ports of PySimpleGUI, you will not install the underlying GUI framework, tkinter, via pip.