🎵 Audio Radar Overlay

Real-time directional audio visualization for games. See where sound is coming from with color-coded arrows.

---

What It Does

Displays a fullscreen overlay that shows the direction of audio—left, right, or front—as directional arrows. Useful for games where audio cues matter (DayZ, tactical shooters, horror games, etc.).

---

Features

• Real-time audio direction detection — Updates as audio plays
• Multiple color profiles — Standard, Protanopia, Deuteranopia, Tritanopia, and High Contrast modes
• Fully adjustable — Arrow size, width, spread distance, opacity, and sensitivity
• Click-through overlay — Your clicks pass through to the game
• System audio capture — Listens to speaker output via loopback
• Low overhead — Minimal CPU and RAM usage

---

Setup

Requirements

• Windows 11 (or Windows 10)
• Python 3.8+
• Dependencies: tkinter, soundcard, numpy, pywin32, screeninfo

Installation

git clone https://github.com/your-username/audio-radar-overlay.git
cd audio-radar-overlay
pip install tkinter soundcard numpy pywin32 screeninfo
python audio-radar-overlay.py

The settings window opens first, then the fullscreen overlay activates.

---

Usage

1. Launch the script — Settings window opens, overlay goes fullscreen
2. Start your game — Overlay stays on top and passes clicks through
3. Adjust settings with the sliders:
   • Arrow Size — Overall scale
   • Arrow Width — Thickness of the arrows
   • Spread Distance — How far from center the arrows appear
   • Opacity — Transparency (0.1–1.0)
   • Sensitivity — Audio detection threshold
   • Color Profile — Accessibility profiles
4. Close the settings window to exit

---

Arrow Directions

Direction	Default Color
Left	Green
Right	Green
Front	Red
Back	Cyan

Arrows point toward the sound source.

---

Color Profiles

Accessibility-focused color schemes:

• Standard — Default (green/red/cyan)
• Protanopia — Red-blindness friendly
• Deuteranopia — Green-blindness friendly
• Tritanopia — Blue-yellow blindness friendly
• High Contrast — Maximum visibility

Select from the dropdown. No restart needed.

---

Troubleshooting

Overlay isn't visible
Make sure your game runs in fullscreen or borderless windowed mode.

No audio detected
Check that sound is routing through your speakers. Verify loopback capture is enabled on your audio device (usually automatic on Windows).

Arrow is laggy or jerky
Increase the Sensitivity slider. If audio is quiet, detection will be slower.

Want custom colors
Edit the self.profiles dictionary in the code. Change hex values to whatever you need.

---

Performance

• CPU: ~2–3% on modern systems
• Latency: ~50ms from audio to visual update
• RAM: <100MB
• No dedicated GPU needed

Limitations

• Mono audio — Single-channel audio won't distinguish left/right
• System audio only — Captures whatever's playing through your speakers (including Discord, music, etc.)
• Windows only — macOS and Linux support forthcoming

Contributing

Got improvements? Found a bug? Feel free to fork and submit a pull request.

License

MIT — Do what you want with it.

Changelog

v1.0 — Initial release