SmartMicrophone is a modern, open-source web-based microphone and remote control system for UltraStar Deluxe (USDX) and compatible karaoke games. It lets you use your smartphone as a wireless microphone, control the game from your phone, manage songs, and adjust settings---all through a fast, mobile-friendly web interface.
- Wireless Microphone: Use your phone as a microphone for UltraStar Deluxe.
- Multi-mic Support: Up to 6 virtual microphones, each mapped to a player slot.
- Remote Control: Send keystrokes and text to the game, including navigation and search.
- Song Management: Search, preview, and add songs to playlists.
- Settings Panel: Configure audio options, delays, and more --- instantly, and per device
- Hotspot & Network Integration: Supports Wi-Fi hotspot mode and advanced network forwarding.
- Automatic Device Mapping: Maps domain names to hotspot IPs for easy connection.
- Secure HTTPS Option: SSL support and port remapping for secure connections.
git clone https://github.com/dgruss/SmartMicrophone.git
sudo add-apt-repository ppa:longsleep/golang-backports
sudo apt update
sudo apt install python3 python3-pip git make gcc make pkg-config libopus-dev libopusfile-dev libpulse-dev golang-go libsdl2-image-dev python3-flask pipewire pipewire-pulse libpulse-dev libopus-devgit clone https://github.com/dgruss/SmartMicrophone.git
cd SmartMicrophone/pulse-receive
go build .
cd ..- Install UltraStar Deluxe and place your songs in the appropriate folder (currently only the /songs folder is supported but symlinks are followed)
- Some features require using the dgruss beta3 version as they are not upstreamed yet
- Make sure you know the path to your usdx game directory (e.g.,
/home/user/usdx)
cd ~
git clone https://github.com/dgruss/USDX.git usdxdev
cd usdxdev
git checkout beta3
sudo apt install git automake make gcc fpc libsdl2-image-dev libavformat-dev libavcodec-dev libavutil-dev libswresample-dev libswscale-dev libsqlite3-dev libfreetype6-dev portaudio19-dev libportmidi-dev liblua5.3-dev libopencv-videoio-dev fonts-dejavu
./autogen.sh
./configure --without-portaudio --without-portmixer
make
cd ~
ln -s ~/usdxdev/game usdx
- Place your SSL certificate and key files in the project directory if you want HTTPS --- this might be required to convince your phone to use WebRTC. Self-signed certificates work. Otherwise you can use a domain or subdomain you have on the Internet (give the DNS entry a short lifetime on your server!) and configure SmartMicrophone to use domain and certificates
- See Advanced Networking below for details
python3 server.pyDo not run the server with sudo.
Some options perform operations that require sudo permission. However, SmartMicrophone should not be run with sudo. Instead, SmartMicrophone will invoke sudo internally, which means you may be prompted for your sudo password.
| Option | Description |
|---|---|
--start-hotspot <name> |
Start the given hotspot using nmcli before domain setup |
--internet-device <iface> |
Network interface providing internet connectivity (e.g., wlan0), invokes sudo |
--hotspot-device <iface> |
Network interface for the hotspot (e.g., wlan1), invokes sudo |
--ssl |
Enable SSL (requires --chain and --key) |
--chain <cert> |
SSL chain/cert file (fullchain.pem or cert.pem) |
--key <key> |
SSL private key file (privkey.pem) |
--port <port> |
Port to run the server on (default: 5000) |
--remap-ssl-port |
Remap ports so that users can access the server on the default HTTPS port, invokes sudo |
--domain <domain> |
Setup a domain to hotspot IP mapping via NetworkManager/dnsmasq, invokes sudo |
| Option | Description |
|---|---|
--usdx-dir <path> |
Path to usdx directory (default: ../usdx) |
--playlist-name <name> |
Playlist filename (default: SmartMicSession.upl) |
--run-usdx |
Run UltraStar Deluxe after server startup |
--audio-format <ext> |
Audio format of songs in UltraStar Deluxe (default: m4a) |
--set-inputs |
Initialize [Record] section in config.ini for 6 virtual sinks |
--skip-scan-songs |
Skips the song scan to speed up the server start |
| Option | Description |
|---|---|
--debug |
Enable debug mode |
python3 server.py --ssl --chain ../cert.pem --key ../key.pem --remap-ssl-port --domain usdx.gruss.cc --set-inputs --start-hotspot usdx --internet-device wlan1 --hotspot-device wlan0 --run-usdxAccess the server from your phone or computer:
http://<server-ip>:<port>/
Or, if using SSL and port remapping:
https://<domain>/
 |
 |
| Microphone - View and join available mic slots - Assign multiple phones to a mic - See current assignments |
Songs - Search by artist or title - Preview audio - Add songs to playlist |
 |
 |
| Control - Acquire/release control - Send keystrokes - Type text to the game - Only one user controls at a time |
Settings - Noise suppression, echo cancellation, normalization - Set per-player delay - Change display name - Enable debug output |
 |
Lock Screen - Prevent accidental taps/swipes - Standby mode during singing |
- Use
--start-hotspotto activate a Wi-Fi hotspot - Use
--domainto map a domain name to the hotspot IP for easy phone connection
- Use
--internet-deviceand--hotspot-deviceto forward internet from one interface to another (iptables rules, requires sudo)
- Use
--ssl,--chain, and--keyfor HTTPS - Use
--remap-ssl-portto allow access via port 443 (requires sudo)
- Network problems:
- Verify that the hotspot exists in network manager with the corresponding name (e.g. usdx).
- flush all iptables rules
sudo iptables -F - First connect the internet device, then create the hotspot, then run this tool.
Pull requests and issues are welcome!