Thonny + Pgzero Installeren

Snel installeren

Download het script voor jouw besturingssysteem. Eén dubbelklik en het installeert Python, uv, Thonny, pgzero, pygame en alle startercode voor je. Klaar in 5-10 minuten.

Je besturingssysteem wordt gedetecteerd...

Toon alle downloads

Tip

Het script is veilig: het installeert alleen dezelfde programma’s als de handmatige stappen hieronder. Je kunt de broncode bekijken door het bestand te openen in Kladblok of een teksteditor.


Handmatig installeren

Thonny is een gratis Python-editor die speciaal gemaakt is voor beginners. Het installeert Python automatisch mee. Controleer na de installatie wel welke Python-versie je hebt, want pygame en pgzero werken niet met Python 3.14 of hoger.

Thonny installeren

Ga naar thonny.org en download de versie voor jouw besturingssysteem.

Windows

Download het .exe-bestand en dubbelklik erop. Volg de installatiestappen (klik gewoon op “Next”). Daarna vind je Thonny terug in het Startmenu.

macOS

Download het .pkg-bestand en open het. Sleep Thonny naar je Programma’s-map. De eerste keer dat je het opent, klik je met de rechtermuisknop en kies je “Open” (zodat macOS het vertrouwt).

Linux

Open een terminal en typ:

bash <(wget -qO - https://thonny.org/installer-for-linux)

Of gebruik je pakketbeheerder als Thonny beschikbaar is (bijv. sudo apt install thonny op Ubuntu).

Notitie

Gebruik de versie van thonny.org, niet de versie uit de app store. Die is soms verouderd.

Python-versie controleren

Pygame en pgzero hebben wheels nodig (voorgemaakte binaries) en die bestaan nog niet voor Python 3.14. Gebruik Python 3.13 (of 3.12).

  1. Open Thonny.
  2. Kijk rechtsonder in het venster. Daar staat de actieve Python-versie, bijv. Python 3.13.9.
  3. Staat er 3.14 of hoger? Installeer dan Python 3.13 via de stappen hieronder.
Tip

Staat er Python 3.12 of 3.13? Dan is alles goed. Sla de rest van dit onderdeel over en ga door naar Pgzero installeren.

Python 3.13 installeren en Thonny erop laten wijzen

  1. Ga naar python.org/downloads en klik op “All releases”. Zoek Python 3.13 in de lijst en download de installer voor jouw besturingssysteem.
    • Windows: kies de Windows installer (64-bit) en laat het vinkje “Add Python to PATH” aanstaan.
    • macOS: kies de macOS 64-bit universal2 installer.
    • Linux: gebruik je pakketbeheerder, bijv. sudo apt install python3.13.
  2. Doorloop de installatie en sluit hem af.
  3. Open Thonny en klik rechtsonder op de Python-versienaam (of ga naar Tools → Options → Interpreter).
  4. Kies “Alternatieve Python 3-interpreter of virtuele omgeving”.
  5. Klik op het mapicoon en blader naar de Python 3.13-executable:
    • Windows: C:\Users\<jounaam>\AppData\Local\Programs\Python\Python313\python.exe
    • macOS: /Library/Frameworks/Python.framework/Versions/3.13/bin/python3
    • Linux: /usr/bin/python3.13
  6. Klik op OK en herstart Thonny.

Rechtsonder staat nu Python 3.13. Ga door met het installeren van Pgzero.

Pgzero installeren

Pgzero is de bibliotheek waarmee je spelletjes maakt. Zo installeer je het:

  1. Open Thonny.
  2. Klik bovenaan op Tools → Manage packages…
  3. Typ in het zoekvak: pgzero
  4. Klik op het zoekresultaat en daarna op Install.
  5. Wacht tot de installatie klaar is (je ziet “Done” onderaan).

Controleer daarna dat de versie 1.2 of hoger is. Je ziet de versie rechts naast de naam in de pakketlijst.

Pygame installeren

Pgzero heeft Pygame nodig om te werken. Installeer het op dezelfde manier:

  1. Ga weer naar Tools → Manage packages…
  2. Zoek op pygame
  3. Klik op Install.

Pygame wordt automatisch gevonden door Pgzero, je hoeft er verder niets mee te doen.

Test of alles werkt

Maak een nieuw bestand aan in Thonny en plak deze code erin:

# test_setup.py
import pgzrun

WIDTH = 400
HEIGHT = 300

def draw():
    screen.fill((30, 30, 60))
    screen.draw.text("Pgzero werkt!", center=(200, 150), color="white")

pgzrun.go()

Sla het op als test_setup.py en klik op de groene Run-knop in Thonny.

Als alles goed is, opent er een venster met een donkerblauwe achtergrond en de tekst “Pgzero werkt!”. Sluit het venster door het kruisje te klikken.

Werkt het niet?

Geen paniek! Kijk op de probleemoplossingspagina voor de meest voorkomende fouten en hoe je ze oplost.