Files
shawn 659e53766a fix(bass-presets): move factory presets to channel subdirs + per-channel install
Root cause: factory presets for bass (banks 17-20) sat in the root
factory dir alongside guitar presets, and install_factory_presets()
used rglob() which picked up ALL presets into the GUITAR channel.

Changes:
- Move bank_17-20 from presets/factory/ → presets/factory/bass/
  (matching the existing keys/, vocals/, backing_tracks/ layout)
- Fix install_factory_presets() to scan channel-specific subdirectory:
  GUITAR scans root bank_* dirs, all others scan <channel>/bank_*
- Fix main.py to iterate over all 5 channels when installing factory
  presets (was only installing into GUITAR)
- Import Channel enum in main.py

Tests: 56/56 preset manager tests pass. Integration verified:
- GUITAR: 68 presets (banks 0-16)
- BASS: 16 presets (banks 17-20, SansAmp/Darkglass/Ampeg SVT)
- KEYS: 12 presets (banks 21-23)
- VOCALS: 12 presets (banks 24-26)
- BACKING_TRACKS: 12 presets (banks 27-29)
2026-06-13 10:23:57 -04:00

455 lines
27 KiB
Markdown

# NAM Model & Cabinet IR Inventory
> **Generated:** 2026-06-13 (updated with Bank 7 — Bass, Orange, Others)
> **Source:** pelennor2170/NAM_models community collection on GitHub (GPL v3) + Tone3000 Supabase storage
> **Format:** Mix of WaveNet A1 and SlimmableContainer A2 models, verified JSON, all < 700 KB (feather class for RPi 4B)
## NAM Amp Models
### Bank 0 — Clean & Edge (Factory Presets 0-3)
| Preset | File | Size | Source Model | Notes |
|--------|------|------|-------------|-------|
| Clean Jazz | `Fender_TwinVerb_Clean.nam` | 399 KB | Fender Twin Reverb Normal Bright (sdatkinson) | Sparkling clean, slightly scooped mids |
| Edge of Breakup | `Magnatone_Super59_Pushed.nam` | 398 KB | Magnatone Super 59 Mkii Pushed (Tim R) | Bluesy breakup, dynamic touch response |
| Clean with Chorus | `Fender_TwinVerb_Vibrato.nam` | 399 KB | Fender Twin Vibrato Bright (Tim R) | Warmer clean, slight chorus character |
| Dynamic Fingerstyle | `Vox_AC15_TopBoost.nam` | 411 KB | Vox AC15 Top Boost (Phillipe P) | Chimey, complex mids, fingerstyle clarity |
| *Alternate: Clean* | `JCM2000_Clean.nam` | 398 KB | Marshall JCM2000 Clean (Tim R) | Crisp, tight clean — good for funk |
### Bank 1 — Drive & Lead (Factory Presets 4-7)
| Preset | File | Size | Source Model | Notes |
|--------|------|------|-------------|-------|
| Classic Rock | `Orange_Rockerverb.nam` | 398 KB | Orange Rockerverb (Tom C / Axe FX) | Thick midrange, classic rock crunch |
| Classic Rock | `JCM2000_Crunch.nam` | 398 KB | Marshall JCM2000 Crunch (Tim R) | Tight crunch, very responsive |
| Lead Solo | `5150_BlockLetter_Boosted.nam` | 397 KB | EVH 5150 Block Letter boosted (Helga B) | Searing leads, tight low end |
| Lead Solo | `Engl_Savage.nam` | 398 KB | ENGL Savage 120 (Tom C / Axe FX) | Modern high-gain, saturated sustain |
| Metal Rhythm | `6505_Red_NoBoost.nam` | 397 KB | Peavey 6505+ Red ch (Helga B) | Classic metal rhythm, aggressive mids |
| Metal Rhythm | `Splawn_ProMod_3rd.nam` | 397 KB | Splawn Pro Mod 3rd Gear (Tim R) | Tight percussive chug, modern metal |
| Ambient Wash | `Fender_TwinVerb_Clean.nam` | 399 KB | (reuse Clean Jazz) | Clean canvas for ambient FX chain |
| *Alternate: Lead* | `JCM900_Lead.nam` | 398 KB | JCM900 Dual Verb ch.A g6 (Tim R) | Smooth lead, 90s rock/metal |
### Pedal Captures (FX Bench & Boost/OD Blocks)
| File | Size | Source Model | Best For |
|------|------|-------------|----------|
| `Klon_Centaur_High.nam` | 397 KB | Klon Centaur-style (Keith B) | Clean boost, mid-hump overdrive |
| `TubeScreamer_Maxed.nam` | 195 KB | Ibanez TS808 Mini maxed (Tudor N) | Tubescreamer-style clean boost |
| `Mesa_MarkIV_Lead.nam` | 398 KB | Mesa Boogie Mark IV lead (Roman A) | Singing lead, thick harmonics |
| `Bogner_Ecstasy.nam` | 397 KB | Ceriatone Molecular 50 (Tudor N) | Bogner-style versatile overdrive |
### Feather Models (Ultra-low CPU — RPi 4B Optimized)
These are ~90 KB models with minimal CPU footprint, ideal for RPi 4B.
| File | Size | Source | Inference Cost (est.) |
|------|------|--------|----------------------|
| `BOSS_SD1_Feather.nam` | 90 KB | BOSS SD-1 overdrive (Phillipe P) | ~0.5 ms per 256-block |
| `MXR_M77_Feather.nam` | 91 KB | MXR M77 Badass OD (Phillipe P) | ~0.5 ms |
| `TS808_Feather.nam` | 90 KB | Maxon OD808 (Phillipe P) | ~0.5 ms |
| `Precision_Drive_Feather.nam` | 90 KB | Precision Drive (Phillipe P) | ~0.5 ms |
| `Friedman_PowerAmp_Feather.nam` | 90 KB | Friedman DSM EL84 (Sascha S) | ~0.5 ms |
### Bank 2 — Blues Captures (from Tone3000/ToneHunt)
| File | Size | Source | Type | Best For |
|------|------|--------|------|----------|
| `Fender_Princeton_Clone_Clean.nam` | 289 KB | Hand-Wired Princeton Clone Clean (A1) | Clean | Clean jazz, fingerstyle blues |
| `Fender_Princeton_Clone_EOB.nam` | 288 KB | Hand-Wired Princeton Clone EOB (A2) | Edge-of-Breakup | Dynamic blues, touch response |
| `Fender_Tweed_Dlx_Edge.nam` | 288 KB | Fender Tweed Deluxe The Edge w/ Celestion Blue (A2) | Edge-of-Breakup | Tweed-style pushed blues |
| `Fender_Twin_Reverb_Clean_A2.nam` | 290 KB | Fender Twin Reverb Clean (A2) | Clean | Sparkling blues clean |
| `TwoRock_JTM_Signature.nam` | 276 KB | Two-Rock John Mayer Signature Prototype (A1) | Clean/Edge | Blooming clean, Mayer-style |
| `Dumble_ODS_102_Rock_A1.nam` | 87 KB | Dumble ODS #102 Clone Rock setting (A1, feather) | Pushed OD | Smooth overdrive, SRV-style |
| `Dumble_ODS_102_Rock_A2.nam` | 289 KB | Dumble ODS #102 Clone Rock setting (A2) | Pushed OD | Smooth overdrive, SRV-style |
| `Marshall_Bluesbreaker_1962_A2.nam` | 289 KB | Marshall Bluesbreaker 1962 (A2) | Pushed Blues | Classic blues rock, Clapton-style |
| `Marshall_Bluesbreaker_Pedal.nam` | 290 KB | Marshall Bluesbreaker Pedal (Original) Setting 1 (A1) | Pedal OD | Pedal-based blues overdrive |
### Bank 3 — New Clean & Blues Captures (Tone3000 A2)
Downloaded from Tone3000 Supabase storage (public bucket). All are SlimmableContainer (A2) v0.7.0.
| File | Size | Source Model | Creator | Best For |
|------|------|-------------|---------|----------|
| `Fender_Deluxe_Reverb_A2.nam` | 650 KB | Fender Deluxe Reverb (A2) | sdatkinson | Sparkling clean, iconic Fender clean tone |
| `Roland_JC-120_A2.nam` | 289 KB | Roland JC-120 Jazz Chorus (A2) | tone3000 | Pristine clean, jazz chorus chorus effect |
| `Marshall_JMP50_Plexi_A2.nam` | 287 KB | Marshall JMP-50 Lead 1969 Plexi (A2) | amalgamaudio | Classic blues-rock breakup, Plexi crunch |
| `Park75_1968_Plexi_A2.nam` | 287 KB | PARK 75 (1968 Plexi Marshall KT88) (A2) | newgearmag | Presence full — pushed Plexi blues |
| `Park75_1968_Plexi_Noon_A2.nam` | 287 KB | PARK 75 (1968 Plexi Marshall KT88) (A2) | newgearmag | All noon — cleaner Plexi edge |
### Bank 4 — Rock Captures (Tone3000 A1 — WaveNet)
Downloaded from Tone3000 Supabase storage. All are WaveNet A1 (v0.5.0/v0.5.4), verified JSON.
| File | Size | Source Model | Best For |
|------|------|-------------|----------|
| `Marshall_JCM800_2203.nam` | 411 KB | 1989 Marshall JCM800 2203 suhrRL (#0b) | Classic rock crunch, hard rock rhythm |
| `Marshall_Plexi_1967_Low.nam` | 412 KB | 1 Plexi 67 Low G8 (Emil Rohbe) | Vintage rock clean/crunch, touch-sensitive |
| `Marshall_Plexi_1967_Dimed.nam` | 412 KB | 16 Plexi 67 Normal Dimed (Emil Rohbe) | Pushed plexi, classic rock lead |
| `Marshall_JTM45_Clean.nam` | 276 KB | JTM45EC Ch1 | Classic Marshall clean, edge-of-breakup |
| `Marshall_JTM45_Breakup.nam` | 276 KB | JTM45EC Ch2 | JTM45 breakup, vintage rock overdrive |
### Bank 5 — High-Gain / Lead Captures (Tone3000 A1 — WaveNet)
| File | Size | Source Model | Best For |
|------|------|-------------|----------|
| `Mesa_Boogie_Dual_Rec_Plumes.nam` | 277 KB | MB Dual Rectifier V4A1 + EQD Plumes | Boosted high-gain, modern metal rhythm |
| `Mesa_Boogie_Dual_Rec_Red.nam` | 276 KB | Rectifier Red | Classic metal rhythm, palm-mute chug |
| `EVH_5150III_Stealth_Lead.nam` | 411 KB | EVH 5150III 50W Stealth Lead | Searing leads, tight low-end |
| `EVH_5150III_Boosted.nam` | 397 KB | EVH 5150 III Amp Only Boosted | Boosted high-gain lead |
| `Diezel_VH4_Brown_Sugar.nam` | 277 KB | Diezel VH4 + MLC Brown Sugar | Modern high-gain, saturated sustain |
| `Engl_Powerball_MkI_Lead.nam` | 411 KB | Engl Powerball MK I Heavy Lead | Saturated lead, modern metal |
| `Engl_Powerball_II_Crunch.nam` | 64 KB | Engl Powerball II Crunch | Tight metal rhythm (feather!) |
| `Engl_Powerball_II_HiGain.nam` | 64 KB | Engl Powerball II High Gain Rhythm | Modern metal rhythm (feather!) |
| `Engl_Powerball_II_Clean.nam` | 64 KB | Engl Powerball II Clean | Clean channel with headroom (feather!) |
### Bank 6 — Ambient/Post-Rock Captures (Tone3000 A1 — WaveNet)
|| File | Size | Source Model | Best For |
||------|------|-------------|----------|
|| `Roland_JC120_Jazz_Chorus.nam` | 276 KB | Roland JC-120 Jazz Chorus | Pristine clean, ambient washes, jazz |
|| `Vox_AC30_Chimey.nam` | 290 KB | Vox AC30 Chimey | Sparkling clean, chimey post-rock |
|| `Fender_Twin_Reverb_G05.nam` | 288 KB | Tim R Fender Twin Reverb Ch1 BR G05 | Clean/country, pedal platform |
### Bank 7 — Bass, Orange & Others (Tone3000 A2 — SlimmableContainer)
Downloaded from Tone3000 Supabase storage. All are SlimmableContainer (A2) v0.7.0, ~288-295 KB.
Covers the missing categories: Bass amps, Orange Rocker 30, Fender Bassman, Hiwatt DR103, Supro.
|| File | Size | Source Model | Category | Best For |
||------|------|-------------|----------|----------|
|| `Ampeg_PF20T_A2.nam` | 288 KB | Ampeg PF20T | Bass | Clean bass tube amp, warm lows |
|| `Aguilar_Tone_Hammer_500_A2.nam` | 293 KB | Aguilar Tone Hammer 500 | Bass | Modern bass preamp, punchy mids |
|| `GK_800RB_Line_A2.nam` | 295 KB | Gallien-Krueger 800RB | Bass | Classic solid-state bass, aggressive |
|| `Aguilar_DB751_Cab_A2.nam` | 292 KB | Aguilar DB751 | Bass | Bass amp DI, full-range presence |
|| `Orange_Rocker30_Dirty_A2.nam` | 295 KB | Orange Rocker 30 Dirty | Orange | Classic rock crunch, stoner/alt rock |
|| `Orange_Rocker30_Natural_A2.nam` | 289 KB | Orange Rocker 30 Natural | Orange | Clean edge, dynamic garage tones |
|| `Fender_Bassman_Dimed_A2.nam` | 289 KB | Fender Bassman dimed | Others | Blues/rock breakup, classic Bassman growl |
|| `Hiwatt_DR103_Bright_A2.nam` | 287 KB | Hiwatt DR-103 Bright Normal | Others | Prog/classic rock, The Who territory |
|| `Hiwatt_DR103_Cornish_A2.nam` | 288 KB | Hiwatt DR103 + Cornish PGS | Others | Boosted prog rock, Gilmour-esque leads |
|| `Supro_Black_Magick_M3_A2.nam` | 288 KB | Supro Black Magick M3 | Others | Garage/blues, Jack White-style grit |
### Legacy Models (Linear Architecture — synthetic, ~35-85 KB)
These remain in `~/.pedal/nam/` for backward compatibility:
`Fender_Twin_Clean.nam`, `Vox_AC15_TopBoost.nam`, `Marshall_JCM800.nam`,
`Mesa_Boogie_MarkV.nam`, `Roland_Jazz_Chorus.nam`, `Orange_AD30.nam`,
`Fender_Bassman_59.nam`, `5150_EVH.nam`, `Engl_Powerball.nam`, `Diezel_VH4.nam`
## Cabinet IRs
### Built-in Synthetic IRs (generated by `scripts/generate_seed_irs.py`)
Located in `~/.pedal/irs/`. All are 48 kHz, 16-bit mono WAV.
| File | Length | Type | Best Genres |
|------|--------|------|-------------|
| `vintage-1x12.wav` | 2048 / 43ms | Fender-style 1x12 open back | Clean Jazz, Blues, Fingerstyle |
| `british-4x12.wav` | 4096 / 85ms | Marshall 1960A 4x12 closed back | Classic Rock, Crunch |
| `american-2x12.wav` | 2048 / 43ms | Vox AC30 2x12 open back | Clean, Chimey, Edge-of-Breakup |
| `modern-4x12.wav` | 4096 / 85ms | Mesa Rectifier 4x12 closed back | Metal, High Gain |
| `jazz-1x15.wav` | 2048 / 43ms | 15" open back | Jazz, Bass Cleans |
| `boutique-1x12.wav` | 2048 / 43ms | Dumble-style 1x12 | Smooth Cleans, Blues |
| `mini-1x8.wav` | 1024 / 21ms | Small practice amp | Lo-fi, Vintage Radio |
### Real IRs (downloaded from GitHub: fnpngn/IR)
Downloaded 2026-06-13 from `https://github.com/fnpngn/IR` (git-lfs). Source packs: DYNAX, 1960a, Allure, ML Sound Lab, Dauntless, Master Of Puppets, Modern Metal Songwriter, FREE BASS IR. All converted to 48 kHz, 16-bit mono WAV.
#### 1x12 Open Back (Fender-style — Clean, Ambient, Blues)
| File | Length | Source | Best Genres |
|------|--------|--------|-------------|
| `1x12-fender-deluxerev-dynax.wav` | 500ms | DY Fend DeluxeRev (Fender Deluxe Reverb 1x12, A mic pos) | Clean Jazz, Blues, Fingerstyle |
| `1x12-fender-deluxerev-b-dynax.wav` | 500ms | DY Fend DeluxeRev (B mic pos) | Clean Jazz, Blues |
| `1x12-fender-deluxerev-c-dynax.wav` | 500ms | DY Fend DeluxeRev (C mic pos) | Clean Jazz, Blues |
| `1x12-fender-hotrod-dynax.wav` | 500ms | DY Fend HotRod DX (Fender Hot Rod Deluxe 1x12, A pos) | Clean, Edge-of-Breakup |
| `1x12-fender-hotrod-b-dynax.wav` | 500ms | DY Fend HotRod DX (B pos) | Clean, Blues |
| `1x12-egnater-dynax.wav` | 500ms | DY Egnater 1x12 combo | Clean, Ambient |
| `1x12-bogner-cb-dynax.wav` | 500ms | DY Bognar 112CB (Bogner 1x12 closed back) | Rock, Edge |
| `1x10-fender-tweed-59-allure.wav` | 40ms | Allure_59_Tweed_P10N (Vintage 1x10) | Lo-fi, Vintage Clean |
| `1x12-fender-deluxe-64-allure.wav` | 40ms | Allure_64_USDeluxe_P12N (Fender Deluxe 1x12) | Clean, Blues |
#### 2x12 Open Back (Vox AC30-style — Clean, Ambient, Blues)
| File | Length | Source | Best Genres |
|------|--------|--------|-------------|
| `2x12-vox-ac30-dynax.wav` | 500ms | DY VX AC30C (Vox AC30 2x12, A pos) | Chimey Clean, Edge-of-Breakup |
| `2x12-vox-ac30-blue-dynax.wav` | 500ms | DY VX AC306 (Vox AC30 2x12 Blue Alnico, A pos) | Chimey, Ambient |
| `2x12-vox-ac30-g12-allure.wav` | 40ms | Allure_64_A30_G12 (Vox AC30, G12 speaker) | Clean, Edge-of-Breakup |
| `2x12-matchless-dc30-dynax.wav` | 500ms | DY MATCHL DC30BK (Matchless DC30 2x12, A pos) | Chimey, Complex mids |
| `2x12-fender-twin-dynax.wav` | 500ms | DY Fend Twin Rev (Fender Twin Reverb 2x12, A pos) | Sparkling Clean |
| `2x12-fender-tonemaster-dynax.wav` | 500ms | DY Fend Tone Maister (Fender Tonemaster 2x12) | Clean, Country |
| `2x12-bogner212-dynax.wav` | 500ms | DY Bognar212 (Bogner 212, A pos) | Rock, Edge |
#### 4x12 Closed Back (Marshall 1960-style — Rock, Classic Rock, Crunch)
| File | Length | Source | Best Genres |
|------|--------|--------|-------------|
| `4x12-marshall-1960a-sm57-0in-0c.wav` | 500ms | 1960A SM57, 0in-0c (cap edge, on-axis) | Classic Rock, Crunch |
| `4x12-marshall-1960a-sm57-0in-1c.wav` | 500ms | 1960A SM57, 0in-1c (between cap and cone) | Classic Rock |
| `4x12-marshall-1960a-sm57-0in-2c.wav` | 500ms | 1960A SM57, 0in-2c (cone edge) | Classic Rock, Blues |
| `4x12-marshall-1960a-sm57-0in-3c.wav` | 500ms | 1960A SM57, 0in-3c (cone middle) | Rock, Lead |
| `4x12-marshall-1960a-sm57-0in-4c.wav` | 500ms | 1960A SM57, 0in-4c (center) | Rock, High Gain |
| `4x12-marshall-1960a-sm57-capedge.wav` | 500ms | 1960A SM57, 0.5in-0c (cap edge) | Classic Rock |
| `4x12-marshall-1960a-i5-0in.wav` | 500ms | 1960A Audix i5, 0in-0c | Rock, Lead |
| `4x12-marshall-1960a-i5-1c.wav` | 500ms | 1960A Audix i5, 0in-1c | Rock |
| `4x12-marshall-1960ahw-dynax.wav` | 500ms | DY Mars 412 1960AHW (Marshall 1960AHW) | Rock, Classic Rock |
| `4x12-marshall-jcm800-1960a-dynax.wav` | 500ms | DY Mars412 JC800 1960A (Marshall JCM800) | Rock, Hard Rock |
| `4x12-marshall-jcm800-1960b-dynax.wav` | 500ms | DY Mars412 JC800 1960B (Marshall JCM800 alt) | Rock |
| `4x12-marshall-mop-sm57.wav` | 500ms | Master Of Puppets, SM57 mic | Metal, Thrash |
| `4x12-marshall-mop-c414.wav` | 500ms | Master Of Puppets, AKG C414 mic | Metal, Lead |
| `4x12-marshall-mop-blended.wav` | 500ms | Master Of Puppets, blended mix | Rock, Metal |
#### 4x12 Modern (Mesa Rectifier-style — Metal, High Gain, Djent)
| File | Length | Source | Best Genres |
|------|--------|--------|-------------|
| `4x12-mesa-rectifier-dynax.wav` | 500ms | DY MasaBoo Recti412 (Mesa Rectifier 4x12, A pos) | Metal, High Gain |
| `4x12-mesa-rectifier-armored-dynax.wav` | 500ms | DY MasaBoo Recti412 Armored | Modern Metal, Djent |
| `4x12-peavey-5150-dynax.wav` | 500ms | DY PEV5150 412SL (Peavey 5150 4x12) | Metal, Nu-Metal |
| `4x12-evh-5150-ic-v1.wav` | 500ms | 5150 IC V1 (EVH 5150) | Metal, Lead |
| `4x12-engl-e412-dynax.wav` | 500ms | DY ENG E412VHB (ENGL 4x12) | Modern Metal, Djent |
| `4x12-engl-fireball-sm48-dauntless.wav` | 500ms | Dauntless: Engl Fireball SM48 | Metal, Death |
| `4x12-engl-fireball-b906-dauntless.wav` | 500ms | Dauntless: Engl Fireball B906 | Metal |
| `4x12-engl-fireball-sc140-dauntless.wav` | 500ms | Dauntless: Engl Fireball SC140 | Metal |
| `4x12-diezel-v412-dynax.wav` | 500ms | DY DIEZL V412 (Diezel 4x12) | Modern Metal |
| `4x12-friedman-dynax.wav` | 500ms | DY Fried 412 (Friedman 4x12) | Rock, Metal |
| `4x12-bogner412-dynax.wav` | 500ms | DY Bognar412 (Bogner 4x12) | Rock |
| `4x12-orange-ppc412-dynax.wav` | 500ms | DY ORENG 412PPC (Orange PPC412) | Rock, Doom, Stoner |
| `4x12-smith-v30-sm57-dc.wav` | 500ms | SMG UK V30 SM57 DC (V30, close mic) | Rock, High Gain |
| `4x12-smith-v30-440-dc.wav` | 500ms | SMG UK V30 440 DC (V30, different mic) | Rock |
| `4x12-mesa-modern-ic.wav` | 500ms | Mesa Modern IC (Mesa Boogie) | Modern Metal |
| `4x12-mesa-c414-xl2.wav` | 500ms | Mesa c414 XL2 (AKG C414) | Metal |
| `4x12-ml-soundlab-color-calibrated.wav` | 200ms | ML Sound Lab Color Calibrated IR | Modern Metal |
| `4x12-ml-soundlab-tube-color.wav` | 200ms | ML Sound Lab Tube Color IR | Modern Metal |
| `4x12-ml-soundlab-ss-color.wav` | 200ms | ML Sound Lab Solid State Color IR | Modern Metal |
| `4x12-ml-soundlab-best-ir.wav` | 500ms | ML Sound Lab BEST IR IN THE WORLD | General Rock/Metal |
| `4x12-ml-soundlab-djentle-keyan.wav` | 500ms | ML Sound Lab Djentle Keyan (48kHz) | Djent, Modern Metal |
| `4x12-ml-soundlab-djentle-keyan-44k.wav` | 500ms | ML Sound Lab Djentle Keyan (converted 44→48k) | Djent |
#### Bass Cab IRs
| File | Length | Best Genres |
|------|--------|-------------|
| `bass-balanced.wav` | 500ms | General bass |
| `bass-clanky.wav` | 500ms | Clanky/modern bass |
| `bass-classic.wav` | 500ms | Classic bass |
| `bass-half_and_half.wav` | 500ms | All-purpose bass |
| `bass-more_mids.wav` | 500ms | Mid-heavy bass |
| `bass-rumble_bass.wav` | 500ms | Sub-heavy bass |
| `bass-rumble_jr.wav` | 500ms | Light bass |
| `bass-thick_classic.wav` | 500ms | Thick classic bass |
| `bass-use_fuzz.wav` | 500ms | Distorted bass |
| `bass-use_on_sub_track.wav` | 500ms | Sub-track bass |
### Previous attempt — Archive.org (unavailable)
The following Archive.org sources returned 404 when last checked (2026-06-13):
| Pack | URL | Contents |
|------|-----|----------|
| God's Cab | `archive.org/download/godscab-ir-pack/` | 100+ IRs (412, 1960, V30, Greenback) — CC0 |
| Seacow Cabs | `archive.org/download/seacow-cabs-free-ir-2023/` | Boutique IRs, 15+ cabs — Free for personal use |
**To retry when Archive.org is back:** `python3 scripts/download_nam_and_irs.py --irs`
## Genre-to-Model Mapping
### Clean Jazz (Preset 0)
- **Amp:** `Fender_TwinVerb_Clean.nam` (or `JCM2000_Clean.nam`)
- **Cab:** `vintage-1x12.wav` (or `jazz-1x15.wav`)
### Edge of Breakup (Preset 1)
- **Amp:** `Magnatone_Super59_Pushed.nam` (or `Vox_AC15_TopBoost.nam`)
- **Cab:** `american-2x12.wav` (or `boutique-1x12.wav`)
### Clean with Chorus (Preset 2)
- **Amp:** `Fender_TwinVerb_Vibrato.nam`
- **Cab:** `vintage-1x12.wav`
### Dynamic Fingerstyle (Preset 3)
- **Amp:** `Vox_AC15_TopBoost.nam`
- **Cab:** `american-2x12.wav`
### Classic Rock (Preset 4)
- **Amp:** `Orange_Rockerverb.nam` (or `JCM2000_Crunch.nam`)
- **Cab:** `british-4x12.wav`
### Lead Solo (Preset 5)
- **Amp:** `5150_BlockLetter_Boosted.nam` (or `Engl_Savage.nam`)
- **Cab:** `modern-4x12.wav`
- **Boost:** `BOSS_SD1_Feather.nam` or `TS808_Feather.nam`
### Metal Rhythm (Preset 6)
- **Amp:** `6505_Red_NoBoost.nam` (or `Splawn_ProMod_3rd.nam`)
- **Cab:** `modern-4x12.wav`
### Ambient Wash (Preset 7)
- **Amp:** `Fender_TwinVerb_Clean.nam` (highly modulated FX chain)
- **Cab:** `vintage-1x12.wav`
### Blues Clean (Bank 2)
- **Amp:** `Fender_Princeton_Clone_Clean.nam` (or `Fender_Twin_Reverb_Clean_A2.nam`, or `TwoRock_JTM_Signature.nam`)
- **Cab:** `1x12-fender-deluxerev-dynax.wav` (or `vintage-1x12.wav`, `1x12-fender-hotrod-dynax.wav`)
### Blues Edge-of-Breakup (Bank 2)
- **Amp:** `Fender_Princeton_Clone_EOB.nam` (or `Fender_Tweed_Dlx_Edge.nam`)
- **Cab:** `2x12-vox-ac30-dynax.wav` (or `american-2x12.wav`, `2x12-matchless-dc30-dynax.wav`)
### Blues Pushed / Overdrive (Bank 2)
- **Amp:** `Dumble_ODS_102_Rock_A2.nam` (or `Marshall_Bluesbreaker_1962_A2.nam`)
- **Cab:** `4x12-marshall-1960a-sm57-0in-2c.wav` (or `british-4x12.wav`, `4x12-marshall-1960ahw-dynax.wav`)
- **Boost:** `Marshall_Bluesbreaker_Pedal.nam` (or `TubeScreamer_Maxed.nam`)
## File Locations
```
`~/.pedal/`
├── models/ # 64 models (22 core + 9 blues + 5 A2 bonus + 1 ML cab + 17 Tone3000 rock/high-gain/ambient + 10 Bank 7 bass/orange/others)
│ ├── Fender_TwinVerb_Clean.nam
│ ├── Fender_TwinVerb_Vibrato.nam
│ ├── Vox_AC15_TopBoost.nam
│ ├── Magnatone_Super59_Pushed.nam
│ ├── JCM2000_Clean.nam
│ ├── Orange_Rockerverb.nam
│ ├── JCM2000_Crunch.nam
│ ├── JCM900_Lead.nam
│ ├── 5150_BlockLetter_Boosted.nam
│ ├── 6505_Red_NoBoost.nam
│ ├── Engl_Savage.nam
│ ├── Splawn_ProMod_3rd.nam
│ ├── 5152_Lead_TS9.nam
│ ├── Klon_Centaur_High.nam
│ ├── TubeScreamer_Maxed.nam
│ ├── Mesa_MarkIV_Lead.nam
│ ├── Bogner_Ecstasy.nam
│ ├── BOSS_SD1_Feather.nam # 90 KB
│ ├── MXR_M77_Feather.nam # 90 KB
│ ├── TS808_Feather.nam # 90 KB
│ ├── Precision_Drive_Feather.nam # 90 KB
│ ├── Friedman_PowerAmp_Feather.nam # 90 KB
│ │
│ ├── Bank 2 — Blues captures:
│ ├── Fender_Princeton_Clone_Clean.nam # 289 KB — Blues Clean
│ ├── Fender_Princeton_Clone_EOB.nam # 288 KB — Blues Edge
│ ├── Fender_Tweed_Dlx_Edge.nam # 288 KB — Tweed Pushed
│ ├── Fender_Twin_Reverb_Clean_A2.nam # 290 KB — Blues Clean
│ ├── TwoRock_JTM_Signature.nam # 276 KB — Clean/Edge
│ ├── Dumble_ODS_102_Rock_A1.nam # 87 KB — Pushed OD feather
│ ├── Dumble_ODS_102_Rock_A2.nam # 289 KB — Pushed OD
│ ├── Marshall_Bluesbreaker_1962_A2.nam # 289 KB — Blues Rock
│ ├── Marshall_Bluesbreaker_Pedal.nam # 290 KB — Pedal OD
│ │
│ ├── Bonus — ML Sound Lab (from GitHub: fnpngn/IR):
│ ├── ML NAM AI Cab.nam # 298 KB — Cab modeling NAM (WaveNet)
│ │
│ └── Bonus — A2 slimmable models (from prior runs):
│ ├── Fender_Deluxe_Reverb_A2.nam # 301 KB — Deluxe Reverb (Slimmable v0.7.0)
│ ├── Marshall_JMP50_Plexi_A2.nam # 302 KB — Plexi (Slimmable v0.7.0)
│ ├── Park75_1968_Plexi_A2.nam # 301 KB — Park 75 Plexi (Slimmable v0.7.0)
│ ├── Park75_1968_Plexi_Noon_A2.nam # 302 KB — Park 75 Plexi noon (Slimmable)
│ ├── Roland_JC-120_A2.nam # 304 KB — JC-120 Jazz Chorus (Slimmable)
│ │
│ ├── Bank 4 — Rock captures:
│ ├── Marshall_JCM800_2203.nam # 411 KB — JCM800 rock crunch
│ ├── Marshall_Plexi_1967_Low.nam # 412 KB — Plexi low gain
│ ├── Marshall_Plexi_1967_Dimed.nam # 412 KB — Plexi pushed
│ ├── Marshall_JTM45_Clean.nam # 276 KB — JTM45 clean/edge
│ ├── Marshall_JTM45_Breakup.nam # 276 KB — JTM45 breakup
│ │
│ ├── Bank 5 — High-Gain captures:
│ ├── Mesa_Boogie_Dual_Rec_Plumes.nam # 277 KB — Dual Rectifier boosted
│ ├── Mesa_Boogie_Dual_Rec_Red.nam # 276 KB — Rectifier Red
│ ├── EVH_5150III_Stealth_Lead.nam # 411 KB — 5150III Lead
│ ├── EVH_5150III_Boosted.nam # 397 KB — 5150III boosted
│ ├── Diezel_VH4_Brown_Sugar.nam # 277 KB — VH4 modern high-gain
│ ├── Engl_Powerball_MkI_Lead.nam # 411 KB — Powerball lead
│ ├── Engl_Powerball_II_Crunch.nam # 64 KB — Powerball II crunch (feather)
│ ├── Engl_Powerball_II_HiGain.nam # 64 KB — Powerball II rhythm (feather)
│ ├── Engl_Powerball_II_Clean.nam # 64 KB — Powerball II clean (feather)
│ │
│ ├── Bank 6 — Ambient captures:
│ ├── Roland_JC120_Jazz_Chorus.nam # 276 KB — JC-120 clean
│ ├── Vox_AC30_Chimey.nam # 290 KB — AC30 chimey clean
│ ├── Fender_Twin_Reverb_G05.nam # 288 KB — Twin Reverb clean
│ │
│ ├── Bank 7 — Bass, Orange & Others:
│ ├── Ampeg_PF20T_A2.nam # 288 KB — Bass clean tube
│ ├── Aguilar_Tone_Hammer_500_A2.nam # 293 KB — Bass modern preamp
│ ├── GK_800RB_Line_A2.nam # 295 KB — Bass solid-state
│ ├── Aguilar_DB751_Cab_A2.nam # 292 KB — Bass amp DI
│ ├── Orange_Rocker30_Dirty_A2.nam # 295 KB — Rock crunch
│ ├── Orange_Rocker30_Natural_A2.nam # 289 KB — Clean edge
│ ├── Fender_Bassman_Dimed_A2.nam # 289 KB — Blues/rock breakup
│ │
│ └── 🎸 Bass Genre Research:
│ └── Full artist tone chain configs → `docs/bass-tone-research.md`
│ Available on Tone3000 (needs download): SansAmp BDDI v1, Darkglass B3K/B7K,
│ Ampeg SVT-CL, Geddy Lee SansAmp DI-2112
│ ├── Hiwatt_DR103_Bright_A2.nam # 287 KB — Classic rock
│ ├── Hiwatt_DR103_Cornish_A2.nam # 288 KB — Boosted classic rock
│ ├── Supro_Black_Magick_M3_A2.nam # 288 KB — Garage/blues
│ │
├── nam/ # Legacy location (symlinked from models/)
│ ├── Fender_TwinVerb_Clean.nam → ../models/Fender_TwinVerb_Clean.nam
│ ├── (10 legacy Linear models remain)
│ └── ...
└── irs/ # 7 synthetic + 62 real IRs (48kHz, mono)
├── vintage-1x12.wav # synthetic
├── british-4x12.wav # synthetic
├── american-2x12.wav # synthetic
├── modern-4x12.wav # synthetic
├── jazz-1x15.wav # synthetic
├── boutique-1x12.wav # synthetic
├── mini-1x8.wav # synthetic
├── 1x12-*.wav # 9 real IRs (Fender Deluxe, Hot Rod, etc.)
├── 2x12-*.wav # 7 real IRs (Vox AC30, Matchless, etc.)
├── 4x12-*.wav # 36 real IRs (Marshall 1960A, Mesa Rectifier, etc.)
├── bass-*.wav # 10 real IRs (bass cab captures)
├── README.md
└── default/
└── default_ir.wav
```
## Verification
All 64 models were:
- 22 models from `https://raw.githubusercontent.com/pelennor2170/NAM_models/main/`
- 9 blues models from Tone3000 / ToneHunt Supabase storage
- 5 clean/plexi A2 models from Tone3000 Supabase storage
- 1 bonus ML Sound Lab model from GitHub: fnpngn/IR
- 17 rock/high-gain/ambient models from Tone3000 Supabase storage
- 10 bass/orange/others A2 models from Tone3000 Supabase storage
- All verified as valid `.nam` JSON files (WaveNet A1, WaveNet A2, or SlimmableContainer A2 architecture)
To verify models load correctly:
```bash
python3 -c "
from src.dsp.nam_host import NAMHost
h = NAMHost(models_dir='$HOME/.pedal/models')
for m in h.list_available_models():
print(f'{m.name:30s} {m.architecture:10s} {m.size_mb:.2f} MB')
"
```
## Scripts
| Script | Purpose |
|--------|---------|
| `scripts/download_nam_and_irs.py` | Download models + IRs from GitHub/Archive.org |
| `scripts/download_nam_and_irs.sh` | Shell alternative (legacy) |
| `scripts/download_models.sh` | Old generator (synthetic models) |
| `scripts/download_irs.sh` | Old IR downloader |
## Upgrade Path
1. **More real IRs:** When Archive.org is back, run `python3 scripts/download_nam_and_irs.py --irs` to get God's Cab and Seacow Cabs packs.
2. **More NAM models:** 17 new Tone3000 A1 models added (Banks 4-6) covering Rock (JCM800, Plexi, JTM45), High-Gain (Dual Rectifier, 5150III, Diezel VH4, Engl Powerball), and Ambient (JC-120, AC30, Twin Reverb). Browse https://www.tone3000.com/search with filters.
3. **Additional IR sources** (may require sign-up):
- Lancaster Audio free pack: https://lancasteraudio.com/ (search "free impulse responses")
- ML Sound Lab: https://mlsoundlab.com/pages/free-impulse-responses
- Celestion Plus: https://celestionplus.com/ (requires account)