pyscrh

A tiny, Scratch-style sprite library built on pygame, made for people moving from Scratch to Python.

Every Scratch block you know has a short Python equivalent — no game loop, no event handling, no surface juggling to remember.

Install

pip install pyscrh

(Requires Python 3.8+ and pygame, which is installed automatically.)

Quick start

import pyscrh

apple = Sprite("apple.png")     # load an image (PNG with transparency)
apple.turnway = "lr"            # flip left-right when bouncing

def forever():
    apple.move(5)               # walk 5 steps in the current direction
    apple.edgeb()               # bounce off the screen edge
    # stop_all()                # call this anywhere to quit the game

clickGF()                       # start the game

Just import pyscrh and you're done — Sprite, clickGF, stop_all, WIDTH and HEIGHT are available directly, just like import pgzrun.

That's it. The apple walks right, bounces off the right edge, walks left, bounces off the left edge, and repeats.

Scratch → Python cheat sheet

How it works

You only write one required function:

• forever() — called once every frame, like Scratch's forever block. Put sprite.move(...), edgeb(), etc. in here. No dt parameter needed; the library handles timing.

An optional draw() is also called every frame, after all sprites are drawn, if you want extra drawing (text, backgrounds, etc.).

Call clickGF() to start, and stop_all() to close the window and quit. pyscrh handles the window, clock, event loop and rendering for you.

API reference

Sprite(image_path, name="")

Create a sprite from an image file.

License

MIT