Seris Loom: Harmonia

Interactive music theory tools for Obsidian. Explore keys, scales, chords, modes, and progressions without leaving your vault.

Features

Circle of Fifths

An interactive SVG circle with clickable major and minor keys. Select any key to instantly see:

• Key signature and accidentals
• Relative and parallel keys
• Diatonic chords with Roman numeral analysis (I, ii, iii, IV, V, vi, vii)
• Common chord progressions (I-V-vi-IV, ii-V-I, and more)
• Modes derived from the selected key

Audio Playback

Hear scales and individual chords using a built-in Web Audio synthesizer. No external dependencies or samples required. Toggle audio on/off and adjust volume in settings.

Copy to Clipboard

One-click copy of key information — paste scale notes, chord names, and progressions directly into your notes.

Multiple View Modes

Open the Circle of Fifths in a sidebar panel, a new tab, or a popout window. Use the ribbon icon or command palette.

Usage

1. Click the music note icon in the ribbon, or use the command palette: Harmonia: Open Circle of Fifths
2. Click any key segment on the circle (outer ring = major, inner ring = minor)
3. Explore the detail panel — click individual chords to hear them
4. Right-click a key for additional options
5. Hit Copy to paste key info into your notes

Commands

Command	Description
Open Circle of Fifths	Opens in the right sidebar
Open Circle of Fifths in new tab	Opens as a tab
Open Circle of Fifths in popout window	Opens in a separate window

Settings

• Audio playback — Enable or disable chord and scale audio
• Volume — Adjust playback volume

Installation

From Obsidian Community Plugins

1. Open Settings > Community Plugins > Browse
2. Search for "Harmonia"
3. Click Install, then Enable

Manual Installation

1. Download main.js, manifest.json, and styles.css from the latest release
2. Create a folder called seris-harmonia in your vault's .obsidian/plugins/ directory
3. Copy the downloaded files into that folder
4. Enable the plugin in Settings > Community Plugins

Development

# Install dependencies
npm install

# Build for production
npm run build

# Watch mode for development
npm run dev

# Run tests
npm test

License

MIT