tonaljs/tonal

Health v2 · maintenance only

Flags: no_releases no_license

Adoption not part of the score

4223 stars · 252 forks observed · 2026-08-28

What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-29, confidence not recorded

Tonal is a TypeScript music theory library for JavaScript that provides pure functions to manipulate notes, intervals, chords, scales, modes, and keys. It deals with musical abstractions rather than actual sound, and is published as a collection of modular npm packages usable in Node or the browser.

Use cases

• convert note names to midi numbers and frequencies
• transpose notes and chords by intervals
• get the notes of a scale or chord
• detect or name chords from note collections
• compute chord inversions and scale degrees
• work with key signatures, modes, and roman numeral progressions
• parse ABC notation in a web app

When to choose

• you need music theory calculations (notes, chords, scales, keys) in JavaScript or TypeScript
• you want a small, modular, dependency-free library with a functional API
• you're building a music education tool, chord app, or theory-based generator in the browser or Node

When to avoid

• you need audio playback, synthesis, or sound generation - Tonal handles abstractions only
• you need real-time MIDI hardware I/O or DAW integration
• you need notation engraving or score rendering

Facets

library · maturity stable

parser serialization developer-tools audio web-development frontend education browser cross-platform music-theory chords scales intervals transposition typescript functional-programming midi key-signatures chord-progressions nodejs web-server

Member repositories

For agents

markdown · JSON · MCP: product_card(name="tonaljs/tonal")