Skip to content

Support & Troubleshooting

If you run into a problem with EP-PatchStudio, the fastest way to get help is to export your diagnostic logs and email them to me. The logs help me understand exactly what happened on your machine.

Step-by-step:

  1. Open Settings: on the desktop it’s at the foot of the left sidebar, next to the Recycle Bin
  2. Go to the Help & Support tab: Find the Diagnostic Logs section
  3. Click “Export Diagnostic Logs”: Save the diagnostic ZIP file somewhere you can find it
  4. Click “Email Support”: This opens your email app. You can also write to support@squarewave.studio from any mail app
  5. Attach the ZIP and describe the issue: Include what you were doing when the problem occurred and any error messages you saw

The diagnostic ZIP file contains technical information to help diagnose your issue. Here is exactly what is included:

support-info.txt: App version, platform, OS version, connected device model and firmware, licence status, and the app’s random install ID for cross-referencing analytics

current-session.log: Log of operations from your current session (navigation, file transfers, device events, errors)

Previous session logs: Logs from the last 7 days of use, so issues from earlier sessions are captured too

The support logs never contain audio data or personal information. A log line can include a sample or project name. Otherwise only technical operation data (timestamps, slot numbers, file sizes, error messages) is logged. The install ID is a random UUID generated on first launch and is not linked to your name, email or any account.

  • Make sure your EP device is powered on before connecting the USB cable
  • Update to the latest EP-PatchStudio. On a computer, check for updates in Settings > About
  • Try a different USB cable. Some cables are charge-only and do not carry data
  • Try a different USB port, preferably directly on your computer (not through a hub)
  • Close any other application that might be using the MIDI connection (the official browser tool, DAWs, etc.)
  • Restart EP-PatchStudio and reconnect the device
  • On macOS 12 Monterey or 13 Ventura, update Safari through Software Update. EP-PatchStudio draws its screens with Safari’s engine, so an old Safari can stop parts of the app working
  • On macOS, check that your Mac can see the device. Open Audio MIDI Setup (in Applications > Utilities), choose Window > Show MIDI Studio and look for your EP. If it isn’t there, or its icon is greyed out, the problem is the cable, the port or the device, not the app. Try other cables and ports until it shows up

If it still won’t connect, send me a debug log:

  1. Plug in your EP and switch it on
  2. Open Settings, go to the Help & Support tab and click “Enable Debug Logging”
  3. Wait about 10 seconds
  4. Click “Export Diagnostic Logs” straight away, without closing the app. The connection details are only kept while the app is open, so closing it first loses them. Save the ZIP and email it to me with your OS version and EP model
  • “Failed to initialize download - invalid response” : The device may be busy with another operation. Wait a few seconds and try again
  • “Request timed out” : The USB connection may have been interrupted. Disconnect and reconnect your device
  • Upload seems stuck: Large files take longer. Check the progress bar. If it is genuinely stuck, cancel and retry
  • Avoid disconnecting the USB cable during file transfers
  • If samples sound wrong or appear corrupted, try downloading them again
  • Check the Recycle Bin, at the bottom of the sidebar. Samples you deleted in the last 30 days can be restored from there
  • If you have a backup, use Backup & Restore to restore your samples
  • For persistent issues, export your diagnostic logs and contact support
  • Always create a backup before performing bulk operations (delete all, clear projects, factory reset)
  • Keep EP-PatchStudio updated. Check for updates in Settings > About
  • If the app behaves unexpectedly, try closing and reopening it

Best for bug reports and technical issues. Please attach your diagnostic ZIP.

support@squarewave.studio

Join the community for tips, feature requests and general chat.

Join the Discord server →

EP-PatchStudio is a solo developer project. I typically respond to email within 24 hours during the working week. Bug reports are my top priority. Attaching your diagnostic ZIP helps me resolve issues much faster.

If I ask you to turn on debug logging for a tricky issue, here is how:

  1. Open Settings: go to the Help & Support tab
  2. Click “Enable Debug Logging” in the Diagnostic Logs section: a notification confirms it’s on, and a “Debug logging” badge appears next to the section name
  3. Reproduce the issue: perform the steps that trigger the problem
  4. Click “Export Diagnostic Logs”: the logs include extra detail, such as the MIDI messages sent to your device

Debug logging stays on until you click “Disable Debug Logging” or close the app, and it’s off again the next time you open EP-PatchStudio. Export the logs before you close the app: some of the detail is only kept while it’s open.

Configure app preferences, telemetry and updates

Protect your samples and projects with device backups

Export your diagnostic logs and email me. I will get back to you as soon as I can.

Email support or join the Discord.

Occasional emails about new apps, features and releases.