Asked

Soundboard File Import Issue

I am having trouble importing sound files into the Soundboard robot skill in Synthiam ARC. It seems like the file names are missing the "." between the file name and the file extension. For example, "MySound.MP3" appears as "MySoundMP3," and I receive an error message indicating that it is not a valid file. Additionally, I can't find a way to edit the file name directly in the Soundboard. Is there a workaround for this issue?



Related Hardware (view all EZB hardware)
EZ-B V4 by EZ-Robot
EZ-B v4/2 robot controller: dual Cortex ARM, Wi-Fi, audio/video, 24 servo/digital ports, I2C/UART, camera and Synthiam ARC control for custom robots
Wi-Fi / USB
Servos 24
Camera
Audio
UART 3
I2C
ADC 8
Digital 24

Related Robot Skills (view all robot skills)
Soundboard (EZB) by Synthiam
Play WAV/MP3 via EZ-B v4, manage tracks, add timed scripts for synced robot actions, control via ControlCommand(), volume and clipping indicators.
Soundboard (PC) by Synthiam
Play and manage MP3/WAV sound effects from a PC soundboard, load tracks, trigger or script playback (one file at a time), export and automate.

ARC Pro

Upgrade to ARC Pro

Take control of your robot's destiny by subscribing to Synthiam ARC Pro, and watch it evolve into a versatile and responsive machine.

Author Avatar
PRO
Canada
#1  

Thanks - good details. Let’s troubleshoot this stepbystep and get you importing files reliably.

Possible causes

  • The file on disk doesn’t actually have a ".mp3" / ".wav" extension (Windows sometimes hides extensions).
  • The filename contains special characters or extra dots (e.g. My.Sound.v1.mp3) that the Soundboard conversion/display is handling oddly.
  • ARC didn’t finish converting the file (permission issue) so the UI shows a malformed entry.
  • A bug in the Skill UI is hiding the dot, but the file itself may still import if done differently.

Quick checklist and fixes (try in this order)

  1. Confirm the real file name and extension on disk
  • In Windows Explorer, enable showing extensions: View Options View tab uncheck "Hide extensions for known file types".
  • Verify the file is actually named MySound.mp3 (or .wav). If not, rename it to a simple name with only letters/numbers and a single extension (example: MySound.mp3).
  1. Simplify the filename
  • Rename the file to a short name with no spaces, no special characters, and only one dot (example: MySound.mp3).
  • Avoid extra dots (My.Sound.v1.mp3) during troubleshooting.
  1. Import the file into Soundboard
  • In ARC, open the Soundboard (EZB) or Soundboard (PC) skill.
  • Leftclick the Tracklist area of an empty row Select your renamed file.
  • If the UI still displays the filename without the dot, try pressing the Play button to see if it actually plays.
  1. If import fails with a "not valid file" error
  • Verify the file plays on your PC (doubleclick in Explorer). If it doesn’t play in Windows, re-encode using Audacity and export to WAV or MP3.
  • Run ARC as Administrator (rightclick ARC Run as administrator) and reattempt import. ARC needs to convert & write the audio files; a permissions problem can stop conversion and give malformed entries.
  • Try a different folder (e.g., Desktop) when selecting the file to avoid permission/paths issues (long or network paths can cause problems).
  1. Editing / renaming a track inside the Soundboard
  • The Soundboard does not provide direct inskill renaming of the track label. Workarounds:
    • Rename the original file on disk, delete the Soundboard row, then add the file again (it will show the new filename).
    • Or use the Export button on the track (if available), rename the exported file, then delete and readd.
    • If you need a custom display name, put a short file name on disk you want shown in the list before importing.
  1. Clean the list and re-try
  • If blank/malformed rows remain, press Clean in the Soundboard to compact the list and retry adding the tracks.

Alternative/temporary workarounds

  • Use Soundboard (PC) if you only need PC audio playback - it’s often simpler and less constrained than EZB audio conversion.
  • Use scripting: Audio.playAudioFile("C:\path\MySound.mp3") to play directly from a script (PC audio). Example in JavaScript:
    // Play a PC audio file (plays on the computer)
    Audio.playAudioFile("C:\\Users\\YourUser\\Desktop\\MySound.mp3");
    
  • For EZ-B speaker playback, once the track is successfully added to the Soundboard (converted), you can trigger it from scripts with controlCommand("Soundboard v4", "Track_0").

What I need from you if it still fails

  • Which Soundboard gives the problem: Soundboard (EZB) or Soundboard (PC) or both?
  • ARC version and Windows version (example: ARC 2025.x.x on Windows 10/11). You can find ARC update in Project Help Check for Updates or Utility.checkForUpdate().
  • Exact error message text (copy & paste). If you attached an image, I can’t view images - please paste the exact text shown.
  • A sample filename that fails (exact characters) and whether that file plays locally on your PC.

Useful docs

Next step? Try the steps above (especially renaming the file to a simple name, enable file extensions in Explorer, and try running ARC as Administrator). If it still fails, paste the exact error text, ARC version, OS, and one failing filename and I’ll dig deeper and provide the exact commands or a reproducible workaround.


I am a customer support GPT-powered AI and still learning. If you have doubts about my response, please use the support documentation to verify my answer.
Author Avatar
PRO
Synthiam
#2  

Do you have the latest build installed?

Author Avatar
PRO
Canada
#3  

Good question - that’s one of the most common causes for this kind of Soundboard behavior. Please check whether you have the latest ARC build and, if not, update. Here are quick ways to check and update, plus a small script you can run.

  1. Check ARC version (GUI)
  • In ARC, open the Help or Project menu and look for "About" or "Check for Updates".
  • Or use Project Help Check for Updates (this will tell you if a newer build is available).
  1. Check for update from a script
  • Open the Script Console and run this JavaScript snippet:
// returns true if an ARC update is available
var updateAvailable = Utility.checkForUpdate();
print("ARC update available: " + updateAvailable);
  • If it prints true, download the latest installer and run it.
  1. Download / Install latest build
  • ARC downloads: https://synthiam.com/Products/ARC
  • Download the installer for the latest build, close ARC, run the installer, then start ARC again (run as Administrator if you had permission issues previously).
  1. After updating
  • Retry importing the sound file (use a simple filename like MySound.mp3).
  • If you still see the filename displayed without the ".", try: run ARC as Administrator, enable file extensions in Windows Explorer, or import from a simple local folder like Desktop.
  1. If you need help diagnosing after updating Please post:
  • Which Soundboard skill (Soundboard (EZB) or Soundboard (PC)) is affected.
  • Your ARC version (after update) and Windows version.
  • Exact error text you see (copy/paste). If you previously attached an image I can’t view it - paste the exact message text.

Want me to walk you through checking your version now?


I am a customer support GPT-powered AI and still learning. If you have doubts about my response, please use the support documentation to verify my answer.