Leer en Español. More translations here

Welcome to Pygubu Designer!

Pygubu Designer is a RAD tool to enable quick and easy development of user interfaces for the Python's tkinter module.

The user interfaces designed are saved as XML files, and, by using the pygubu builder, these can be loaded by applications dynamically as needed.

Pygubu Designer is inspired by Glade.

Installation

The latest version of pygubu requires Python >= 3.9

You can install pygubu-designer using pip:

pip install pygubu-designer

For other installation methods, please see this page.

Screenshot

Usage

Pygubu designer supports two types of workflow. The first and classic method is creating an application that uses the "*.ui" file that defines your user interface.

In the classic mode, pygubu is in charge of creating the widgets and connecting defined bindings. I recommend this mode for apps that have one or a few windows, but you can use it for creating apps of any complexity (Pygubu Designer it self was created with this mode, but now uses the new one). This method uses a class based approach where your code lives in the derived class and the base class is updated by pygubu designer.

The second method is to create an app with a coded version of the *.ui file. Using the same class based approach mentioned above, pygubu designer generates the python code for the base class and you write the app logic in the derived class.

Generating the code for the UI has some benefits:

• The *.ui file is not required at runtime
• Allows you to create pure tkinter apps, if you do not use any pygubu widget (eliminating pygubu dependency).
• Easy creation of custom widgets.

Whichever you choose, you can always modify the user interface using pygubu designer.

Starting Pygubu Designer

Type on the terminal one of the following commands depending on your system.

Unix-like systems

pygubu-designer

For other platforms see this page.

Documentation

Visit the wiki for more documentation.

The following are some good tkinter (and tk) references:

• TkDocs
• Graphical User Interfaces with Tk
• Tkinter 8.5 reference: a GUI for Python
• An Introduction to Tkinter (archive)
• Tcl/Tk 9.0 Manual
• Tcl/Tk 8.6 Manual

You can also see the examples directory or watch this introductory video tutorial.

History

See the list of changes here.

License

Pygubu Designer: GPL-3.0 license

Pygubu Designer can generate pure python code scripts. For those cases where a license is required for these scripts, they are licensed under the same license as the pygubu core: MIT License. This applies to all standard plugins that come with pygubu core. If you're using a third-party plugin, check the plugin license.