[Leer en español] (LEEME.md)

Welcome to pygubu a GUI designer for tkinter

Pygubu is a RAD tool to enable quick & easy development of user interfaces for the python tkinter module.

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

Installation

Pygubu requires python >= 2.7 (Tested only in python 2.7.3 and 3.2.3 with tk8.5)

Using zip tarball:

Download and extract the tarball. Open a console in the extraction path and execute:

python setup.py install

Using pip:

pip install pygubu

Usage

Create an UI definition using pygubu-designer and save it to a file.

[helloworld.ui] (examples/helloworld.ui)

Then, create your aplication script as shown below:

#test.py
import tkinter as tk
import pygubu


class Application:
    def __init__(self, master):

        #1: Create a builder
        self.builder = builder = pygubu.Builder()

        #2: Load an ui file
        builder.add_from_file('helloworld.ui')

        #3: Create the widget using a master as parent
        self.mainwindow = builder.get_object('mainwindow', master)


if __name__ == '__main__':
    root = tk.Tk()
    app = Application(root)
    root.mainloop()

Documentation

Visit the pygubu wiki for more documentation.

An excellent tkinter reference is available here.

See the examples directory or watch this hello world example on video

History

Changes for version 0.9.5

• Renamed designer startup script to pygubu-designer (see #20)
• Fixed bugs.

Changes for version 0.9.4

• Added Toplevel widget
• Added generic Dialog widget
• Rewrited scrolledframe widget internals, ideas and code taken from tkinter wiki.
• Added more widget icons.
• Fixed bugs.

Changes for version 0.9.3

• Allow to select control variable type
• Fixed some bugs.

Changes for version 0.9.2

• Added more wiki pages.
• Fixed issues #3, #4

Changes for version 0.9.1

• Separate designer module from main package
• Added menu to select current ttk theme
• Fix color selector issues.

Changes for version 0.9

• Add validator for pax and pady properties.
• Improved ScrolledFrame widget.
• Added more wiget icons.
• Fix cursor type on preview panel.

Changes for version 0.8

• Added translation support
• Translated pygubu designer to Spanish

Changes for version 0.7

• Added python 2.7 support
• Added initial TkApplication class
• Fixed some bugs.

First public version 0.6