Skip to main content

widgets for pygame wit ease

Project description

Build Status Pypi Version Pypi Status Python Version

Code Health Pypi Downloads

Pygame GUI

What is it ?

This librairy aims to provide simple widget to improve pygame applications like buttons, text, textboxes or math text widgets. There is also some goemetric shapes, like rectangle or bezier curves.


  • pygame : This library is fully based on pygame, so you must have it installed.

(optionnal) * latex : you must avec latex install if you want to use the LaText widget (latex and dvipng accessible in path)


You can install it with pip and pypi easily by :

pip install -U PygameGUILib

or via git and pip :

pip install -U git+


Actually there is a fex widgets in the library. I’ll try to maintain this list, but I’m sure I’ll forget, so there is MORE than that.

  • Texts :
    • SimpleText
    • LaText
    • InLineInputBox
    • InLinePassBox
  • Buttons :
    • Button
    • IconButton
    • SlideBar

Around that, there is a lot of helping objects, like Font, colors, V2 and Separator (some vector things), FPSIndicator, FocusSelector…



Every widget has a pos, a size and an anchor, the three can be harcoded or a callback function with no parameters. The pos and the size defines a pygame.Rect where the widget is. The posis per default the center of the widget, but you can change this behavior by giving an other anchor, like TOPLEFT.

Tree steps to use a button

Every widget is totally independent and will do nothing unless you tell him to do something. There is no theading thing that continuously check for events both for performance and to give you more control on the widgets.

For instance, widget won’t auto-render on the screen and won’t listen events, like clics on buttons.
Thus, to have a fully operational button there are three steps :

Just define it, nothing complex once you’ve read the bases.

# define the action the button will perform when clicked
def callback():
    print('PRESSED !")

button = Button(callback, (100, 100), (100, 40), "Click Me !")

Then, you must continuously check for events, and call click() when you want. (typically when the user clicks the button)

for e in
    if e.type == pygame.MOUSEBUTTONDOWN and e.button == 1:  # left click
        if pygame.mouse.get_pos() in button:
    # you tell the button to call the callback if clicked

And finally you must render the button on the screen.

button.render(display)  # you draw the button on the display

It’s basically the same thing for any widget, except for “passive” widgets like texts, because we do not bother if the user clicks it. For other widgets, like textboxes, you’ll want to update them with the inputs so you must call .update(event) too.


As always with pygame, do not try to make too big apps with a lot of changing texts or with too big protions of the screen that are too often redrawn or it can lag a bit.

Help and todo list

You’re welcome !

How can you help ?

Do not hesitate to contact me per mail or join the slack chat to discuss aboute code, optimisation or functionnalities. You can of course make any push request you want !
Feel free to report any issue you see as I do not have strong tests (I mean, almost no tests !)

Todos :

  • A Text class to make texts that goes on more lines and with wrapping.
  • A TextBox, to input multi line text
  • A RichText to make text with differents inner colors/size/font/styles
  • Something like lists
  • Switch class : Nice looking ON/OFF button
  • Some geometry function to draw curves, grids and manipulate line, polygons

This is absolutly not an ordered list, they will come as I have nice looking and useable classes !

Cool projects with this library

Do not hesitate to tell me if you have something working !
Here is a list of projets that uses my library, take inspiration !

Examples at the and of each file can also give you a lot of samples of how to use this library :) There is also a folder full of example that you will apreciate !

Project details

Release history Release notifications

History Node


History Node


This version
History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
PygameGUILib-0.4a4.tar.gz (21.1 kB) Copy SHA256 hash SHA256 Source None Jun 19, 2017

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page