NAMper DOCUMENTATION ← ALL DOCS
09 · SETTINGS REFERENCE

Every switch, in order.

NAMper's Settings sheet is short on purpose. This page walks it card by card, row by row, with the defaults and what each control really does — and ends with the handful of settings that live somewhere else entirely.

09.1Opening Settings

Tap the gear icon in the header of the Rig tab. That is the only way in, and the header only exists on that tab — from Loop, Sample, Perform or Mix you go back to Rig first.

Settings is an index rather than one long sheet: a row for About and six pages, one tap each, so the thing you came for is on a page about that thing. One choice stays on the index itself, under FACTORY PRESETS: Built-in amps, TONE3000 captures or HyperReal (the chip with the HyperReal mark, and the default) — which amps the factory bank plays; see HyperReal in the factory bank. When the processor cannot carry HyperReal, the bank steps back to the built-in amps and this choice shows it. There is no TONE3000 page — signing in happens in the block that wants a capture.

PageWhat is on it
About Version, the tip jar, credits, and HELP & LINKS — the documentation, the website, the Telegram community, support and the privacy policy.
Audio Interface, sample rate, buffer, input trims — below, with the channel names.
Control MIDI and input triggers, mapped to anything — its own page: MIDI & control.
Stage The click, the set tempo and key, the lyrics text size and whether the words open themselves, and the looper's auto-loop levels — Set, Lyrics, Metronome and Looper below.
Appearance Light, dark, or whatever the system says, and the themes — below.
Prompts & tour Launch prompts and the quick tour — below.
Troubleshooting The engine log and the factory resets — Reset and Diagnostics below.
The Settings index: the About row, the pages from Audio to Troubleshooting, and the FACTORY PRESETS card with three chips, the HyperReal one picked.
The top of the Settings sheet

The gear has company in that header row, and it is worth knowing what the neighbours do:

ItemDoes
The NAMper wordmark Opens the About sheet — version, the tip jar, credits, and the HELP & LINKS card with the documentation, the website, the Telegram community, support and the privacy policy. The About row at the top of Settings opens the same sheet.
DSP load chip How close NAMper's busiest real-time thread is to its deadline, as a percentage — the same number as the DSP load row on the Audio page, which spells it out; — when stopped. Green under 60 %, amber to 85 %, red above.
GearSettings — this page.
KEY chip The current key, or the word KEY when unset. Opens SET KEY.
Metronome chip Tap to switch the click on and off; long-press for the SET TEMPO sheet. See the looper.
Tuning forkOpens the tuner. See MIDI & control.
Power Starts and stops the audio engine. Nothing makes a sound until it is on. See getting started.

09.2Audio interface

The AUDIO INTERFACE card is the longest one, and the only one whose settings need a relaunch to take effect. The first four rows are read-only: they tell you what NAMper actually got from the system, which is the fastest way to find out why an interface is not behaving. On a Mac the same page also chooses the interface — the input and output devices, the output pair — see Mac. If the interface drops out, the engine pauses and starts again by itself when it comes back, at the same settings and with the loops kept; meanwhile an iPhone or iPad stays silent, a Mac plays through the system's device and an Android phone through its own.

