View source for Pad Player

= Tonic Pad =

Tonic Pad is a quick button that plays an ambient drone matched to the key of the song you're viewing. There's no separate pad library screen — everything, from turning the pad on to picking a sound and shaping it, happens directly on the quick button itself.

* '''Off''' — tap to start the pad; it plays retuned to the current song's key.
* '''On''' — the pad is currently playing; tap again to stop it.
* '''Disabled''' — no pad sound is available for this song (this shouldn't normally happen, since a built-in pad is always available as the default).

While a setlist is running, the pad automatically crossfades to match each new song's key, and keeps playing uninterrupted across songs that share the same key.

== Enabling the quick button ==

# Open '''Settings''' and go to '''Quick Buttons'''.
# Add '''Tonic Pad''' to your quick button bar.

Tonic Pad can also be triggered remotely, for example from a Bluetooth pedal or MIDI controller. It isn't available when running JustChords as an Audio Unit (AUv3) plug-in.

== Picking a sound and shaping it ==

'''Tap and hold''' the Tonic Pad quick button. Instead of opening a separate screen, the button expands in place into a small panel:

; Sound picker
: At the top, a menu lists the available pad sounds — the built-in '''JC Warm Pad''' (the default) and '''JC Organ Pad''', plus any sounds you've imported yourself. Picking one sets the pad sound '''for this song specifically''', overriding the default. If a pad is already playing, it crossfades into the newly picked sound right away.

; Live sound controls
: '''Volume''', '''Crossfade''' (fade length between songs/loops), '''Low Pass''', '''High Pass''' and '''Pan'''. These apply instantly — even while the pad is playing — and are saved as your general Tonic Pad settings, used for every song rather than per song.

Tap anywhere outside the panel, or tap the button again, to collapse it back to the normal quick button.

== Importing your own pad sounds ==

Built-in pads cover the basics, but you can bring your own recordings (for example a commercial pack like Churchfront Pads, or your own ambient drones):

# Tap and hold the Tonic Pad quick button, then choose '''Manage''' from the sound picker menu.
# Tap the '''+''' button.
# Choose an audio file from Files (mp3 and most other common audio formats are supported).
# JustChords tries to detect the '''name''' and '''key''' from the filename automatically.
# Review and adjust the name or key if needed, then tap '''Save'''.

From the same '''Manage''' screen you can also rename or delete pads you've imported (swipe or use the context menu). Built-in pads can't be edited or deleted.

== How pitch matching works ==

* By default, Tonic Pad uses the built-in '''JC Warm Pad''' and retunes it in real time to match the song's key — including any transposition or capo you've applied — up to a tritone (6 semitones) in either direction.
* If you'd rather use a specific pad for a song regardless of key, pick it from the sound picker as described above; JustChords will retune that pad the same way.
* Because of this real-time retuning, a single pad recording can back a song in any key. Importing recordings closer to a song's actual key still gives the cleanest sound, since less pitch-shifting means less audible artifacting — but it's not required.

== Looking ahead ==

Tonic Pad is intentionally kept simple today — one drone per song. It's built on top of a general-purpose pad architecture designed to grow beyond that, for example playing pads that follow a song's chord progression rather than just its tonic.