1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
|
# Installation
guizero is designed to allow new learners to quickly and easily create GUIs for their programs.
If you can download and unzip a file, you can [install guizero](#easy-install) - **no special permissions or administrator rights are required**.
If you have administrator rights and are connected to the internet, you can [use the command line to install or upgrade guizero](#install-using-command-line) (recommended).
## Easy install
1. Go to the [guizero repository](https://github.com/lawsie/guizero) on GitHub.
2. Click the green "Code" button and then "Download ZIP"
3. Open the zip file
4. Open the `guizero-master` folder, then copy the `guizero` folder and paste it into your home directory
+ Windows
+ macOS
5. That's it! When you write your guizero code, make sure you save it into your home directory.
## Install using command line
You can use the command prompt to install guizero for:
+ [Windows](#windows)
+ [macOS](#macos)
+ [Raspberry Pi](#raspberry-pi)
+ [Linux](#linux)
`pip` can also be used to [install additional features](#additional-features-install) and [upgrade guizero](#upgrading).
### Windows
1. Open a command prompt by clicking **Start** > **Windows System** > **Command Prompt**, or by typing 'command' into the start menu's search bar.
2. Type this command to use `pip` to install guizero and press enter:
```
pip3 install guizero
```
If you experience problems, have a look at this guide to [_Using pip on Windows_](https://projects.raspberrypi.org/en/projects/using-pip-on-windows).
### macOS
1. Open a terminal window by clicking **Applications** > **Utilities** > **Terminal**, or by typing 'terminal' into the desktop's search bar.
2. Type this command to use `pip` to install guizero and press enter:
```
pip3 install guizero
```
### Raspberry Pi
1. Open a terminal window by clicking **Menu** > **Accessories** > **Terminal**.
2. Type this command to use `apt` to install guizero and press enter:
```
sudo apt-get install python3-guizero
```
**Note:** The installation available via apt may not be the latest. You can always install the latest version using `pip`.
### 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 `pip3 install guizero` or `sudo pip3 install guizero` if you don't have superuser rights
**Note:** If you are using Debian, you alternatively have the option to install guizero via apt
`sudo apt-get install python3-guizero`
### Install additional features
To use the additional [image features](images.md) of guizero such as:
- JPG image support
- scaling images
- animated gifs
... you will need to install [PIL/pillow (python imaging library)](https://pypi.org/project/Pillow/).
You can install pillow using `pip`:
```
pip3 install guizero[images]
```
Or using `apt` on Raspberry Pi / Linux
```
sudo apt-get install python3-pillow
```
The additional image features are not available to install using the easy install method.
### Upgrading guizero
Depending how you installed guizero will dictate how you should upgrade
Using `pip`:
```
pip3 install guizero --upgrade
```
Using `apt`
```
sudo apt-get install python3-guizero
```
If you installed guizero using the easy install method, to upgrade you should follow the same easy installation steps to download the latest version of guizero, then delete the old guizero folder and replace it with the newest version.
|