The top of the Audio page: the interface rows, the feedback guard, the DSP load bar with three lines of text under it, then the sample rate, input channel and buffer chips and the input trims.
DSP load in words: the headroom, NAMper's share of the processor, each real-time thread
RowControlDefaultWhat it does
Sample rateRead-only— The rate the engine is actually running at, in kHz.
InputsRead-only— How many input channels the current route offers, up to eight.
OutputsRead-only— How many output channels the current route offers.
EngineRead-only— running or stopped.
Feedback guardSwitchOn Mutes the output while the built-in mic plays through the phone's own speaker. Read this one properly.
DSP loadReadout + bar— The header chip's number, shown only while the engine runs, and under its bar in words: the headroom before dropouts, naming the busiest real-time thread (or that it is missing its deadline — expect dropouts); NAMper's share of one core and of the whole device; and, small, each real-time thread against its own deadline.
Sample rateChips: Auto, 44.1k, 48k, 88.2k, 96k, 176.4k, 192kAuto Sets the engine rate; remembered per route. Changing it restarts the engine. On Android the chips are Auto, 44.1k, 48k and 96k. More.
Input channelsChips: Auto, 1…nAuto Caps how many input channels NAMper opens. Leave on Auto unless you have a reason.
BufferChips: 64, 128, 256, 512128 Block size, with a live frames · ms readout. The only latency control there is. On Android the chips are multiples of the interface's burst. More.
Input trimOne slider per input, −12…+24 dB0 dB Gain for interfaces without a gain knob. Play hard: the IN meter should reach its top third.
Use all interface outputsSwitchOff Opens every output pair, so a branch, a rig or the click can own its own pair. Stereo devices do not need it.
Lite NAM modelsSwitchOff TONE3000's A2 captures carry a lighter sub-model; this runs every capture on it — a fraction of the DSP load, a shade less detail. Captures without one are unaffected. Takes effect at once.
Amp modeler on its own threadSwitchOn A HyperReal amp runs on a processor core of its own, two buffers behind the audio: room for several amps at once, for those two buffers of extra latency. If the thread cannot keep up, the amp goes back to the audio thread by itself. Switching it reloads the amps that play. iPhone, iPad and Android; the Mac and the plug-ins have no such switch.
Amp modeler qualityChips: Live, StudioLive; Studio on the Mac How finely a HyperReal amp is computed: Live is lighter on the processor, Studio finer and heavier. A change recompiles the amps that play, with no restart. If a Studio amp keeps the busiest thread past its deadline for two seconds, the amps run in Live and the row reads Studio (running Live: this device cannot keep up) until you pick a quality again. The plug-ins have no such row.
Tails on a switchSwitchOn The blocks a preset switch leaves behind ring out — a delay's repeats, a reverb's decay — for up to eight seconds instead of stopping at the switch, and a delay, reverb, FX loop or plugin that a scene bypasses rings out over the dry (a freeze is held sound, not a tail: it stops). A little more DSP for those seconds.
Align the rigsSwitchOff Rigs on different inputs are delayed to the slowest of them where the desk sums them, so a guitar and a mic land together. Off, each rig keeps its own latency; the paths of one input always line up either way.
Further down the Audio page: the switches for the interface outputs, the Lite NAM models and the stereo amp, the amp modeler's own thread switched on, its quality chips on Live, then the tails, rig alignment, echo cancelling and sleep settings.
Amp modeler on its own thread and Amp modeler quality: Live or Studio
Audio changes need a relaunch

The chips and switches here take effect on the next engine start — some, like the sample rate, restart the engine themselves. If something looks stuck, power the engine off and on before assuming it is broken.

09.3Channel names

CHANNEL NAMES is a text field per input, each row prefixed In 1, In 2 and so on, with the placeholder Guitar, Vocal…. The footnote says what they are for: Input pickers show these names everywhere.

Name them once and those names appear in every input picker in the app — rig inputs, looper track sources, compressor sidechains, the input trim sliders. Channels you leave blank fall back to In <n>.

Worth two minutes

On a multichannel interface, Guitar and Vocal are much easier to pick correctly mid-soundcheck than In 3 and In 4.

09.4Appearance

Chips: System, Light, Dark. The default is System, and appearance changes apply the instant you tap them.

