Official sound packs repository and creator guide for LeanType Keyboard.

Creating and importing your own custom sound pack into LeanType is fast and simple.

Copy the template folder templates/starter-pack to a new folder:

cp -r templates/starter-pack packs/my_sound_pack

Place short .ogg or .wav audio files in packs/my_sound_pack/audio/:

packs/my_sound_pack/
  ├── pack.json
  ├── license.txt
  └── audio/
      ├── keypress_default_1.ogg
      ├── keypress_default_2.ogg
      ├── space.ogg
      ├── delete.ogg
      └── return.ogg

Open pack.json and configure your metadata and sound events:

{
  "schemaVersion": 1,
  "id": "dev.leantype.sounds.my_pack",
  "name": "My Custom Keyboard Sounds",
  "summary": "Crisp tactile clicks with custom spacebar",
  "versionCode": 1,
  "versionName": "1.0.0",
  "author": "Your Name",
  "license": "CC0-1.0",
  "defaultMasterVolume": 0.85,
  "preview": "audio/keypress_default_1.ogg",
  "sounds": {
    "keypress.default": {
      "files": [
        "audio/keypress_default_1.ogg",
        "audio/keypress_default_2.ogg"
      ],
      "mode": "random",
      "volume": 1.0
    },
    "keypress.space": {
      "files": ["audio/space.ogg"],
      "mode": "single",
      "volume": 1.0
    },
    "keypress.delete": {
      "files": ["audio/delete.ogg"],
      "mode": "single",
      "volume": 0.95
    },
    "keypress.return": {
      "files": ["audio/return.ogg"],
      "mode": "single",
      "volume": 0.95
    }
  }
}

• "single": Plays the first audio file.
• "random": Picks randomly among the listed audio files for natural variation.
• "cycle": Plays the listed audio files in round-robin order.

• keypress.default: Used for standard letters and numbers.
• keypress.space: Spacebar key (falls back to keypress.default if omitted).
• keypress.delete: Backspace key (falls back to keypress.default if omitted).
• keypress.return: Enter / Return key (falls back to keypress.default if omitted).
• keypress.shift: Shift / Caps Lock key (falls back to keypress.default if omitted).
• keypress.symbol: Symbol / 123 switch key (falls back to keypress.default if omitted).

Validate your pack structure and create the .zip:

python tools/validate_pack.py packs/my_sound_pack
python tools/package_pack.py packs/my_sound_pack dist/my_sound_pack.zip

If you only have a single .ogg, .wav, or .mp3 audio clip (like a single click or pop):

1. Transfer the audio file to your phone.
2. In LeanType:
   • Open Settings → Plugins & Capabilities → Keypress Audio & Sound Packs.
   • Tap Sound Style → Import .zip.
   • Select your .ogg, .wav, or .mp3 file.
3. LeanType will automatically package it as a custom profile with instant playback!

You can synthesize sound packs from scratch using pure mathematics, digital signal processing (DSP), and physical modeling in Python without needing physical audio recordings.

pip install numpy scipy soundfile

In tools/generate_all_soundpacks.py, define a sound builder function using the built-in DSP primitives:

• tone(duration, f0, f1, wave='sine'|'triangle'|'square'): Generates frequency sweeps and waveforms.
• decay_env(duration, tau, attack_s): Generates exponential acoustic decay envelopes.
• _modal_layers(duration, base_freq, ratios, gains, taus): Additive acoustic resonance model.
• _ks_pluck(rng, freq, duration, brightness): Karplus-Strong physical plucked-string model.
• lowpass(), highpass(), bandpass(): Digital Butterworth / SOS filtering.
• finalize(audio, target_db=-2.0): Peak normalizes (-2 dBFS), removes DC bias, and applies micro anti-pop fades.

Example:

def build_custom_clack(rng: np.random.Generator) -> Dict[str, Dict]:
    def hit(freq: float, duration: float) -> np.ndarray:
        body = tone(duration, freq, freq * 0.85) * decay_env(duration, 0.02)
        click = bandpass(noise(rng, 0.005), 1500.0, 4500.0) * decay_env(0.005, 0.002)
        return finalize(mix([(body, 0.8), (click, 0.4)]))

    return {
        "keypress.default": ev([hit(300.0, 0.06), hit(320.0, 0.06)], "random"),
        "keypress.space": ev([hit(150.0, 0.10)], "single"),
        "keypress.delete": ev([hit(500.0, 0.04)], "single"),
        "keypress.return": ev([hit(220.0, 0.08)], "single"),
    }

Add your PackSpec to the PACKS list:

PackSpec(
    slug="my-custom-sound",
    name="My Custom Sound",
    summary="Algorithmic mechanical clack.",
    tags=["custom", "procedural"],
    builder=build_custom_clack,
)

Generate the sound pack .zip, previews, and index.json:

python tools/generate_all_soundpacks.py --base-url https://raw.githubusercontent.com/YOUR_USER/LeanType-SoundPacks/main/dist

1. Transfer your .zip (or .ogg / .wav / .mp3) file to your phone (via USB, Downloads, Telegram, Google Drive, etc.).
2. Open LeanType Settings.
3. Go to Plugins & Capabilities → Keypress Audio & Sound Packs.
4. Tap Sound Style → Import .zip.
5. Select your .zip or audio file using the system file picker.
6. LeanType will validate, install, activate, and preview your sound pack immediately!

• Format: OGG Vorbis / Opus or WAV (Mono, 44.1 kHz or 48 kHz).
• Duration: 20 ms to 150 ms (keep them short for ultra-low latency).
• Attack: Zero leading silence at the start of the audio file for instant trigger response.
• Normalization: Peak normalized around -3 dB to -1 dB.
• File Size: Under 500 KB per audio variant, under 2 MB total pack size.

Looking for more custom sound packs, musical instruments, mechanical keyboard switch recordings, or community audio collections? Check out the active discussions and shared sound resources:

• 💬 LeanType Sound Repositories & Music Collections (Discussion #370) — Explore community sound packs, instrument samples, and audio sources.

Feel free to share your own custom packs or recommend audio repositories in that discussion!

Sound assets generated by LeanType Sound Lab in this repository are dedicated to the public domain under CC0 1.0 Universal.