Getting Started

After you have installed guizero you are ready to create your GUI with guizero.

This is a quick start guide, for more information see Using Widgets

Hello World

Let's create an app window with the title "Hello world" and display it.

from guizero import App

app = App(title="Hello world")

app.display()

Save and run the code - you've created your first guizero app!

Add some text

To add things to your app you will need to use widgets.

Use the Text widget to add a message to your app.

Hello world app

from guizero import App, Text

app = App(title="Hello world")

message = Text(app, text="Welcome to the Hello world app!")

app.display()

The text parameter of the TextBox sets the text that will be displayed on the GUI.

Make something happen

You can make your app do things by using other widgets which a user can interact with.

Use the PushButton widget to create a button which will change the message when it is clicked.

Hello world app with a button which says 'Press me'

from guizero import App, Text, PushButton

def change_message():
    message.value = "You pressed the button!"

app = App(title="Hello world")

message = Text(app, text="Welcome to the Hello world app!")

button = PushButton(app, text="Press me", command=change_message)

app.display()

The PushButton widget includes a command parameter which is set to the name of a function - change_message.

The change_message function is called each time the button is clicked.

And that's it! Take a look at Using Widgets for more information on how to use guizero.