pysoundofinterrupts 0.1.1

Sonify and visualize Linux kernel interrupts by reading /proc/interrupts

pysoundofinterrupts

Sonify and visualize Linux kernel interrupts by reading /proc/interrupts: listen to the system like a stethoscope or plot its activity in real time.

Based on an idea by Nicolás Wolovick: each interrupt drives the speaker in 1-bit PCM fashion (ZX-Spectrum style). If there are about 100 interrupts per second, you hear something like a 100 Hz tone.

Linux only — the program reads /proc/interrupts. On other systems it exits with a clear message.

Links: PyPI · Repository

---

Installation

With pipx (recommended)

Install and run in an isolated environment without touching your global Python:

pipx install pysoundofinterrupts

This makes the interrupts-sound (audio) and interrupts-plot (graph) commands available.

To install from source (e.g. for development):

pipx install .

With pip

pip install pysoundofinterrupts

Requirements: Python 3.8+, Linux.

---

Usage

Command	Description
interrupts-sound	Listen to kernel interrupts in real time (audio).
interrupts-plot	Real-time plot by type (LOC, RES, CAL, TLB).

Real-time sound

interrupts-sound

Press Enter to exit. To calibrate the level:

Option	Environment variable	Description
--subtractor	INTERRUPTS_SUBTRACTOR	Subtract a floor from rate (default 1000)
--divider	INTERRUPTS_DIVIDER	Divide the rate (default 25)
--amplitude	INTERRUPTS_AMPLITUDE	Volume 0–1 (default 0.2)

Example:

interrupts-sound --subtractor 800 --divider 20

Real-time plot

interrupts-plot

Shows interrupts by type (LOC, RES, CAL, TLB). Options:

Option	Environment variable	Description
--x-max	INTERRUPTS_PLOT_X_MAX	Points on X axis (default 100)
--y-max	INTERRUPTS_PLOT_Y_MAX	Y axis upper limit (default 5000)
--interval	INTERRUPTS_PLOT_INTERVAL	Update interval in ms (default 50)

---

Development and tests

Clone the repo, create an environment, and install in editable mode with test extras:

git clone https://github.com/pablogventura/pysoundofinterrupts.git
cd pysoundofinterrupts
python3 -m venv .venv
source .venv/bin/activate   # Windows: .venv\Scripts\activate
pip install -e ".[test]"
pytest tests/ -v

---

Publishing to PyPI

From the project directory, with build and twine installed:

pip install build twine
./scripts/publish_to_pypi.sh

The first time, configure your PyPI credentials (token in ~/.pypirc or TWINE_USERNAME and TWINE_PASSWORD). See Twine: Configuration.

---

Troubleshooting

• No audio: Check your default output device. The program uses the system default or the first available output device.
• Linux only: On Windows or macOS the program exits stating it requires Linux.
• Permissions: Reading /proc/interrupts usually does not require root. If it fails, check that the file exists: ls /proc/interrupts.

---

License

MIT. See LICENSE in the repository.