Skip to content
Craft Wiki

Troubleshooting

If SoundCraft flashes in Task Manager and quits before its window appears, your graphics driver may be the cause. SoundCraft uses DirectX 12 on Windows. Start it with Vulkan instead. In PowerShell, from the folder that contains soundcraft.exe:

Terminal window
$env:WGPU_BACKEND = "vulkan"
& .\soundcraft.exe
Remove-Item Env:WGPU_BACKEND # go back to the default for later launches

Don’t try "gl": on some AMD drivers, OpenGL is what crashes in the first place.

Older versions could close at start with “Parent device is lost” in the log. Current versions avoid this, so update first. If it still happens, start SoundCraft with WGPU_BACKEND set to "vulkan", as above.

  1. Choose Setup › Playback Engine. Under Output, it shows the device SoundCraft is playing through.
  2. If it says no device (silent clock), or the wrong device, choose the Output device you want and press Apply. Press Refresh devices if you’ve just plugged in an interface.
  3. If sound stops after a device change or sleep, press Reconnect audio device.

In the web version, browsers only start sound after you click on the page, so click once and press Space again.

On Linux, SoundCraft plays through ALSA, which reaches PipeWire or PulseAudio on most desktops. It doesn’t use JACK.

  • Turn on the record button of at least one track first. If none is on, SoundCraft shows a hint under the record button.
  • Check the Input device in Setup › Playback Engine.
  • On a Mac, SoundCraft needs permission to use the microphone. If you said no, allow it in System Settings › Privacy & Security › Microphone.
  • Recording isn’t supported on FreeBSD or in the web version yet.

SoundCraft looks for CLAP and VST3 plugins in the standard folders for your system, and for Audio Units on a Mac. To add another folder, set the CLAP_PATH or VST3_PATH environment variable before starting SoundCraft.

  • Mac: the signed app may refuse to load third-party plugins, because macOS only lets it load code it trusts.
  • Linux Flatpak: the sandbox sees only plugins in ~/.clap and ~/.vst3, and Flatpak plugin extensions. Plugins installed in /usr/lib aren’t visible to it; use another package if you need them.

If SoundCraft can’t find some of a session’s audio files, it opens the session without them. Choose SoundCraft › Session Audio Health to see which audio isn’t loaded, and how to fix it. Keep a session’s Audio Files folder next to its .scraft file when you move or copy it.

On a Wayland desktop, SoundCraft runs through XWayland by default, because that’s the only way dragging files into the window works. To use native Wayland instead, start it with SOUNDCRAFT_WAYLAND=1. Dragging files in won’t work while it does; use File › Import instead.

Open SoundCraft again. If it kept a copy of unsaved work, it shows Recover Unsaved Work, with how long ago it was saved. Press Recover to get it back, or Discard to throw it away. If a recording was still running, the copy includes it.

SoundCraft writes a log you can attach to a bug report. It records audio devices that failed to open, plugins that refused their saved settings, files that failed to open, and crashes.

System Log folder
Windows %APPDATA%\SoundCraft\logs\
macOS ~/Library/Application Support/SoundCraft/logs/
Linux and FreeBSD ~/.config/soundcraft/logs/
Linux Flatpak ~/.var/app/ai.storyteller.soundcraft/config/soundcraft/logs/

The current log is soundcraft.log. The log from the run before is soundcraft.1.log, so if SoundCraft crashed, attach that one too.

The folder above logs is SoundCraft’s settings folder. It also holds autosaves and your plugin presets. With the portable zip and a portable.txt file, it’s the SoundCraftData folder next to the app.

  • Large sessions can run out of memory, because every audio file is loaded fully into RAM: #1403.
  • Saving a session fails on Bazzite Linux: #1405.
  • Opening a session fails on macOS: #1340.
  • Setup › Preferences doesn’t open for some people: #1413.
  • No sound in the Linux snap: #1366.
  • VST3 plugins aren’t found and Audio Units don’t open: #1387.
  • CLAP plugins fail to load: #1331.
  • A VST3 instrument can use every processor core after you stop playback on Windows: #1358.
  • Time stretch does nothing: #1404.
  • Playlists can’t be soloed, and you can’t move parts of one to the main playlist: #1253.