gitwtfhub

wtf is nam-eq-match?

sd456/nam-eq-match — explained in plain English

Analysis updated 2026-05-18

7PythonAudience · generalComplexity · 3/5Setup · moderate

TL;DR

A tool that clones a guitar tone from a recording by matching amp character and EQ against your own guitar take.

Mindmap

mindmap
  root((NAM EQ Matcher))
    What it does
      Clones guitar tone
      Matches amp character
      Closes EQ gap
    Tech stack
      Python
      PyTorch
      Demucs
    Use cases
      Recreate a song tone
      Search TONE3000 catalog
      Extract guitar stem
    Audience
      Guitarists
      Home studio producers
    Setup
      Python 3.10 plus
      Optional CUDA GPU
      GUI or CLI

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Recreate a guitar tone from a song by matching it against your own clean guitar recording.

REASON 2

Search and download amp capture files from the TONE3000 catalog to expand your matching library.

REASON 3

Extract a guitar stem from a full mix automatically to use as a tone-matching target.

What's in the stack?

PythonPyTorchDemucsGradio

How it stacks up

sd456/nam-eq-matchalx-code/lingbot-video-1.3b-fp8andrevicencio/tmux-flash
Stars777
LanguagePythonPythonPython
Setup difficultymoderateeasy
Complexity3/52/5
Audiencegeneraldeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · moderate Time to first run · 30min

GPU acceleration needs a CUDA build of PyTorch installed separately from the default CPU-only version.

Wtf does this do

NAM EQ Matcher is a Python tool for guitarists who want to recreate a guitar tone they hear in a finished song, using their own guitar and amp modeling software. It combines two separate ideas: NAM, a way of digitally capturing the character of a real amplifier including things like distortion and compression, and an EQ matching technique that adjusts tone frequencies to match a target sound. To use it, you provide three things: a target recording containing the tone you want to copy, which can even be a full song since the tool can automatically pull out just the guitar part using a separation tool called Demucs, your own clean guitar recording called a DI, and a library of amp capture files, either your own collection or ones searched for and downloaded from an online catalog called TONE3000. The tool then runs your clean guitar through every amp capture in the library at various gain settings, comparing each result against the target using audio statistics that capture things like clipping character and compression feel rather than just simple loudness. Once it finds the best matching amp capture, it analyzes the remaining frequency differences and offers three ways to close that gap: an exact spectral correction file, suggested tone knob settings for the amp plugin's built in equalizer, or a blend of both which the tool recommends as the most natural sounding option. The output includes the winning amp capture and gain setting, a correction file, an audio preview of your guitar run through the matched setup, a chart comparing the two frequency spectrums, and a written report, all with clearly labeled filenames. It can be installed and run through simple double click launcher scripts on Windows, macOS, and Linux, or set up manually using Python's virtual environment tools, and it offers both a browser based interface and a command line option. Running on a graphics card speeds up the process significantly compared to a regular processor.

Yoink these prompts

Prompt 1
Help me run NAM EQ Matcher on a full song using the --demix option to extract the guitar stem.
Prompt 2
Explain the difference between Options A, B, and C for closing the EQ gap in this tool.
Prompt 3
Walk me through setting up TONE3000 search with an API key in this project.
Prompt 4
Help me install a CUDA build of PyTorch to speed up NAM EQ Matcher.

Frequently asked questions

wtf is nam-eq-match?

A tool that clones a guitar tone from a recording by matching amp character and EQ against your own guitar take.

What language is nam-eq-match written in?

Mainly Python. The stack also includes Python, PyTorch, Demucs.

How hard is nam-eq-match to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is nam-eq-match for?

Mainly general.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.