playbounce
A brick-breaker game where the wall is somebody's name, and the name fights back.
Before you start
You need Python 3.9 or newer. Check with python3 --version. If that command isn't found, install Python from python.org/downloads or your package manager (apt install python3-pip, dnf install python3-pip).
Install
python3 -m pip install playbounce
Play
playbounce
opened playbounce in your default browser
file:///usr/local/lib/python3.12/site-packages/playbounce/web/index.html
Your browser opens on a landing screen with a stranger's name already typed in: ROSIE, KWAME, PRIYA, whoever comes up this time. Press Enter to play as them, or type over it with a name of your own. The wall is that name, spelled out in destructible bricks.
Then it wakes up. It reddens as you damage it, hardens so bricks take more hits, screams and shakes the screen, drops projectiles, and charges beams that saw blocks off your paddle. Lose every block and you're finished, however many lives you had left. Leave it alone too long near the end and it heals, growing back around you.
The game runs entirely in the browser with no network access, no backend, and no audio files. This package is a launcher for it.
Serve it instead
To open the game on a phone or tablet on the same network:
playbounce --serve
playbounce serving on http://127.0.0.1:8000
also reachable at http://192.168.1.24:8000
press ctrl-c to stop
| Option | What it does |
|---|---|
--serve |
Serve over localhost rather than opening the file directly |
--port N |
Serve on port N, or the next free port above it. Implies --serve |
--no-browser |
Print the address instead of opening a browser |
--version |
Print the version |
Controls
Space is the action key: it starts a game, launches the ball, pauses, resumes, and plays again. Enter also starts a game from the menu. Escape backs out one level. Move the paddle with the mouse, the left and right arrows, or by dragging on a touchscreen.
Documentation
- USAGE.md, the full manual: modes, settings, the beast, powerups, the font, and the debug log
- ARCHITECTURE.md
- CHANGELOG.md
License
MIT
Built by Mo Shehu
Release files for playbounce 1.0.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| playbounce-1.0.0.tar.gz | 37.4 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| playbounce-1.0.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 77.3 kB
Release files / playbounce-1.0.0.tar.gz
| Download URL | playbounce-1.0.0.tar.gz |
|---|---|
| Size | 37.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
957f012345f20d5091f15a6c95c860146d43383cfb8289865d3d3ba780f6f30e
|
|
BLAKE2b-256 checksum How to use checksums |
f6afdb40b567aa5cb57628ec5a95cd7e8b254471e1b30feb075db78c614b0a60
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Aug 17, 2026.
Transparency logRelease files / playbounce-1.0.0-py3-none-any.whl
| Download URL | playbounce-1.0.0-py3-none-any.whl |
|---|---|
| Size | 39.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
d6fea59b8388d19451ba0a76a65ec6bcf302a68a56dc5c0dcdfa2c63f9571833
|
|
BLAKE2b-256 checksum How to use checksums |
4b4a23ae9d415712ca8081ed782747d4837281800efd519879c6f9486ee94438
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Aug 17, 2026.
Transparency log