Thonny + Pgzero Installeren

Snel installeren

Download het script voor jouw besturingssysteem. Eén dubbelklik en het installeert Python, uv, Thonny, pgzero, pygame-ce 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 welke Python-versie je hebt: je spel werkt met Python 3.13, 3.14 of 3.15.

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-ce en pgzero hebben kant-en-klare versies voor Python 3.13, 3.14 en 3.15. Nieuwere versies (3.16 of hoger) werken nog niet.

  1. Open Thonny.
  2. Kijk rechtsonder in het venster. Daar staat de actieve Python-versie, bijv. Python 3.14.8.
  3. Staat er 3.13, 3.14 of 3.15? Dan is alles goed. Staat er iets anders? Installeer dan Python 3.14 via de stappen hieronder.
Tip

Staat er Python 3.13, 3.14 of 3.15? Sla de rest van dit onderdeel over en ga door naar Pygame-ce installeren.

Python 3.14 installeren en Thonny erop laten wijzen

  1. Ga naar python.org/downloads en klik op “All releases”. Zoek Python 3.14 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.14.
  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.14-executable:
    • Windows: C:\Users\<jounaam>\AppData\Local\Programs\Python\Python314\python.exe
    • macOS: /Library/Frameworks/Python.framework/Versions/3.14/bin/python3
    • Linux: /usr/bin/python3.14
  6. Klik op OK en herstart Thonny.

Rechtsonder staat nu Python 3.14. Ga door met het installeren van Pygame-ce.

Pygame-ce installeren

Pgzero heeft Pygame nodig om te werken. We gebruiken pygame-ce, de onderhouden community-versie die ook op Python 3.14 en 3.15 werkt. In je code blijft het gewoon import pygame.

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

Pgzero installeren

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

  1. Ga weer naar Tools → Manage packages…
  2. Typ in het zoekvak: pgzero
  3. Klik op het zoekresultaat en daarna op Install.

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

Notitie

Loopt de installatie van pgzero vast op Python 3.14 of 3.15? Dan komt dat doordat pgzero automatisch ook het klassieke pygame meetrekt, en dat heeft voor die versies geen kant-en-klare versie. Gebruik dan het één-klik installatiescript bovenaan deze pagina, of kies Python 3.13 in Thonny.

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.