> ## 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 > Reference for all settings in Meiji Sampler, organized by tab. # 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). ### Sidebar | 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 * [Keyboard Shortcuts](/reference/keyboard-shortcuts) * [File And Project Management](/guides/file-and-project-management) * [Storage Paths And Project Structure](/reference/storage-paths-and-project-structure) * [Modes And States](/reference/modes-and-states)