pybeats-by-veera 0.1.1

Automatic sound feedback for Python code execution in Jupyter, Google Colab, and IPython.

🎵 pybeats-by-veera

Automatic sound feedback for every Python cell execution in Jupyter, Google Colab, and IPython.

What is pybeats-by-veera?

pybeats-by-veera hooks into IPython's event system so your notebook plays a sound automatically after every cell run — no wrapping, no decorators, no extra code.

• ✅ Success sound when a cell runs without errors
• ❌ Error sound when any exception occurs (including SyntaxError, ZeroDivisionError, etc.)

Installation

pip install pybeats-by-veera

Quick Start

import pybeats
pybeats.enable()

# Now every cell plays a sound automatically:
10 + 5      # ✅ success sound
1 / 0       # ❌ error sound (ZeroDivisionError)

API Reference

Function	Description
pybeats.enable()	Activate sound feedback
pybeats.enable(quiet=True)	Sounds only, no console labels
pybeats.disable()	Deactivate sound feedback
pybeats.is_enabled()	Returns True if active
pybeats.status()	Print current configuration
@pybeats.sound	Decorator for individual functions

Decorator Usage

Works without enable() — wraps a single function:

@pybeats.sound
def fetch_data():
    # plays success or error sound when this function is called
    return requests.get("https://api.example.com/data").json()

Environment Support

Environment	Status	Audio Method
Google Colab	✅ Full support	IPython.display.Audio (browser autoplay)
Jupyter Notebook	✅ Full support	IPython.display.Audio (browser autoplay)
JupyterLab	✅ Full support	IPython.display.Audio (browser autoplay)
IPython terminal	⚠️ Partial	System audio (afplay / aplay / winsound)
Plain Python	❌ Not supported	Graceful warning, no crash

Quiet Mode

Play sounds without the console labels:

pybeats.enable(quiet=True)

How It Works

pybeats-by-veera uses two IPython hooks:

1. post_run_cell event — fires after every cell execution, provides success/error status
2. set_custom_exc — intercepts exceptions (including SyntaxError) before IPython's default handler

Both hooks are registered once on enable() and removed cleanly on disable().

License

MIT — Veerakumar