# Music Practice plugin for Obsidian
An Obsidian plugin for learning an instrument in your notes: log practice in under a minute, run a practice timer, get a plan for the time you have, and let spaced review tell you what's slipping. Guitar and piano first, any instrument after.
Every chord, scale, technique, exercise and piece you learn is a note with a mastery level: Want to learn, Learning, Can play slowly, Can play at tempo, Rusty, Mastered. The plugin reads those notes, ranks what to practice next, plans the session, and writes back what you did: the session note, the items practiced, BPM, review results and the time spent. Every rule (levels, review intervals, score weights, plan split) is a setting with sensible defaults.
It works on its own, or with the [[Obsidian Starter Kit]], which then provides the note types, folders, templates and statuses.
## What it does
The plugin covers the whole loop: what to practice, logging it, the notes you learn from, drills, playing in time, and the music in your notes. Ear training has its own section below.
### Practice, mastery and sessions
- **Practice next** ranks your learning notes, due reviews first, and **Practice plan** splits the minutes you have between them.
- Six mastery levels with a rubric per kind of item, and reviews that come back when an item is about to slip ([[Spaced repetition]]).
- A skill tree knows the prerequisites of each item and tells you what you're ready to learn.
- The practice panel holds the timer (with pause), your session list and **Log this session**, next to your notes.
- **Log practice** writes the session note, the items, the BPM, the review results and the time, in one dialog. You can undo the last log.
- Sessions follow the [[Obsidian Starter Kit]]'s rules. A session counts for the activity whose `session_types` lists its type; when none does, Log practice asks you to pick one, create one or log with no activity.
- Time comes from the sessions: the session note lists each item's minutes in `practiced_minutes`, and the activity's minutes and each item's `time_spent` are computed from the sessions. An activity's minutes are never lowered without asking (Keep or Drop), and logging the same session twice reuses its note.
### Learning notes
- Chord, scale, arpeggio, strumming pattern and fingerpicking pattern notes draw their own diagram from their properties, so nothing is written twice. Renamed properties work too, and a chord note without `chord_symbol` draws from `chord_root` and `chord_quality`, as the Obsidian Starter Kit's templates fill them.
- **Add a learning note** takes a chord as a symbol, in words or as frets, names it, and works out the fingers. A guitar chord shows its top voicings side by side, and **More voicings** the rest. Scale notes come with their positions (boxes, CAGED, three notes per string) and modes.
- You can click a chord instead of typing it: frets on a fretboard, or keys on a keyboard. The field and the drawing follow each other, and the chord is named for you. Piano chords also take typed keys (`C4 E4 G4`), with your spelling kept.
- When the notes you clicked make no chord, the chords that hold them are listed, with the missing notes marked; click one to use it.
- **Identify this chord** opens a fretboard or a keyboard when the note has no frets or keys yet. When the note's name says a chord, as on a note made from a template (`A Minor 7 - Open`), the window offers it too: one click on **Name it Am7, from the note's name** fills the symbol, root, quality, alias and shape (the shape only when the note has none).
- **Voicings of this chord** lists every way to play it, the easiest first, by neck area and root string. Add a voicing as its own chord note (each shape gets its own mastery), or switch a note to another fingering of its shape.
- Triads on string sets become their own notes, and **Easiest way** shows the voicings of the next chord that move the hand least, plus the smoothest voicings for a whole progression.
- Fingerpicking patterns are added from Add a learning note, with a preview. They need a learning note type with a `picking_pattern` property (mine is Guitar Fingerpicking Patterns).
- A piece note shows its key and the scales that fit its chords.
### Drills
- **Chord change drills** count changes per minute between two chords, kept on the pair's own note. The pairs come from your current chords (the slowest first) or from a piece's chart (the hardest first: how far the hand moves, then how often the song plays it).
- **Drill notes, chords or scales** (or **Drill**, then **Notes, chords and scales** in the practice panel) asks 20 questions, and each click plays its note:
- Fretboard notes: pick the strings and frets, then find a note ("Find C on string 5") or name the marked one.
- Keyboard notes: pick the lowest and highest key, then find a key or name the marked one.
- Chord names: name a chord from its diagram, among 4. The chords come from your chord notes (your current focus first), your pieces, what your focus needs, or the library, in one chord family if you want.
- Scale shapes: name a scale from its shape, or find its notes on the drawing.
- Fretboard by ear and Keyboard by ear: a note sounds, and you click where it is. **Play again** (or R) plays it again, **Reference** plays a reference note, **Reference note first** plays it before each question, and **Exact octave** asks for the very note instead of any octave of it.
- 6 questions in 10 go to your weak spots, the places you miss or answer slowly. A spot stops being weak after 3 right answers in a row, each under 2 seconds. These numbers and the 20 questions are settings.
- The score shows your right answers, your time and a map of your weak spots. **Save** keeps the drill in its own exercise note ("Fretboard notes, string 5, frets 0-5"), private (`public_note: false`), with its setting, the map and a review. **Log this drill** logs it with the practice timer.
- A chord or a scale with no note yet gets **Create note**, from its note type's template.
- Drill notes use `drill_kind`, `drill_setting` and `drill_stats`: add them to your guitar and piano exercise note types (with the `drill_kind` values `Fretboard by ear` and `Keyboard by ear`), or rename them in **Settings → Property names**.
- With playback off (**Settings → Playback**), drills by ear and ear training can't start.
- On a phone, keyboard drills start on one octave (C4-B4) and the setup shows one field per line. On touch screens, the clickable fretboards and keyboards are larger, and a tap doesn't move the note's cursor.
### Playing in time
- A metronome with a count-in, a beat flash and the note's time signature, and a speed trainer that steps up to your target tempo.
- **Practice this progression in time** plays a song's chords one a bar as a backing loop, with a click, a count-in and the speed trainer, to drill the changes or solo over them. It follows a chart's bar lines (dots, slashes, `%` bars, N.C.), plays `{define}` shapes and sounds where the capo puts the chords.
- **Insert a tab exercise of this scale or arpeggio** writes a position's run as a tab that plays in time (8ths, triplets or 16ths).
- **Save BPM** keeps the tempo you reached, on the backing loop and, in a learning note, on the tab, score, strumming, picking, progression and chart bars.
### Play along with a recording
A `playalong` block in a piece note plays a recording from your vault: an audio file (mp3, m4a, wav, flac, ogg, opus…) or a video (mp4, webm, mov…), whose picture shows. The block is a `file: [[Wonderwall.mp3]]` line, an optional `tempo: 87` line, then the song's sections, one a line (`0:00 Intro`, `0:12 Verse`, `0:45.5 Chorus`).
- Set A and B at the playhead (the buttons, or `[` and `]`) to loop a passage. Each pass starts 0.2 s before A by default, so the first note isn't cut (**Settings → Play-along**).
- The speed goes from 50 % to 125 % in 5 % steps, and the pitch stays the same.
- Click a section to jump there, or its loop button to loop it. **Add a section** (or M) writes a new section line at the playhead, while the music plays on.
- Before every pass, the metronome counts you in for one bar, at the recording's tempo times the speed. That tempo comes from the block's `tempo:` line, else the note's target BPM; tap it on the player (T) to write the `tempo:` line. The note's current BPM is NEVER used: it's the tempo you play at, not the recording's.
- Play adds the note to the practice panel's list, so Log this session logs it with the timer's minutes (the timer doesn't start by itself), and Save BPM offers the tempo it plays at (tempo × speed).
- One player plays at a time, never with the metronome or the backing loop. Keys on a focused player: Space or K, `[` and `]`, L, the arrows (5 s), − and +, C, T and M.
- Local files only (YouTube is a separate decision). Obsidian Publish shows the block as code.
### Music in your notes
Everything the [[Music Notation library]] draws works in your notes, in reading view and live preview: copy as image, full screen, Follow the music, note names on tabs and the rest. It's all bundled, so it works offline and in popout windows. What the plugin adds:
- Tabs and scores from text, from a plain-text tab, or from an import (Guitar Pro, MusicXML, ChordPro, chord sheets), with an export to Guitar Pro, MIDI or paper.
- **Easier chord charts**: in a chord chart, `{simplify}` draws an easier chord where a plainer chord of its family is easier to play (Cmaj9 becomes Cmaj7, G5 becomes G, E9 becomes E7; Am7 and F# stay), and `{capo: auto}` finds the capo that turns the most chords into open shapes (Bb Eb F Gm gets "Capo 3" and the shapes G C D Em). The chords you wrote never change. When a chord has an easier one, the chart's play bar gets a **Simplify** switch: it reads **Simplified** when on, and a second click brings back the chords as written. Guitar charts only.
- **Simplify this chart** does the work for you on a note with a chord chart. It lists the chords that have an easier one and the best capo, with the shapes to play and a preview, in the chart's own naming. **Switch on in the chart** writes `{simplify}` and `{capo: auto}` into the block; **Insert a simpler copy** adds a new chart below it, written out.
- **Settings → Notation blocks**: the default layout (vertical or horizontal, left-handed), **Note names** (Letters, Solfège or German) and **Root marks** (**Color**, or **Color and shape** to tell the root without seeing colors). A block's own `naming:` or `root-mark:` line wins.
- Note names reach the drills too: the questions ("Find Do on string 5"), the buttons, the answers ("It was La♯."), the map of weak spots, the fretboard and keyboard in Add a learning note, and the titles in Easiest way and Triads. Only the display changes: your blocks, note titles, properties and drill notes stay as written.
- **Settings → Playback**: the volume of everything that plays, heard at once, **Tab tempo**, the unit a tab bar shows first (BPM or percent; the unit button on a bar saves your choice), and the sound (below).
- **Four guitars**: chord diagrams, fretboards, strumming and picking patterns, progressions and chord charts play a steel-string acoustic (the default), a nylon-string classical guitar, a clean electric or an overdriven electric. A block's `guitar:` line comes first, then the note's `guitar_sound` property (a classical piece's note with `guitar_sound: nylon` plays all its blocks on nylon), then **Settings → Playback → Guitar sound**, heard at the next Play. Tabs and scores keep the instruments of their tracks, and a piano stays a piano.
- **The Sound menu** on the bar of diagrams, strumming and picking patterns, progressions and charts lists "Guitar (steel)", "Guitar (nylon)", "Guitar (clean)", "Guitar (overdrive)" and "Piano", and shows the guitar that plays now. A guitar you pick there comes first: it plays for that block until the note is drawn again, and it changes neither the setting nor the note.
- **Sound pack**: **Settings → Playback → Sound pack** downloads the instruments of the [[Music Notation Sounds library]] (GeneralUser GS, 14.9 MB) from jsDelivr, and checks each file against the size and hash that ship with the plugin. Nothing is downloaded until you click **Download**; without the pack, the built-in soundfont plays, offline. Obsidian Sync doesn't sync the pack, so download it on each device.
- **Settings → Playback → Sound** switches between the sound pack, the built-in soundfont and a light synthesizer. A block's `engine:` line asks for one, and when it isn't there, the next best one plays.
- Voicing, triad and transition grids keep their necks in line when a long name wraps, and every cell you can click shows the hand cursor.
- A public API for scripts and AI assistants, and links that start practice from outside Obsidian (`obsidian://music-practice?do=start-timer`).
### In French
The plugin follows Obsidian's language, and French is the first translation; every other language shows English. There's no setting: change the language in **Settings → General → Language**, then restart Obsidian. Everything is in French, the notation blocks included, with the words French-speaking guitarists and teachers use: a strumming pattern is a "rythmique", a scale box a "position", the speed trainer "Montée en tempo".
What stays in English, on purpose: the block syntax, the property names and the values the plugin writes, so a note from a French vault works in any vault. Your own level names and rubric lines stay as you typed them. The user guide is in English.
## Ear training
Hear an interval, a chord, a scale or a scale degree, then name it. Run **Ear training: intervals, chords, scales and degrees**, or **Drill**, then **Ear training** in the practice panel. There are four kinds:
- **Intervals by ear**: from a minor second (m2) to two octaves (P15), going up, going down or together.
- **Chords by ear**: major, minor, diminished, augmented, sus and 7th chords, as a block (all at once) or an arpeggio (one by one).
- **Scales by ear**: major, natural, harmonic and melodic minor, the two pentatonics, the blues scale and the modes (dorian to locrian).
- **Degrees by ear**: a I-IV-V-I cadence sets the key, then you name the degree of one note. Diatonic degrees only, or the chromatic ones too (b2, b3, #4, b6, b7), in any major key or a fixed one.
Each question plays on piano or guitar. **Play again** (or R) plays it again, **Key** replays the cadence before the note (degrees only), and **Show me** gives the answer, which counts as a miss.
Guided mode is on by default. It starts with the two items that are easiest to tell apart (an octave and a major third, or major and minor) and adds the next one once you know them all. So you learn to tell two sounds apart for sure before a third joins, instead of guessing among twelve intervals from the first question. Ear training also has its own **Fast answer** time, 4 seconds by default (the other drills use 2), because naming what you hear takes longer than finding a note you see. A right answer faster than that counts toward clearing a weak spot.
The rest works like the other drills: 20 questions, your weak spots asked most, a map of them in the score, and a spaced review. Each drill and setting gets its own music exercise note (`exercise_kind: Ear training`), such as "Intervals by ear, m2-P8, up, piano (Music Exercise)". In your own vault, add the four `drill_kind` values (`Intervals by ear`, `Chords by ear`, `Scales by ear`, `Degrees by ear`) and the three drill properties to your music exercise note type.
**Ear training setup**: Intervals by ear on piano, the 24 intervals from m2 to P15 (the first octave picked), going up.
![[Music Practice plugin for Obsidian - ear training.png]]
**An ear training question**: Chords by ear (major, minor, diminished, augmented, as a block, on piano), question 1 of 20, with Play again, Show me and the four answers.
![[Music Practice plugin for Obsidian - ear training question.png]]
## Status
Published in the Obsidian community directory. Install from **Settings → Community plugins → Browse**, search for "Music Practice". Progress is tracked in the GitHub milestones and issues, and the release notes list what changed in each version: https://github.com/dsebastien/obsidian-music-practice/releases
## Try it
The diagrams below are live. They're plain-text blocks in this note, drawn on this site by the same library the plugin uses. Click a diagram to hear it, or press play on the bar under a block! The picture button at the end of each bar copies the diagram as an image.
A shuffle strum over a blues change (`swing: yes` swings the 8ths).
```strum
[E7]D DU UDU | [A7]D DU UDU
swing: yes
title: Shuffle strum
```
An A shape with a capo on fret 2. It sounds B.
```chord
A x02220 x01230
capo: 2
sounds: yes
```
The most common pop progression, written once as numerals and drawn in G.
```progression
I V vi IV
key: G
```
E minor on the circle of fifths: its chords, with the B of the harmonic minor marked as V.
```circle
key: E minor
```
The five CAGED shapes of an Am7 arpeggio, up the neck.
```fretboard
arpeggio: Am7
positions: all
columns: 3
```
One of those shapes on its own, the way an arpeggio note draws it: the G arpeggio in its E shape. In your vault, a note named `G Major - E (Guitar Arpeggio)` draws this from its properties.
```fretboard
arpeggio: G
shape: E
```
The first A minor pentatonic box with its formula and steps under it, and the roots (A) drawn as squares, so you can find them without telling the colors apart.
```fretboard
scale: A minor pentatonic
position: 1
caption: formula
root-mark: shape
```
Want to write your own? The [[Obsidian Starter Kit - Tutorial - Writing music notation in your notes|notation tutorial]] learns a whole song with these blocks.
## Screenshots
### Practice
**Practice next**: what to work on now, due reviews first.
![[Music Practice plugin for Obsidian - practice next.png]]
**Practice plan**: a plan for the minutes you have.
![[Music Practice plugin for Obsidian - practice plan.png]]
**Log practice**: one dialog for the whole session.
![[Music Practice plugin for Obsidian - log practice.png]]
**Change mastery**: with the rubric for the item's kind.
![[Music Practice plugin for Obsidian - mastery.png]]
**Add a learning note**: a scale with its position drawn as you pick it (A minor pentatonic, box 1), or a chord from its symbol, with its top voicings side by side.
![[Music Practice plugin for Obsidian - add a note.png]]
![[Music Practice plugin for Obsidian - add a chord.png]]
**Add a fingerpicking pattern**: the pattern, the time signature and the chord, with the tab it plays in the preview.
![[Music Practice plugin for Obsidian - add a fingerpicking pattern.png]]
**Practice panel**: the timer, your session list and Log this session, next to your notes.
![[Music Practice plugin for Obsidian - practice panel.png]]
**Metronome**: with the speed trainer on.
![[Music Practice plugin for Obsidian - metronome.png]]
**Progression in time**: a song's chords as a backing loop, with the strum you pick.
![[Music Practice plugin for Obsidian - progression in time.png]]
**Tab exercise**: pick the direction, the rhythm and the tempo; the preview draws the position and its tab.
![[Music Practice plugin for Obsidian - tab exercise.png]]
**Chord change drill**: pick a pair for a minute of changes.
![[Music Practice plugin for Obsidian - chord change drill.png]]
**Chord changes of a piece**: a song's changes, the hardest first, each one a drill away.
![[Music Practice plugin for Obsidian - chord changes.png]]
**Key and scales of a piece**: the key, the scales that fit, and the first one on the neck.
![[Music Practice plugin for Obsidian - key and scales.png]]
**Voicings of this chord**: G, each shape named (Open, E shape, A shape…).
![[Music Practice plugin for Obsidian - voicings.png]]
**More voicings** in Add a learning note: the voicing you pick, with its shape, for the new note.
![[Music Practice plugin for Obsidian - more voicings.png]]
**Triads**: a key's triads on a string set, R, 3 and 5 in the dots.
![[Music Practice plugin for Obsidian - triads.png]]
**Easiest way between two chords**: the fingers that stay or slide marked, with tips in plain words.
![[Music Practice plugin for Obsidian - easiest way.png]]
**Tabs and scores**: a tab with its player.
![[Music Practice plugin for Obsidian - tab.png]]
**Play along**: a recording in a guitar arrangement note, the Verse looped at 85 %, a count-in at 90 BPM from the note's target, and the song's sections from Intro to End, each with its loop button.
![[Music Practice plugin for Obsidian - play-along.png]]
**Play along with a video**: the picture above the player, Part A looped at 75 %, the tempo from a tapped `tempo:` line (185 BPM), and a line the block can't read named under the player ("Line 5 is not a section: write 0:12 Verse").
![[Music Practice plugin for Obsidian - play-along video.png]]
**Fretboard drill**: "Find C on string 5" on strings 4-6, frets 0-7. The wrong pick on fret 2 is crossed, the right fret (3) is checked, and the drill says "It was C."
![[Music Practice plugin for Obsidian - fretboard drill.png]]
**Keyboard drill**: "Find A#3" on the keys C3-B4, with the right key checked ("Right.").
![[Music Practice plugin for Obsidian - keyboard drill.png]]
**Click a chord**: in Add a learning note, the frets clicked on the fretboard fill the field (x32010), and the chord is named C, with its diagram.
![[Music Practice plugin for Obsidian - click a chord.png]]
### Notation
Drawn from plain-text code blocks: a row of guitar chords (G, C, D), a Cmaj7 shell on piano with both hands and the fingering, D dorian on a keyboard with its 6 marked, the first A minor pentatonic box, and a chord chart with its diagrams.
![[Music Practice plugin for Obsidian - guitar chord.png]]
![[Music Practice plugin for Obsidian - piano chord.png]]
![[Music Practice plugin for Obsidian - keyboard.png]]
![[Music Practice plugin for Obsidian - fretboard.png]]
![[Music Practice plugin for Obsidian - chord chart.png]]
**A chord chart playing in time**: one chord a bar, the chord that plays lit.
![[Music Practice plugin for Obsidian - chart playing.png]]
**Fingering in words**: `caption: fingering` on A, F and D writes how to play each chord under its diagram ("Strum from the 5th string (A). Index on the D string, 2nd fret.", "Index bars the 1st fret, strings 1 to 6.").
![[Music Practice plugin for Obsidian - fingering in words.png]]
**Both hands' scale fingering**: `fingering: auto both` on G major draws the right hand (1 2 3 1 2 3 4 1…), then the left hand an octave lower (5 4 3 2 1 3 2 1…).
![[Music Practice plugin for Obsidian - both hands fingering.png]]
**The chords of a scale**: `harmonize: sevenths` in A harmonic minor, with the play bar: i(maj7) Am(maj7), iiø7 Bm7b5, bIII+maj7 C+maj7, iv7 Dm7, V7 E7, bVImaj7 Fmaj7 and vii°7 G#dim7, each with its guitar diagram.
![[Music Practice plugin for Obsidian - harmonize.png]]
**Play bar under the block**: I V vi IV in G, with its bar under the chords and the tempo written out (100 BPM). Click a chord to hear just that one.
![[Music Practice plugin for Obsidian - Play bar under the block.png]]
**Note names in solfège**: `naming: solfege` on a row of chords (Do, Ré m7, Sol, La m) and on a fretboard scale (Do major, E shape), with the dots and the string names in solfège too.
![[Music Practice plugin for Obsidian - solfege note names.png]]
**Formula captions**: `caption: formula` under Am7, Cmaj7 and G7 writes each chord's notes, its formula and the other ways to write it. The picture button at the right end of the play bar is Copy as image.
![[Music Notation library - formula captions.png]]
**Root marks as shapes**: with **Root marks** on Color and shape, the roots of C, Am and F are squares with the finger inside, so are the A's of the first A minor pentatonic box, and the D keys of a D major keyboard get a small square. Each bar ends with Copy as image.
![[Music Notation library - root marks as shapes.png]]
## References
- Community directory: https://community.obsidian.md/plugins/music-practice
- Documentation: https://dsebastien.github.io/obsidian-music-practice/
- Source code: https://github.com/dsebastien/obsidian-music-practice
- Roadmap: https://github.com/dsebastien/obsidian-music-practice/milestones
## Related
- [[Music Notation library]]
- [[Music Notation Sounds library]]
- [[Guitar (MoC)]]
- [[Piano (MoC)]]
- [[Music Theory (MoC)]]
- [[Spaced repetition]]
- [[Deliberate Practice]]
- [[Kanban Action Planner plugin for Obsidian]]
- [[Obsidian Starter Kit]]