Spatial Audio Dashboard

Move the cursor. Move the sound. A real-time Python application that uses cursor movement to control the perceived spatial position of audio.

Overview

Spatial Audio Dashboard is an interactive desktop application for experimenting with spatial audio using ordinary stereo headphones or earphones.

Move the cursor around the interaction area to control the sound in real time. The application maps cursor position to stereo panning, elevation.

Features

• Real-time cursor-controlled spatial audio
• Left/right stereo panning
• Elevation-based processing
• High-frequency attenuation
• Smooth spatial transitions
• Audio playback controls
• WAV, MP3, FLAC, OGG, and M4A support
• PySide6 desktop interface

Controls

Cursor Position	Effect
Left / Right	Stereo panning
Top / Bottom	Elevation

Keyboard Shortcuts

• Space — Play / Pause
• Ctrl + O — Load audio
• Escape — Stop
• R — Reset position

Project Structure

spatial-audio-dashboard/
├── app/
│   ├── audio/       # Playback and DSP effects
│   ├── core/        # Configuration and state
│   ├── spatial/     # Spatial calculations
│   ├── ui/          # PySide6 interface
│   ├── utils/       # Audio utilities
│   └── main.py
├── tests/
├── README.md
└── requirements.txt

Installation

git clone https://github.com/YKMadhav/Spatial-Audio-Dashboard.git
cd Spatial-Audio-Dashboard

python3 -m venv .venv
source .venv/bin/activate

pip install -r requirements.txt

For MP3, AAC, and M4A support, install FFmpeg.

On macOS:

brew install ffmpeg

Run

python -m app.main

Load an audio file, press Play, and move the cursor around the interaction area.

Headphones or earphones are recommended for the best spatial effect.

Tech Stack

• Python
• PySide6 — GUI
• NumPy — numerical and audio processing
• sounddevice — audio playback
• pydub — audio loading
• FFmpeg — compressed audio support
• Custom DSP — panning

Author

Khatwang Madhav Yippili

B.S. (Hons.) in Mathematical Sciences and Computing

Sri Sathya Sai Institute of Higher Learning