# @tonaljs/voicing-dictionary

> Collections of chord voicings

Latest version **5.1.5** (published 2026-10-14) · MIT license · 0 weekly downloads

## Install

```sh
npm install @tonaljs/voicing-dictionary
pnpm add @tonaljs/voicing-dictionary
yarn add @tonaljs/voicing-dictionary
bun add @tonaljs/voicing-dictionary
```

## Health

**Score 65/100 (B)** — status: active.

Positive: has types; esm support; no vulnerabilities; recently updated; high maintenance score.

Warnings: low downloads.

## Facts

| | |
|---|---|
| Version | 5.1.5 |
| Published | 2026-10-14 |
| First published | 2023-11-28 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Dependencies | 3 |
| Unpacked size | 13.3 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Author | felix91@gmail.com |
| Maintainers | danigb |
| Keywords | chord, voicing, voicings, music, theory, @tonaljs |

## Links

- npm: https://www.npmjs.com/package/@tonaljs/voicing-dictionary
- npm.io page: https://npm.io/package/@tonaljs/voicing-dictionary

## Dependencies (3)

- [@tonaljs/note](https://npm.io/package/@tonaljs/note.md) 4.12.3
- [@tonaljs/chord](https://npm.io/package/@tonaljs/chord.md) 6.2.1
- [@tonaljs/voice-leading](https://npm.io/package/@tonaljs/voice-leading.md) 5.1.4

## Recent versions

- 5.1.5 (latest) — 2026-10-14
- 5.1.4 — 2026-09-28
- 5.1.3 — 2026-01-18
- 5.1.2 — 2025-06-04
- 5.1.1 — 2025-01-03
- 5.1.0 — 2024-07-23
- 5.0.3 — 2024-02-03
- 5.0.2 — 2024-02-03
- 5.0.1 — 2024-01-04
- 5.0.0 — 2023-11-28

## README

# @tonaljs/voicing-dictionary

Contains dictionaries for many chord voicings. Used by [@tonaljs/voicing](../voicing).

## Usage

ES6:

```js
import { VoicingDictionary } from "tonal";
```

Nodejs:

```js
const { VoicingDictionary } = require("tonal");
```

## API

### VoicingDictionary

Maps a chord symbol to a set of voicings:

```ts
const lefthand = {
  m7: ["3m 5P 7m 9M", "7m 9M 10m 12P"],
  "7": ["3M 6M 7m 9M", "7m 9M 10M 13M"],
  "^7": ["3M 5P 7M 9M", "7M 9M 10M 12P"],
  "69": ["3M 5P 6A 9M"],
  m7b5: ["3m 5d 7m 8P", "7m 8P 10m 12d"],
  "7b9": ["3M 6m 7m 9m", "7m 9m 10M 13m"],
  "7b13": ["3M 6m 7m 9m", "7m 9m 10M 13m"],
  o7: ["1P 3m 5d 6M", "5d 6M 8P 10m"],
  "7#11": ["7m 9M 11A 13A"],
  "7#9": ["3M 7m 9A"],
  mM7: ["3m 5P 7M 9M", "7M 9M 10m 12P"],
  m6: ["3m 5P 6M 9M", "6M 9M 10m 12P"],
};
```

[show available dictionaries](./data.ts).

See [@tonaljs/voicing](../voicing) for usage examples.

---
_Source: https://npm.io/package/@tonaljs/voicing-dictionary · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._