Skip to content

penguintutor/guizero

 
 

Repository files navigation

guizero

Version 0.4 (19th December 2017)

guizero is designed to allow children to quickly and easily create GUIs for their programs.

If you can download and unzip a file, you can use guizero - no special permissions or administrator rights are required.

guizero only requires tkinter to be installed, which is included with a standard Python installation on all platforms except Linux.

Easy installation - all platforms

Use this installation method if you do not have access to a terminal or command prompt on your computer.

  1. Click the green "Clone or download" button and then "Download ZIP"

    Download the zip

  2. Unzip the file

  3. Open the guizero-master folder, then copy the guizero folder and paste it into your home directory

    Copy the guizero folder

  4. That's it! When you write your guizero code, make sure you save it into your home directory.

Other installation methods

If you have administrator rights to your computer and are connected to the internet, you can use pip to quickly install guizero.

Windows

  1. Make sure you have pip installed - follow this guide if you are not sure.
  2. Open a command prompt
  3. Type pip install guizero and press Enter

Raspberry Pi

  1. Open a terminal window
  2. Type sudo pip3 install guizero and press Enter

On Mac

  1. Open a terminal (you can search for it in the Launch Pad)

    Mac terminal

  2. Type sudo pip3 install guizero

    Mac install screenshot

On Linux

  1. Open a terminal
  2. Install tkinter using your distribution's package manager, e.g. sudo apt install python3-tk
  3. Install guizero using pip by typing sudo pip3 install guizero

Upgrading

  • Raspberry Pi/Linux/Mac - sudo pip3 install -U guizero
  • Windows - pip install guizero --upgrade

Mission statement

The aim of guizero is to make the process of creating simple GUIs quick, accessible and understandable for children.

Aims

  • Works with standard Python GUI library (and no need to install other libraries)
  • Abstracts away details children find hard (such as Tkinter StringVar() objects)
  • Accessible widget naming system to help children to build up a mental model
  • Flexible enough to be used for projects up to A-Level standard, yet accessible to primary school children
  • Comprehensive and accessible documentation with examples
  • Helpful error messages

Documentation

http://lawsie.github.io/guizero

Contributing

Contributions are welcome - please create a pull request for each fix/addition. The documentation for the latest release is in /docs as HTML files. Please edit the .md files inside /docs-src/docs folder to add documentation for a new feature.

About

A wrapper for tkinter to simplify part of the functionality so that kids can use it

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Python 96.4%
  • Makefile 2.2%
  • Shell 1.4%