Skip to content

Wi-Fi Expander

Getting Setup

Read the PDF version here: Wifi Quick Start

Connect to MetaModule

  1. Power off your system.
  2. Connect one end of the included 8-pin cable to the header labelled "WiFi" on the MetaModule, and the other end to the 8-pin header on the Wi-Fi Expander.
  3. Make sure the red stripe is up on both ends of the cable.
  4. Connect the included 10-pin power cable to Eurorack power with the red stripe down.
  5. Power on your case. The Wi-Fi Expander button will turn light blue.

Connecting to a Wi-Fi network (Provisioning)

  • 2. Open to ESP BLE Provisioning app

    At some point the app will ask for permission to use the camera and/or Bluetooth. Click "OK" or "Allow".

    If you do not allow access to the camera and Bluetooth, then you MUST go to your iOS or Android Settings and allow access.

  • 3. Tap the gear icon (upper-left) on iOS or the three dots (upper-right) on Android

    This will open the settings page.

  • ESP BLE Gear

  • 4. Turn off Encrypted Communication

  • ESP BLE Settings

  • 5. Tap "Provision Device"

  • ESP BLE Provision

  • 6. Tap "I don't have a QR code"

  • ESP BLE QR Code button

  • 7. In the PREFIX box, remove the text “PROV_” (if present), and type “4MS”

    On Android, tap “Change” first.

  • ESP BLE prefix

  • 8. Tap the Refresh icon or “Scan Again”

    Then tap the 4MS device that appears

  • ESP BLE scan

  • 9. Select your Wi-Fi network from the list

    Enter your Wi-Fi password when asked.

    After a moment, the light on the Wi-Fi Expander will turn green.

  • 10. On the MetaModule, go to Settings > Info

    Look for the Wi-Fi IP address

  • Settings Wifi IP

  • 11. On your computer, open a browser window and type in the IP address

    Hint: the IP address starts with http://, not with https://

  • Browser Wifi IP

  • You're connected!

    In the browser, navigate to the drive (and optionally, a subfolder) where you want to put a patch.

    Click the Upload button and select a .yml patch file to transfer, or drag and drop it.

    When the progress bar is complete, the patch file can be played on your MetaModule!

  • Drag and Drop file

After connecting to a Wi-Fi network, you can choose to delete the ESP BLE Provisioning app. However, if you anticipate needing to change Wi-Fi networks, you may want to leave it installed.

Using the Wi-Fi Expander with VCV Rack

  • 2. Enter the Wi-Fi Expander's address into the VCV Rack MetaModule hub

    Right-click on the MetaModule panel.

    From the menu, select "Set Wi-Fi Expander address".

    Enter the address you found by going to Settings > Info on the MetaModule (see above).

  • VCV: Select Wi-Fi URL

  • 3. Select the volume you want to transfer to

    Right-click on the MetaModule in VCV Rack and choose a volume from the "Wi-Fi sends to:" submenu.

    Note that the Internal drive has very limited space (2MB max), so it's recommended to store patches on USB or Card if possible.

    Note: sending to sub-folders is not yet supported. Use a web browser if you need to do that.

  • VCV: Select Wi-Fi volume

  • 4. Click the Wi-Fi button to transfer a patch

    If you hover the cursor over the button, the Wi-Fi settings will display in the main text box.

    After clicking, the top text box will display "Sent patch file" or "Failed to send patch".

  • VCV: Click Wi-Fi button


Changing Wi-Fi networks

Power on with the button held down. Release it when it turns red. The light will turn off and then turn light blue. You can then perform the steps at the top of this page.


Wi-Fi Expander Troubleshooting

  • Cannot get the ESP BLE Provisioning app to see the Wi-Fi Expander module:

    • Did you disable Secure Communication in the app settings?
    • Did you erase the prefix text "PROV" and replace it with "4MS"?
    • Did you give the app permission to use the camera? Even though the Wi-Fi Expander doesn't have a QR code, the app will still not function unless you give it permission to use the camera.
    • Did you give the app permission to use Bluetooth?
    • Go to your phone's settings and verify it has Bluetooth and camera permissions
  • Cannot see my hotspot in the list of Wi-Fi networks:

    • If you are creating a personal Wi-Fi network (aka "hotspot"), then it's possible you will need to run the ESP BLE Provisioning app on a different device. The app may not be able to see the hotspot network created on the same device that it's running on.
  • My browser won't load the Wi-Fi Expander's page

    • Your computer must be on the same network as the Wi-Fi expander. Make sure whatever Wi-Fi network you entered into the ESP BLE app is the same as the network your computer is connected to.
  • I don't have a Wi-Fi button on my VCV Rack MetaModule hub

    • You need to install the 4ms plugin v2.0.9 or later
  • I can't send a patch over Wi-Fi using VCV Rack

    • Verify the IP address is correct: compare it carefully with what's displayed on the MetaModule Settings > Info page. Don't forget to type the "http://" at the start.

    • Try typing the IP address into a browser to make sure you have the right address

    • Your computer has to be on the same Wi-Fi network as the MetaModule Wi-Fi Expander.

    • Are you trying to transfer to a volume (Card or USB) that's not inserted into the MetaModule? Go to Load Patch on the MetaModule and make sure the volume you're trying to transfer to is actually detected.

    • If you are transferring to the Internal drive, it's possible you ran out of space. Delete some patches.

    • There is a limit of 1MB for patch files transferred to USB or Card, and 256kB for the Internal drive. Most modules store very little (only a few bytes, if anything) but some modules store 64kB or more. Try saving the .yml patch file to your computer and then looking at how large it is.