Bug Reporting for Pygame

Integration

Up and running in minutes

Install via pip and add a few lines of Python. No extra dependencies required.

        
        terminal
      
# Install from PyPI
pip install bugnet-sdk

        
        main.py
      

import bugnet_sdk

# Initialize once at startup
bugnet_sdk.init("YOUR_API_KEY", "https://api.bugnet.io")

# Report a bug
bugnet_sdk.report_bug(
    "Player fell through floor",
    "Happened on level 3 near the bridge",
    priority="high"
)

# In your game loop, pass events and update
for event in pygame.event.get():
    bugnet_sdk.handle_event(event)
bugnet_sdk.update(screen, clock)

# Show the bug report widget (e.g. on a keybind)
bugnet_sdk.show_widget()
      

Get the Pygame Module

Built for Pygame

Everything you need, nothing you don't

Native Python Module

Pure Python module with zero extra dependencies. Just drop it into your project.

Automatic Crash Reports

Stack traces with OS and display info, plus recent logs, captured automatically.

Screenshot Capture

Capture the Pygame display surface and attach it to every bug report.

Session Replay

A timeline of the player's recent keyboard and mouse input before the report (Studio Plus).

Pygame 2.x Ready

Works with Pygame 2.x and Python 3.8+.

Cross-Platform

Windows, macOS, and Linux. One module for every platform Pygame supports.

How it works

Three steps to fewer bugs

Install the SDK

Run pip install bugnet-sdk to add it to your project. Import it and add your API key.

Players report bugs

Players submit bug reports directly from your game. Screenshots, device info, and session data are captured automatically.

You fix and ship

Triage reports in your Bugnet dashboard, assign priorities, and track fixes on a public bug tracker your players can follow.

“As a solo dev, players were leaving faster than I could read Discord. Bugnet showed me exactly which bugs were causing the most churn. I fixed the top three and my retention rate doubled in two weeks.”

Sam Bell

Solo Dev, Echoes of the Rift

340+Studios

1.2M+Bug reports

38%Less churn

FAQ

Pygame bug reporting questions

How do I install the Bugnet Pygame SDK?

Install it with pip (pip install bugnet-sdk) or drop the single bugnet_sdk.py file next to your main script. Import it, initialise it with your API key and call bugnet_sdk.update(screen) once per frame from your game loop.

Does it catch unhandled Python exceptions?

Yes. Unhandled exceptions are reported with the full traceback, the OS, Python and Pygame versions and your game version, and identical tracebacks are grouped so you can see how many players hit each one.

Does it work after packaging with PyInstaller?

Yes. The SDK is plain Python with no compiled dependencies, so it is bundled like any other module and keeps reporting from the frozen executable.

Can players report bugs from inside the game?

Yes. The SDK draws a report form over your game and attaches a screenshot of the surface you pass to update(). On Studio Plus it can also attach a short replay of the last few seconds of gameplay.

Is Bugnet free for Pygame games?

The free plan includes up to 100 bug reports in total (a lifetime cap, not a monthly allowance), which is plenty to integrate the SDK and run a playtest. Paid plans raise the limits and add features such as session replay.

Error tracking for Pygame Games