> ## 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.

# Troubleshooting

> Find the symptom closest to your problem and work through the likely fixes.

# Troubleshooting

When Meiji Sampler feels wrong, start with the symptom that matches what you see or hear.

Most issues fall into one of a few buckets: audio setup, recording state, file paths, MIDI routing, or terminal and system behavior.

## Before you go deep

Do these quick checks first:

* confirm the relevant row, tab, or editor is actually focused
* confirm a modal or editor is not open and changing how shortcuts behave
* confirm the terminal, audio device, and project path are the ones you think they are

## In this section

* [Audio And Playback Problems](/troubleshooting/audio-and-playback)
* [Recording And Loop Problems](/troubleshooting/recording-and-loops)
* [File And Project Problems](/troubleshooting/files-and-projects)
* [Splice And Network Problems](/troubleshooting/splice-and-network)
* [MIDI And Sync Problems](/troubleshooting/midi-and-sync)
* [Performance And System Problems](/troubleshooting/performance-and-system)

## Still stuck?

Use [Error Messages](/reference/error-messages) for exact failure classes, then come back here once you know which subsystem is involved.