Documentation Index
Fetch the complete documentation index at: https://docs.sampler.meiji.industries/llms.txt
Use this file to discover all available pages before exploring further.
Settings
Open the Settings tab with , or by pressing Tab to cycle through tabs. Settings uses a two-pane layout: a sidebar listing categories on the left and a content pane showing fields on the right.
| Tab | What it covers |
|---|
| Project | Save, open, and manage projects; control playback tempo; view storage paths |
| Audio | Output device, buffer, sample rate, quantization defaults, MIDI |
| Addons | Stem separation and factory sound packs |
| General | Tutorial, account, video encoder, version info, factory reset |
Project category
The Project category is selected by default when you open Settings. It gives you inline access to all project operations without leaving the tab.
Project info
When a project has been saved, the tab shows:
- Name — the current project name, with a yellow dot when unsaved changes exist
- Location — the file path on disk (home directory shortened to
~)
When no project file exists yet, these fields are hidden and the Save field shows an inline text input for the project name.
Project actions
| Field | What it does |
|---|
| Save Project | Quick-save to the current file, or type a name for first save |
| Save As | Save a copy under a new name |
| Open Project | Browse recent projects inline with Up/Down, open with Enter, delete with D |
| New Project | Create a fresh empty project (confirms if unsaved changes exist) |
| Tempo | Change the effective project playback tempo without changing pitch; type a value or use arrows to nudge, tap Space rhythmically for tap tempo; apply with Enter, reset with R or Delete while editing |
Paths
The bottom of the Project category shows four directory shortcuts. Press Enter on any path to open it in your OS file manager.
| Field | Default path |
|---|
| Projects | ~/Documents/Meiji Sampler/Projects/ |
| Recordings | ~/Music/Meiji Sampler/recordings/ (or ~/Meiji Sampler/recordings/ if no Music folder) |
| Bounces | ~/Documents/Meiji Sampler/Bounces/ |
| Packs | Platform data directory, Packs/ subfolder |
Audio category
Audio section
| Field | Values | Default |
|---|
| Audio Host | Auto, ALSA, JACK (Linux only) | Auto |
| Output Device | System audio devices, or None for system default | None |
| Buffer Size | 64, 128, 256, 512, 1024 | 256 |
| Sample Rate | 44100 Hz, 48000 Hz, 88200 Hz, 96000 Hz | 44100 Hz |
Smaller buffers reduce latency and increase CPU sensitivity. Output device and audio host changes require an app restart.
Quantization section
| Field | Values | Default |
|---|
| Default Amount | 0% to 100% | 80% |
| Default Grid | Standard subdivisions | 1/16 |
MIDI section
| Field | Values | Default |
|---|
| Transport | Enabled / Disabled | Disabled |
When enabled, Meiji Sampler responds to MIDI transport messages (start, stop, continue).
Addons category
| Field | Description |
|---|
| Stems | Install or remove Demucs for stem separation. Shows Installed [REMOVE] or Available [INSTALL]. |
| Factory Packs | Download or manage factory sound packs. Shows pack count when installed. |
General category
Tutorial section
| Field | Description |
|---|
| Progress | Shows completion percentage. Select and press Enter to restart the tutorial from the beginning. |
Account section
| Field | Description |
|---|
| Account | Shows current email when logged in. Press Enter to log in or log out. |
| Analytics | Enabled / Disabled. Controls anonymous usage analytics. Default: Enabled. |
Analytics collects no audio data, no sample content, and no file paths. It can be disabled at any time.
Video section
| Field | Description |
|---|
| Encoder | Shows the detected hardware video encoder. Read-only. |
About section
| Field | Description |
|---|
| Version | Current app version. Read-only. |
| Keyboard | Shows Extended (Kitty protocol) or Standard depending on terminal support. Read-only. |
| Updates | Check for updates or install an available update. |
Advanced section
| Field | Description |
|---|
| Factory Reset | Resets all settings and state to defaults. Requires confirmation. |
Factory reset clears your local configuration and session state. Saved .meiji project files on disk are not deleted.
Navigation
Settings has two focus zones: the sidebar (category list) and the content pane (fields).
| Key | Action |
|---|
Up / Down or K / J | Switch category |
Enter or Right or L | Enter content pane |
Esc | Return to the previous tab (settings are saved automatically) |
Content pane
| Key | Action |
|---|
Up / Down or K / J | Move between fields |
Left / Right or H / L | Adjust value, or go back from project picker |
Enter | Confirm action or open picker |
Esc or H | Return to sidebar |
Configuration file path
Settings are stored at:
- macOS:
~/Library/Application Support/Meiji Sampler/config.json
- Linux:
~/.config/meiji-sampler/config.json
Related persisted files:
- session state:
state.json
- auth state:
auth.json
- stars:
stars.json
- projects:
~/Documents/Meiji Sampler/Projects/*.meiji
Related pages