Django Micboard

Real-time wireless microphone monitoring for Django

Django Micboard is a Django application for real-time monitoring and management of Shure wireless microphone systems. It provides a modern web interface for tracking microphone status, battery levels, RF signals, and audio levels across your wireless systems.

Version: 26.01.27.0 (CalVer: YY.MM.0D.MICRO) License: AGPL-3.0-or-later Python: 3.13+ Django: 5.2 through 6.0

Features

• 🎤 Real-time Monitoring - Live updates via WebSocket for battery, RF levels, and audio
• 🔌 Shure System API Integration - Full support for Shure wireless microphone systems
• 👥 User Assignments - Assign devices to users with location tracking
• 🚨 Smart Alerts - Configurable notifications for battery and RF issues
• 📊 Admin Dashboard - Visual oversight of devices and system health
• 🔒 Transport Hardening - TLS-only authenticated manufacturer connections
• 🧪 Pre-production Beta - Django 5.2 through 6.0 compatible

Quick Start

All installation and environment management uses uv.

# Add django-micboard to an existing uv-managed Django project
uv add "django-micboard[standard,realtime,shure]"

# Add to Django settings
import os

INSTALLED_APPS = [
    # ... other apps
    "channels",
    "huey.contrib.djhuey",
    "micboard",
]

# Configure Shure API
MICBOARD_CONFIG = {
    "SHURE_API_BASE_URL": "https://your-shure-system.local:10000",
    "SHURE_API_SHARED_KEY": os.environ.get("MICBOARD_SHURE_API_SHARED_KEY"),
}

MICBOARD_API_SERVER_ALLOWED_HOSTS = ["your-shure-system.local"]

# Run migrations
uv run --no-sync python manage.py migrate

# Start monitoring
uv run --no-sync python manage.py poll_devices

Supported Systems

• Shure UHF-R, QLX-D, ULX-D, Axient Digital (AD), PSM1000 series
• Plugin architecture for additional manufacturers

Documentation

• Quick Start Guide - Get up and running quickly
• Configuration - All configuration options
• Multitenancy - Tenant-aware setup and behavior
• Shure Integration - Shure System API setup and usage
• API Reference - REST and WebSocket endpoints
• Architecture - System design overview
• Plugin Development - Add a manufacturer using the live plugin contract

Requirements

• Python 3.13+
• Django 5.2 through 6.0
• Django Channels (for WebSocket support)
• Redis (recommended for production)

Support

• GitHub Issues: github.com/justprosound/django-micboard/issues

License

GNU Affero General Public License v3.0 or later (AGPL-3.0-or-later)

See LICENSE for full license text.