Automatic availability status based on microphone usage. Perfect for remote work, open offices, and better workplace communication.
- 🎯 Automatic Detection - Knows when you're in a meeting
- 🚦 Visual Status - System tray icon + optional Luxafor LED flag
- 🔒 Privacy First - No network access, completely offline
- 🎨 Smart Filtering - Eliminates false positives from apps with mic permission
- ⚡ Lightweight - Minimal CPU and memory usage
- 🌍 Cross-Platform - Windows and macOS support
Download the latest release for your platform:
| Platform | Download | Requirements |
|---|---|---|
| Windows | MicrophoneStatusMonitor.exe | Windows 10/11 |
| macOS | MicrophoneStatusMonitor.dmg | macOS 10.15+ |
# Clone repository
git clone https://github.com/yourusername/luxstatus.git
cd luxstatus
# Install dependencies
pip install -r requirements.txt
# Run directly
python secure_mic_monitor.py
# Or build executable
python deploy_windows.py # Windows
python deploy_macos.py # macOS- Launch the application - it starts in the system tray
- Right-click the tray icon for options
- Auto Mode (default) - Automatically detects microphone usage
| Status | Color | Meaning |
|---|---|---|
| 🟢 Green | Available | Free to talk |
| 🔴 Red | Busy | In meeting/call |
| 🔵 Blue | Do Not Disturb | Focused work |
| 🟡 Yellow | Away | Break/lunch |
The app works with Luxafor LED flags for physical status indication:
- Plug in your Luxafor device
- Start the application
- Colors sync automatically
Note: The app works perfectly without a Luxafor device.
The app works out-of-the-box with sensible defaults. For advanced configuration, see USER_GUIDE.md.
luxstatus/
├── secure_mic_monitor.py # Main application
├── mic_monitor/
│ ├── platform/ # OS-specific implementations
│ │ ├── windows.py # Windows mic detection
│ │ └── macos.py # macOS mic detection
│ ├── devices/ # Hardware integrations
│ │ └── luxafor.py # Luxafor flag control
│ └── status_manager.py # Status logic
└── deploy_*.py # Build scripts
Contributions are welcome! Please feel free to submit a Pull Request.
- Fork the repository
- Create your feature branch (
git checkout -b feature/AmazingFeature) - Commit your changes (
git commit -m 'Add some AmazingFeature') - Push to the branch (
git push origin feature/AmazingFeature) - Open a Pull Request
- Python 3.8+
- Git
- Platform-specific tools:
- Windows: Visual C++ Redistributable
- macOS: Xcode Command Line Tools
# Create virtual environment
python -m venv venv
# Activate virtual environment
# Windows:
venv\Scripts\activate
# macOS/Linux:
source venv/bin/activate
# Install development dependencies
pip install -r requirements.txt
pip install pytest black flake8 # Optional dev tools# Run the application in debug mode
python secure_mic_monitor.py
# Test microphone detection
python -c "from mic_monitor.platform.windows import WindowsMicrophoneMonitor; m = WindowsMicrophoneMonitor(); print(m.get_status())"| Issue | Solution |
|---|---|
| App doesn't detect microphone | Check OS microphone permissions |
| Luxafor not working | Try different USB port, install drivers |
| False positives | App auto-filters most, use manual override if needed |
| Won't start on macOS | Right-click → Open to bypass Gatekeeper |
For detailed troubleshooting, see USER_GUIDE.md.
This project is licensed under the MIT License - see the LICENSE file for details.
- ✅ Windows support
- ✅ macOS support
- ✅ Luxafor integration
- ✅ Auto-detection
- ✅ Manual overrides
- 🚧 Linux support (planned)
- 🚧 Auto-updates (planned)
Made with ❤️ for better workplace communication