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; view storage paths |
| Tempo | Change the effective project playback tempo without changing pitch |
| Sources | Browse connected audio sources and view availability details |
| Audio | Output device, buffer, sample rate, quantization defaults, MIDI |
| MIDI | MIDI mapping and MIDI monitor |
| 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) |
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 |
Tempo category
The Tempo category holds the project playback tempo editor. Meiji Sampler infers the session BPM from the first recorded loop; this category lets you override that effective tempo without changing pitch.
| Field | What it does |
|---|
| 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 |
| Range | Choose the eligible first-loop BPM range: 65-135, 87-175, 133-300, or None. Out-of-range first-loop detections are doubled or halved into the selected range. |
| Metronome | Turn the metronome click on or off. Press [M] from the main app to open the same controls in a dedicated dialog with a right-side pulse that expands on accented beats. [SPACE] still controls transport from this dialog. |
| Count In | Choose when the metronome count-in runs: OFF, REC, PLAY, or REC + PLAY. |
| Count Beats | Set count-in length from 1 BEAT to 8 BEATS. Default: 4 BEATS. |
| Click | Choose when the click plays: OFF, PLAY, REC, or REC + PLAY. |
| Rate | Choose click subdivision: 1/4, 1/8, 1/16, 1/8T, or 1/16T. |
| Volume | Set click level from 0% to 100%. |
| Accent | Turn the downbeat accent on or off. |
| First Loop | When project BPM is set before recording, choose the fixed first-loop length: AUTO, 1 BAR, 2 BARS, 4 BARS, 8 BARS, 16 BARS, 24 BARS, or 32 BARS. Fixed lengths stop the first recording automatically at the selected bar boundary; the loop details view shows the full selected length with a moving playhead while recording. Pressing [ENTER] early ends the take, keeps the loop at the selected length, and queues overdub as OVR+ until the next fixed interval. |
The Tempo editor requires at least one recorded loop to establish a timing source unless you set BPM manually first. Until then the page shows Awaiting 1st loop. Range is available before recording and applies the next time a first loop establishes project tempo. Pressing [R] before the first loop opens First Loop Setup, which defaults to Fixed mode at 90.00 BPM, Quantize OFF, 1 BAR Length, 4 BEATS Count-in, and click REC + PLAY; Fixed mode stops recording automatically at the selected Length, and [ENTER] can end the take early without shortening the loop or starting playback before the fixed interval arrives. Select Mode: AUTO TEMPO when you want the completed take to define tempo by its ending; Auto keeps Length as AUTO while still applying the dialog’s Quantize, Count-in, and Click choices, then continues directly into overdub. Press [ESC] to cancel without arming. A pad or chop key that starts a record count-in plays immediately. Hits during the final count-in beat are recorded at 0:00; earlier hits are consumed as unrecorded start-signal updates when REC begins. The metronome click is routed outside bounce, resample, and internal capture paths, so it guides recording without printing into the sampled audio.
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 |
| Stereo Channels | Adjacent stereo channel pairs supported by the output device, such as Ch 1 & 2 or Ch 9 & 10 | Ch 1 & 2 |
| Buffer Size | 64, 128, 256, 512, 1024, shown with calculated latency such as 256 samples (5.80 ms) at 44100 Hz | 256 |
| Sample Rate | 44100 Hz, 48000 Hz, 88200 Hz, 96000 Hz | 44100 Hz |
| Stretch Loops on Load | ON / OFF. When ON, a loaded pad whose effective Loop setting is on automatically receives the best-fit Sync value once a session clock exists. Turning it on also applies Sync to loaded loop pads that are ready. | ON |
Smaller buffers reduce latency and increase CPU sensitivity. The millisecond value is calculated from the selected buffer size and sample rate. Audio host, output device, Stereo Channels, buffer size, and sample rate changes are saved immediately, then prompt you when you exit Settings to [Apply Now] or keep the current engine running until [Next Launch]. Stretch Loops on Load affects pad loop setup only; it does not restart the audio engine.
Quantization section
| Field | Values | Default |
|---|
| Default Amount | OFF, then 5% to 100% | OFF |
| 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. On Windows installer builds, available updates open the native WinSparkle dialog. |
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