Skip to main content

​
Installation and system requirements

​
Platform support

  • Meiji Sampler officially supports macOS, Linux, and Windows.
  • macOS is the primary supported platform and is the most stable day to day.
  • Windows and Linux are official targets as well; on Linux, stability can still depend on your audio backend and terminal setup.

​
macOS install

The strongly recommended install method is the DMG from sampler.meiji.industries. It installs one Meiji Sampler.app with the sampler engine, both supported macOS renderers, and automatic updates. There is no separate terminal app to install or manage. SwiftTerm is the default renderer and supports macOS 11 or later. On macOS 13 or later, open Meiji Sampler > Settings… and choose Ghostty to try the bundled GPU-accelerated renderer. Return to the same setting to choose SwiftTerm, so the fallback stays inside the same app and update channel. To review licenses and notices for software bundled with either renderer, open Meiji Sampler > Acknowledgements…. For terminal purists who want to run Meiji Sampler inside their own terminal, use the curl installer instead:

​
Linux install

Linux is supported, but you should expect more manual setup around audio host, devices, and latency. Use a modern terminal, verify your output device, and be prepared to try a different backend if low-latency playback is unstable.

​
Windows install

Download the EXE installer from sampler.meiji.industries, or install via curl in PowerShell:

​
What gets installed

Meiji Sampler stores state and configuration in your user directories.
  • macOS session state: ~/Library/Application Support/Meiji Sampler/state.json
  • macOS settings: ~/Library/Application Support/Meiji Sampler/config.json
  • macOS projects: ~/Documents/Meiji Sampler/Projects/
On Linux, state and settings live under ~/.config/meiji-sampler/. On Windows, state and settings live under %APPDATA%\Meiji Sampler\, and projects under Documents\Meiji Sampler\Projects\. Updating, rolling back, or uninstalling the macOS application replaces or removes only Meiji Sampler.app. Packs, recordings, exports, settings, and preferences remain in their user directories unless you explicitly remove them. See Storage Paths before deleting app data.

​
Next step

Continue to Terminal Compatibility or go straight to Audio Setup.