Getting Started

At the start of every guizero program, choose the widgets you need from the guizero library and import them:

from guizero import App, PushButton, Slider

You only need to import each widget once, and then you can use it in your program as many times as you like.

Hello World

All guizero projects begin with a main window which is called an App. At the end of every guizero program you must tell the program to display the app you have just created.

Let's create an app window with the title "Hello world":

from guizero import App
app = App(title="Hello world")
app.display()

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

Adding widgets

Widgets are the things which appear on the GUI, such as text boxes, buttons, sliders and even plain old pieces of text.

All widgets go between the line of code to create the App and the app.display() line.

from guizero import App, Text
app = App(title="Hello world")
message = Text(app, text="Welcome to the Hello world app!")
app.display()

Hello world

Let’s look at the Text widget code in a bit more detail:

message = Text(app, text="Welcome to the Hello world app!")
  • message = - The Text object has a name, just like any variable
  • Text - an object which creates a piece of text on the screen
  • app – This tells the Text where it will live. Most of the time your widgets will live directly inside the app.
  • text="Welcome to the Hello world app!" - The text to display

And that's it! Now have a look on the documentation pages for the individual widgets to find out more about how to use them.