Skip to main content

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.
TabWhat it covers
ProjectSave, open, and manage projects; view storage paths
TempoChange the effective project playback tempo without changing pitch
SourcesBrowse connected audio sources and view availability details
AudioOutput device, buffer, sample rate, quantization defaults, MIDI
MIDIMIDI mapping and MIDI monitor
AddonsStem separation and factory sound packs
GeneralTutorial, 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

FieldWhat it does
Save ProjectQuick-save to the current file, or type a name for first save
Save AsSave a copy under a new name
Open ProjectBrowse recent projects inline with Up/Down, open with Enter, delete with D
New ProjectCreate 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.
FieldDefault path
Projects~/Documents/Meiji Sampler/Projects/
Recordings~/Music/Meiji Sampler/recordings/ (or ~/Meiji Sampler/recordings/ if no Music folder)
Bounces~/Documents/Meiji Sampler/Bounces/
PacksPlatform 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.
FieldWhat it does
TempoChange 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
RangeChoose 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.
MetronomeTurn 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 InChoose when the metronome count-in runs: OFF, REC, PLAY, or REC + PLAY.
Count BeatsSet count-in length from 1 BEAT to 8 BEATS. Default: 4 BEATS.
ClickChoose when the click plays: OFF, PLAY, REC, or REC + PLAY.
RateChoose click subdivision: 1/4, 1/8, 1/16, 1/8T, or 1/16T.
VolumeSet click level from 0% to 100%.
AccentTurn the downbeat accent on or off.
First LoopWhen 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

FieldValuesDefault
Audio HostAuto, ALSA, JACK (Linux only)Auto
Output DeviceSystem audio devices, or None for system defaultNone
Stereo ChannelsAdjacent stereo channel pairs supported by the output device, such as Ch 1 & 2 or Ch 9 & 10Ch 1 & 2
Buffer Size64, 128, 256, 512, 1024, shown with calculated latency such as 256 samples (5.80 ms) at 44100 Hz256
Sample Rate44100 Hz, 48000 Hz, 88200 Hz, 96000 Hz44100 Hz
Stretch Loops on LoadON / 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

FieldValuesDefault
Default AmountOFF, then 5% to 100%OFF
Default GridStandard subdivisions1/16

MIDI section

FieldValuesDefault
TransportEnabled / DisabledDisabled
When enabled, Meiji Sampler responds to MIDI transport messages (start, stop, continue).

Addons category

FieldDescription
StemsInstall or remove Demucs for stem separation. Shows Installed [REMOVE] or Available [INSTALL].
Factory PacksDownload or manage factory sound packs. Shows pack count when installed.

General category

Tutorial section

FieldDescription
ProgressShows completion percentage. Select and press Enter to restart the tutorial from the beginning.

Account section

FieldDescription
AccountShows current email when logged in. Press Enter to log in or log out.
AnalyticsEnabled / 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

FieldDescription
EncoderShows the detected hardware video encoder. Read-only.

About section

FieldDescription
VersionCurrent app version. Read-only.
KeyboardShows Extended (Kitty protocol) or Standard depending on terminal support. Read-only.
UpdatesCheck for updates or install an available update. On Windows installer builds, available updates open the native WinSparkle dialog.

Advanced section

FieldDescription
Factory ResetResets 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.
Settings has two focus zones: the sidebar (category list) and the content pane (fields).
KeyAction
Up / Down or K / JSwitch category
Enter or Right or LEnter content pane
EscReturn to the previous tab (settings are saved automatically)

Content pane

KeyAction
Up / Down or K / JMove between fields
Left / Right or H / LAdjust value, or go back from project picker
EnterConfirm action or open picker
Esc or HReturn 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