# The `fretplot` package

CoverImage

**Author and maintainer:** [Soumendra Ganguly](https://soumendraganguly.com)  
**Copyright 2025 Soumendra Ganguly**

---

The **fretplot** LuaTeX package provides batch generation of scale and chord diagrams for plucked string instruments, such as the guitar.

- **Flexible & automated:**  
  Highly customizable and automatable via simple, powerful file formats for describing fretboard diagrams. Easily generate batches of diagrams.

- **Attractive defaults:**  
  Comes with sensible, visually appealing default settings.

- **Music theory aware:**  
  Includes easy-to-use LaTeX macros that understand music theory. Render guitar scale diagrams by specifying the musical scale or scale type via built in macros or directly via degree, pitch class, or interval formulae.

---

📖 [Read the documentation for more information](doc_fretplot.pdf)
🤖 [MCP server to generate fretplot code using natural language](https://github.com/8vasu/fretplot-mcp)
📜 [Featured in *La Lettre GUTenberg*](https://publications.gutenberg-asso.fr/lettre/article/view/131)
