pygbag

Package game for web

$ pygbag [path/to/game]

$ pygbag --build [path/to/game]

$ pygbag --dev [path/to/game]

$ pygbag --archive [name] [path/to/game]

$ pygbag --template [template.html] [path/to/game]

pygbag [--build] [--dev] [options] path

pygbag packages Pygame applications for deployment in web browsers by compiling Python code to WebAssembly using Emscripten and Pyodide. The resulting build runs directly in modern browsers without plugins, making it straightforward to share Python games and multimedia applications online.
The tool includes a built-in development server for local testing before deployment. Games must use async Python patterns with asyncio to work within the browser's event loop model. pygbag handles asset bundling, HTML template generation, and the WebAssembly compilation pipeline, producing a self-contained web application from a standard Pygame project.

--build

Build only, no server.

Development mode.

Archive filename.

Custom HTML template.

CDN base URL.

Page title.

Not all Python libraries work. Async code required. Large download size.

pygbag was created to bring Pygame games to web browsers using WebAssembly and Pyodide.

pygame(1), python(1), emcc(1)