{"adoption": {"forks": 252, "observed_at": "2026-08-28T04:08:39.336853+00:00", "stars": 4223}, "canonical_url": "https://ross.abutalabs.com/products/tonal", "card": {"archived": false, "artifact_type": "library", "description": "A music theory library for Javascript", "domain": ["audio", "web-development", "frontend", "education"], "enriched": true, "function": ["parser", "serialization", "developer-tools"], "health_score": 77, "homepage": "https://tonaljs.github.io/tonal/docs", "language": "TypeScript", "license": null, "license_family": "other", "maturity": "stable", "member_repos": ["tonaljs/tonal"], "name": "tonaljs/tonal", "platform": ["browser", "cross-platform"], "pushed_at": "2026-07-28T04:06:59+00:00", "repo": "tonaljs/tonal", "stars": 4223, "tags": ["music-theory", "chords", "scales", "intervals", "transposition", "typescript", "functional-programming", "midi", "key-signatures", "chord-progressions", "nodejs", "web-server"], "topics": ["music-theory", "javascript", "music", "functional", "scale", "chords", "key-signatures", "interval", "transpose", "chord-progression", "typescript"], "urls": [], "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"], "what_it_is": "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.", "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"], "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"]}, "data_as_of": "2026-08-30T08:39:29.467469+00:00", "members": [{"path": "/products/tonal", "repo": "tonaljs/tonal", "role": "main", "score": 75}], "provenance": {"archived": {"kind": "observed", "observed_at": "2026-08-28T04:08:39.336853+00:00", "source": "github"}, "artifact_type": {"confidence": null, "enriched_at": "2026-08-29T18:22:23.378973+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "9d4958db1a1526c893ce42755c43a743be1aa0b737525944d60ddc96bede03fa", "fetched_at": "2026-08-28T04:08:39.336853+00:00", "kind": "readme", "missing": false, "url": "https://github.com/tonaljs/tonal"}, {"content_hash": "093e520312f199639f4cb7850d0396353bdc37e20b6d473488b14dd4565cb297", "fetched_at": "2026-08-29T09:12:35.518589+00:00", "kind": "homepage", "missing": false, "url": "https://tonaljs.github.io/tonal/docs"}, {"content_hash": "80d6660727f27bdba823ee71a917083778efe89caa03becc911271f928310a84", "fetched_at": "2026-08-29T09:12:35.521014+00:00", "kind": "registry_npm", "missing": false, "url": "https://registry.npmjs.org/tonal"}], "taxonomy_version": 1}, "description": {"kind": "observed", "observed_at": "2026-08-28T04:08:39.336853+00:00", "source": "github"}, "domain": {"confidence": null, "enriched_at": "2026-08-29T18:22:23.378973+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "9d4958db1a1526c893ce42755c43a743be1aa0b737525944d60ddc96bede03fa", "fetched_at": "2026-08-28T04:08:39.336853+00:00", "kind": "readme", "missing": false, "url": "https://github.com/tonaljs/tonal"}, {"content_hash": "093e520312f199639f4cb7850d0396353bdc37e20b6d473488b14dd4565cb297", "fetched_at": "2026-08-29T09:12:35.518589+00:00", "kind": "homepage", "missing": false, "url": "https://tonaljs.github.io/tonal/docs"}, {"content_hash": "80d6660727f27bdba823ee71a917083778efe89caa03becc911271f928310a84", "fetched_at": "2026-08-29T09:12:35.521014+00:00", "kind": "registry_npm", "missing": false, "url": "https://registry.npmjs.org/tonal"}], "taxonomy_version": 1}, "enriched": {"inputs": [], "kind": "computed", "method": "enrichment_status"}, "function": {"confidence": null, "enriched_at": "2026-08-29T18:22:23.378973+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "9d4958db1a1526c893ce42755c43a743be1aa0b737525944d60ddc96bede03fa", "fetched_at": "2026-08-28T04:08:39.336853+00:00", "kind": "readme", "missing": false, "url": "https://github.com/tonaljs/tonal"}, {"content_hash": "093e520312f199639f4cb7850d0396353bdc37e20b6d473488b14dd4565cb297", "fetched_at": "2026-08-29T09:12:35.518589+00:00", "kind": "homepage", "missing": false, "url": "https://tonaljs.github.io/tonal/docs"}, {"content_hash": "80d6660727f27bdba823ee71a917083778efe89caa03becc911271f928310a84", "fetched_at": "2026-08-29T09:12:35.521014+00:00", "kind": "registry_npm", "missing": false, "url": "https://registry.npmjs.org/tonal"}], "taxonomy_version": 1}, "health_score": {"inputs": ["days_since_push", "days_since_release", "archived"], "kind": "computed", "method": "health_v1"}, "homepage": {"kind": "observed", "observed_at": "2026-08-28T04:08:39.336853+00:00", "source": "github"}, "language": {"kind": "observed", "observed_at": "2026-08-28T04:08:39.336853+00:00", "source": "github"}, "license": {"kind": "observed", "observed_at": "2026-08-28T04:08:39.336853+00:00", "source": "github"}, "license_family": {"inputs": ["license"], "kind": "computed", "method": "license_family"}, "maturity": {"confidence": null, "enriched_at": "2026-08-29T18:22:23.378973+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "9d4958db1a1526c893ce42755c43a743be1aa0b737525944d60ddc96bede03fa", "fetched_at": "2026-08-28T04:08:39.336853+00:00", "kind": "readme", "missing": false, "url": "https://github.com/tonaljs/tonal"}, {"content_hash": "093e520312f199639f4cb7850d0396353bdc37e20b6d473488b14dd4565cb297", "fetched_at": "2026-08-29T09:12:35.518589+00:00", "kind": "homepage", "missing": false, "url": "https://tonaljs.github.io/tonal/docs"}, {"content_hash": "80d6660727f27bdba823ee71a917083778efe89caa03becc911271f928310a84", "fetched_at": "2026-08-29T09:12:35.521014+00:00", "kind": "registry_npm", "missing": false, "url": "https://registry.npmjs.org/tonal"}], "taxonomy_version": 1}, "member_repos": {"kind": "observed", "observed_at": "2026-08-28T04:08:39.336853+00:00", "source": "github"}, "name": {"kind": "observed", "observed_at": "2026-08-28T04:08:39.336853+00:00", "source": "github"}, "platform": {"confidence": null, "enriched_at": "2026-08-29T18:22:23.378973+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "9d4958db1a1526c893ce42755c43a743be1aa0b737525944d60ddc96bede03fa", "fetched_at": "2026-08-28T04:08:39.336853+00:00", "kind": "readme", "missing": false, "url": "https://github.com/tonaljs/tonal"}, {"content_hash": "093e520312f199639f4cb7850d0396353bdc37e20b6d473488b14dd4565cb297", "fetched_at": "2026-08-29T09:12:35.518589+00:00", "kind": "homepage", "missing": false, "url": "https://tonaljs.github.io/tonal/docs"}, {"content_hash": "80d6660727f27bdba823ee71a917083778efe89caa03becc911271f928310a84", "fetched_at": "2026-08-29T09:12:35.521014+00:00", "kind": "registry_npm", "missing": false, "url": "https://registry.npmjs.org/tonal"}], "taxonomy_version": 1}, "pushed_at": {"kind": "observed", "observed_at": "2026-08-28T04:08:39.336853+00:00", "source": "github"}, "repo": {"kind": "observed", "observed_at": "2026-08-28T04:08:39.336853+00:00", "source": "github"}, "stars": {"kind": "observed", "observed_at": "2026-08-28T04:08:39.336853+00:00", "source": "github"}, "tags": {"confidence": null, "enriched_at": "2026-08-29T18:22:23.378973+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "9d4958db1a1526c893ce42755c43a743be1aa0b737525944d60ddc96bede03fa", "fetched_at": "2026-08-28T04:08:39.336853+00:00", "kind": "readme", "missing": false, "url": "https://github.com/tonaljs/tonal"}, {"content_hash": "093e520312f199639f4cb7850d0396353bdc37e20b6d473488b14dd4565cb297", "fetched_at": "2026-08-29T09:12:35.518589+00:00", "kind": "homepage", "missing": false, "url": "https://tonaljs.github.io/tonal/docs"}, {"content_hash": "80d6660727f27bdba823ee71a917083778efe89caa03becc911271f928310a84", "fetched_at": "2026-08-29T09:12:35.521014+00:00", "kind": "registry_npm", "missing": false, "url": "https://registry.npmjs.org/tonal"}], "taxonomy_version": 1}, "topics": {"kind": "observed", "observed_at": "2026-08-28T04:08:39.336853+00:00", "source": "github"}, "urls": {"kind": "observed", "observed_at": "2026-08-28T04:08:39.336853+00:00", "source": "github"}, "use_cases": {"confidence": null, "enriched_at": "2026-08-29T18:22:23.378973+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "9d4958db1a1526c893ce42755c43a743be1aa0b737525944d60ddc96bede03fa", "fetched_at": "2026-08-28T04:08:39.336853+00:00", "kind": "readme", "missing": false, "url": "https://github.com/tonaljs/tonal"}, {"content_hash": "093e520312f199639f4cb7850d0396353bdc37e20b6d473488b14dd4565cb297", "fetched_at": "2026-08-29T09:12:35.518589+00:00", "kind": "homepage", "missing": false, "url": "https://tonaljs.github.io/tonal/docs"}, {"content_hash": "80d6660727f27bdba823ee71a917083778efe89caa03becc911271f928310a84", "fetched_at": "2026-08-29T09:12:35.521014+00:00", "kind": "registry_npm", "missing": false, "url": "https://registry.npmjs.org/tonal"}], "taxonomy_version": 1}, "what_it_is": {"confidence": null, "enriched_at": "2026-08-29T18:22:23.378973+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "9d4958db1a1526c893ce42755c43a743be1aa0b737525944d60ddc96bede03fa", "fetched_at": "2026-08-28T04:08:39.336853+00:00", "kind": "readme", "missing": false, "url": "https://github.com/tonaljs/tonal"}, {"content_hash": "093e520312f199639f4cb7850d0396353bdc37e20b6d473488b14dd4565cb297", "fetched_at": "2026-08-29T09:12:35.518589+00:00", "kind": "homepage", "missing": false, "url": "https://tonaljs.github.io/tonal/docs"}, {"content_hash": "80d6660727f27bdba823ee71a917083778efe89caa03becc911271f928310a84", "fetched_at": "2026-08-29T09:12:35.521014+00:00", "kind": "registry_npm", "missing": false, "url": "https://registry.npmjs.org/tonal"}], "taxonomy_version": 1}, "when_to_avoid": {"confidence": null, "enriched_at": "2026-08-29T18:22:23.378973+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "9d4958db1a1526c893ce42755c43a743be1aa0b737525944d60ddc96bede03fa", "fetched_at": "2026-08-28T04:08:39.336853+00:00", "kind": "readme", "missing": false, "url": "https://github.com/tonaljs/tonal"}, {"content_hash": "093e520312f199639f4cb7850d0396353bdc37e20b6d473488b14dd4565cb297", "fetched_at": "2026-08-29T09:12:35.518589+00:00", "kind": "homepage", "missing": false, "url": "https://tonaljs.github.io/tonal/docs"}, {"content_hash": "80d6660727f27bdba823ee71a917083778efe89caa03becc911271f928310a84", "fetched_at": "2026-08-29T09:12:35.521014+00:00", "kind": "registry_npm", "missing": false, "url": "https://registry.npmjs.org/tonal"}], "taxonomy_version": 1}, "when_to_choose": {"confidence": null, "enriched_at": "2026-08-29T18:22:23.378973+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "9d4958db1a1526c893ce42755c43a743be1aa0b737525944d60ddc96bede03fa", "fetched_at": "2026-08-28T04:08:39.336853+00:00", "kind": "readme", "missing": false, "url": "https://github.com/tonaljs/tonal"}, {"content_hash": "093e520312f199639f4cb7850d0396353bdc37e20b6d473488b14dd4565cb297", "fetched_at": "2026-08-29T09:12:35.518589+00:00", "kind": "homepage", "missing": false, "url": "https://tonaljs.github.io/tonal/docs"}, {"content_hash": "80d6660727f27bdba823ee71a917083778efe89caa03becc911271f928310a84", "fetched_at": "2026-08-29T09:12:35.521014+00:00", "kind": "registry_npm", "missing": false, "url": "https://registry.npmjs.org/tonal"}], "taxonomy_version": 1}}, "score": {"components": {"activity": 94, "longevity": 100, "rhythm": 35}, "computed_at": "2026-09-03T02:20:16.233290+00:00", "flags": ["no_releases", "no_license"], "formula": "round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)", "inputs": {"age_days": 4065, "days_push": 36, "days_rel": null, "gap_med": null, "n_releases_24m": 0}, "score": 75, "version": 2}, "staleness": {"enrichment_outdated": false, "low_confidence": false, "scrape_days": 9, "stale_scrape": false}}