Skip to content

riyonp23/Noxu

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

14 Commits
 
 
 
 
 
 
 
 

Repository files navigation

Noxu

A lightweight system utility for global audio control via custom hotkeys.

Python Platform CPU


📌 Overview

Noxu is a lightweight desktop utility that enables instant, global audio control across all active applications through a single configurable hotkey (Shift+A by default). Rather than manually adjusting volume application by application, Noxu hooks into the Windows/Linux audio session API to control all audio sources simultaneously.

The core challenge was achieving zero-latency response while maintaining minimal system impact — solved through optimized multithreaded background processing that keeps CPU utilization consistently below 1%.


✨ Features

Feature Description
⌨️ Global Hotkey Shift+A instantly mutes/unmutes all active applications system-wide
🧵 Multithreaded Background listener runs on a separate thread — no UI blocking
Zero Latency Sub-millisecond response time from keypress to audio change
🪶 Minimal Footprint Sub-1% CPU utilization, 50MB RAM, 15MB install
🚀 Startup Support Configurable to run automatically on system boot
🖥️ Cross-Platform Supports Windows 10/11 and Linux

🛠️ Tech Stack

Technology Purpose
Python 3.5+ Core application (~211 lines)
pycaw Windows Core Audio API integration
keyboard Global hotkey listener
threading Multithreaded background process

Key Engineering: The hotkey listener runs as a daemon thread entirely decoupled from the main process, ensuring zero UI impact. Audio session enumeration is cached on startup to minimize per-keypress latency.


🚀 Getting Started

Prerequisites

  • Windows 10/11 or Linux
  • 15 MB disk space, 50 MB RAM

Installation

# 1. Download and extract the ZIP
# 2. Ensure the assets/ folder is in the same directory as Noxu.exe
# 3. Run the executable
Noxu.exe

Optional: Run on Startup

To have Noxu launch automatically on boot, add it to your startup folder. See this guide for Windows setup.


📁 Project Structure

Noxu/
├── assets/     # UI assets and icons
├── source/     # Python source code (~211 lines)
└── Noxu.exe    # Compiled executable

⌨️ Default Hotkey

Hotkey Action
Shift + A Toggle mute/unmute all applications

👤 Author

Riyon Praveen — Computer Science Student, University of South Florida

LinkedIn GitHub

About

Lightweight Python system utility for global audio control via custom hotkeys. Multithreaded daemon architecture maintains sub-1% CPU utilization with zero-latency response across all active applications.

Resources

Stars

Watchers

Forks

Contributors

Languages