Under the chips are the themes, one choice per polarity: pick a dark theme and a light one, and System wears the dark one when the phone is dark and the light one when it is not. Four dark themes ship — Studio (the app's own), Midnight Violet, Ember and Deep Sea — and three light ones: Concrete, the default, a light grey a shade down from paper; Desk, the paper-white the app first shipped with; and Linen.

The Rig tab in the Concrete light theme: a light grey page, white cards and the chain's tiles in their family colours.
Concrete, the light theme NAMper starts on

Customize colors… copies whatever theme is worn into your own and lets you set each role by hand — the background, the cards, the text, the knobs, the power button and every block family's accent. Corner radius in the same editor scales every rounded corner in the app at once, from sharp (30 %) to very round (200 %); the themes ship at 50 %. A reset row puts your copy back to the theme it came from.

09.5Set

The SET card is read-only. It shows Tempo (as BPM, or — when nothing is set) and Key (such as Am, or —). It is a status readout, not a control.

The footnote points you at the real controls: Tempo: long-press the metronome. Key: the KEY button in the header.

ValueSet it from
TempoLong-press the metronome chip in the Rig header, or the tempo block in the Loop tab. The looper also detects it from your first loop, and selecting a backing track applies the song's tempo.
KeyThe KEY chip in the Rig header. Selecting a backing track applies the song's key.

09.6Lyrics

One slider: teleprompter text size, from 16 to 34 pt, default 22 pt, with a live preview line reading This is how your lyrics will look.

Under it, Open the lyrics with the song: on, the teleprompter takes the screen when a song with lyrics starts; off, the tab you were on stays where it is and the Lyrics button opens the words when you want them. On by default.

Changing it re-aims the teleprompter live, so if the lyrics screen is open on another device or you come straight back to it, nothing has to be re-timed. Set it for the distance the phone actually sits from your face on a mic stand, not from the sofa. See lyrics and the teleprompter.

09.7Metronome

RowControlDefaultWhat it does
Click levelSlider, −40…+6 dB≈ −3 dB How loud the click is.
Click outputMenu: Main, then each output pair by the names the interface's driver gives its channels (3 / 4 when it gives none)Main Which hardware output pair carries the click. Shown only when there is more than one pair; picking a non-main pair force-enables Use all interface outputs.
Click channelChips: L+R, L, R (on another pair, its channel numbers)L+R Both channels of the pair, or one of them: a mono click into a single output, the other left for the mix.

The card's footnote is the useful part: The click is mixed in AFTER the master FX chain — reverbs and limiters never touch it. Pick a separate output pair for in-ear monitoring, and a single channel when the click shares the pack with the mix.

That means your master reverb will not smear the click and your master limiter will not duck the band every time it ticks. Send it to its own pair and the drummer hears the click while front of house does not.

The click itself is switched on and off with the metronome chip in the Rig header, or the CLICK chip in the Loop tab — not from here.

09.8Looper

The LOOPER card on the Stage page tunes the looper's AUTO mode.

RowControlDefaultWhat it does
Silence that closes an auto-loopSlider, 0.5–4 beats1 beat How long the quiet after a phrase must last, in beats of the tempo heard in your playing, before the take closes itself. Longer for phrases with gaps, shorter for tight ones.
Signal that starts an auto-loopSlider, −54…−24 dB−40 dB The level your playing has to stay over for a couple of milliseconds before an armed cell starts recording. Lower is more sensitive; a brush of the strings or the room stays under it.
Keep time through the silenceSwitchOn The loop starts playing where it would be had it never stopped, so the count never breaks. Off, it starts from the top when it closes.

09.9Prompts

RowControlDefaultWhat it does
Show the support promptSwitchOn The sheet that explains NAMper is free and points at the tip jar. It reappears occasionally from the third launch onward; switch this off and it never returns.
Offer TONE3000 sign-in on launchSwitchOn The sheet offering to connect your TONE3000 account so factory presets can download their real amp captures. It appears once per launch while you are signed out.
Replay the quick tourButton— Runs the seven-step first-run tour again.

The quick tour is a spotlight over the live Rig tab, counted n/7, and it is hands-on rather than a slideshow: it walks you through the amp card, the signal chain (you really tap a block), the block editor, presets, the other tabs and a closing step. Next, Skip step and End tour are always available, with Finish at the end. It runs on the Rig tab only.

09.10Reset

Two buttons, each behind a confirmation.

ButtonDialogConfirm
Reset to factory presets Delete ALL user presets? The four factory rigs come back. Delete all user presets
Reset all settings Reset every setting (audio, looper, MIDI map, appearance) to defaults? Presets and files stay. Restart the app afterwards. Reset settings

The first one wipes your rig presets and restores the four factory rigs. The second leaves every preset and every file alone and only puts the settings back to their defaults.

Restart after a settings reset

The footnote reads Settings reset takes effect after an app restart., and it means it. Only the appearance change applies immediately — the audio settings need a relaunch before they are truly back at their defaults. Quit NAMper from the app switcher and open it again.

09.11Diagnostics

NAMper keeps a plain-text engine log recording interface routing and peaks. When one exists, this card offers Share engine log and Clear engine log; when it does not, it reads No engine log yet (it records interface routing and peaks).

Share engine log hands the file to the system share sheet — mail it, AirDrop it, or attach it to a support issue. It is the single most useful thing you can include in a bug report about an interface that will not open, a rate that gets refused or an engine that stops on its own, because it records what actually happened at the audio layer.

Clear engine log empties it. Do that immediately before reproducing a problem and the log you send contains that problem and nothing else.

09.12Not in Settings

Three things people look for here and do not find.

Trigger quantize

The QUANT knob and its grid chip live in the Sample tab header, not in Settings — even though both are global rather than per kit or per pad. See trigger quantize.

Tempo and key

Both are header chips on the Rig tab. Settings only reports them, in the SET card.

MIDI

There are no global MIDI settings at all: no channel selector, no program-change toggle, no clock sync. MIDI in NAMper is omni and always on — every channel is accepted, every source connects automatically, and the app publishes its own virtual destination named NAMper.

Nothing to configure

If a pedal is not doing anything, the problem is the mapping rather than a setting. Everything MIDI lives on the Control page of Settings — see MIDI & control.