For the complete documentation index, see llms.txt. This page is also available as Markdown.

Troubleshooting

Common Troubleshooting Issues

1. 🟣 LED 3 Blinking Purple = It's in Client Mode

Solution: ‘Long Press’ “M” button. The third LED will turn SOLID blue, indicating that it is ready to connect. Follow Step 2 and connect MUGIC to a Wi-Fi Network.

2. 🔵 LED Blinking Blue and computer is connected to MUGIC but the data isn't working = It's in USB mode.

Solution: ‘Tap’ M button twice. The third LED will turn SOLID blue, indicating that it is ready to connect. If it turns purple, see “Common Issue 1”.

Client-mode connection quick fixes

If MUGIC® won't join your Wi-Fi network in Client mode, check these first:

  • Use a 2.4 GHz network. MUGIC® cannot see or join 5 GHz networks. On an iPhone hotspot, turn on Settings → Personal Hotspot → "Maximize Compatibility". This is the most common cause.

  • The "Success" popup only means "saved," not "connected." Power-cycle MUGIC® after configuring, then confirm: fast blinking purple = still trying; slow, steady blinking purple = connected and streaming.

  • Still seeing MugicConnectXXXXXX? If MUGIC®'s own network reappears after restart, it failed to join yours — recheck the network name/password and the 2.4 GHz requirement.

  • Connected but no data? Set the Client IP to your computer's IP address, match the port (default 4000), and make sure your computer's firewall isn't blocking incoming UDP.

  • Password too long? MUGIC® supports Wi-Fi passwords up to 63 characters; shorten it or use a different 2.4 GHz network.

For more detail, see the Frequently Asked Questions.

Last updated