Skip to main content

​
Performance and system problems

​
The UI feels wrong or shortcuts misbehave

Start by checking the terminal. Many apparent app issues are really terminal capability problems, especially when colors look wrong, layout feels broken, or shortcuts behave inconsistently. Go to:

​
Changes do not persist after restart

If settings, MIDI mappings, or PerformFX changes disappear, suspect a config save failure or a directory-permission problem in the app config path. Also verify that you are not confusing background session state with an explicitly saved project.

​
PerformFX A/B feedback does not export

PerformFX A/B feedback exports to the app data directory under PerformFX/feedback/. If [SHIFT+S] reports that feedback could not be exported, check that Meiji Sampler can write to its app data directory and that the disk is not full.

​
The app became unstable after an update

Check: Look specifically for:
  • persistence changes
  • path migrations
  • terminal compatibility fixes
  • platform-specific regressions

​
Windows shows an update, but the updater dialog does not open

Install the latest Windows build from sampler.meiji.industries once, then use Settings → About → Updates for future updates. Older Windows builds could detect a newer version in Settings while the native WinSparkle feed rejected the same update. Current installer builds use a Windows-specific update feed and open the native updater dialog from the Updates row.

​
Background processing feels heavy

Features such as stem separation, export, and video generation can increase load. Let long-running tasks finish before judging general UI performance. If the app only feels slow during those operations, the slowdown may be workload-related rather than a general regression.

​
Stems Addon download fails

Stem separation uses a separate Stems Addon download. If the install fails immediately with an unavailable platform, missing bundle, or checksum message, the published add-on package for your platform is missing or cannot be verified. You can keep using Meiji Sampler without stem separation. Retry after updating to a release that includes a verified add-on bundle for your platform. If the message mentions a network failure instead, check your connection and retry from Settings → Addons.

​
Audio is fine, but the interface feels sluggish

Check:
  • whether stem separation, stretching, or export is running in the background
  • whether the terminal itself is the bottleneck
  • whether another app is heavily loading CPU, GPU, or disk

​
Fastest triage order

  1. Check terminal compatibility.
  2. Check whether a background task is still running.
  3. Check release notes for recent platform-specific changes.
  4. Check config and project paths if persistence is involved.