Music Practice

by Sébastien Dubois
5
4
3
2
1
Score: 47/100

Description

Log practice with a timer, plan sessions, track mastery and catch what is slipping with spaced review, for guitar, piano and any instrument.

Reviews

No reviews yet.

Stats

1
stars
236
downloads
0
forks
22
days
1
days
2
days
33
total PRs
0
open PRs
10
closed PRs
23
merged PRs
102
total issues
26
open issues
76
closed issues
378
commits

Latest Version

2 days ago

Changelog

0.29.0 (2026-11-18)

Simplify this chart is a new command: on a note with a chord chart, it says which chords have an easier one and which capo gives the most open shapes, then switches them on in the chart or writes a simpler copy below it. The play bars get two things from music-notation 0.25.0, the library the plugin bundles: a Simplify switch on guitar charts, and the four guitars in the Sound menu.

Simplify this chart

  • What the window says: on a note with a chord chart (a chords block), the command lists the chords that have an easier one ("Easier chords: Cmaj9 → Cmaj7, G5 → G, E9 → E7") and the best capo, with the shapes to play. For Bb, Eb, F and Gm: "Best capo: fret 3. Play G, C, D, Em (4 of 4 open shapes)." Under it, a preview of the chart with both on (#68).
  • Switch on in the chart: writes {simplify} and {capo: auto} at the top of the block, each one only when it helps. The chart then draws and plays its easier version, and the chords you wrote stay in the block.
  • Insert a simpler copy: adds a new chart below the first one, written out: the easier chords in the lyrics, or the capo's shapes with a {capo: 3} line. The original chart doesn't change.
  • Only when it's easier: a chord changes only when a plainer chord of its family is easier to play. Am7 stays, because its open shape is easier than Am.
  • In the chart's own naming: the window names the chords as the chart draws them, in its {naming: …} line, else in Settings → Notation blocks → Note names. The copy keeps the chart's naming, so a chord that changes is written in it.
  • Several charts, piano charts, a capo already there: a note with several charts gets a list to pick one. A piano chart has nothing to offer: "Easier chords and the best capo are for guitar charts." A chart with its own capo ({capo: 2}) already holds the shapes you play, so the window looks for no other capo.

Play bars

  • The Simplify switch: the bar of a guitar chart gets a Simplify switch when one of its chords has an easier one. One click shows the easier chords in the lyrics and in the chords used row, and the switch reads Simplified. A second click brings back the chords as written. Nothing is written in the note.
  • Easier charts by hand: you can write {simplify} and {capo: auto} in a chart yourself, without the command. With both, [Bbmaj9]One [Eb]two [F]three [Gm]four draws Gmaj7, C, D and Em, with a capo on fret 3.
  • Four guitars in the Sound menu: the Sound menu on the bars of diagrams, strumming and picking patterns, progressions and charts lists "Guitar (steel)", "Guitar (nylon)", "Guitar (clean)", "Guitar (overdrive)" and "Piano". In 0.27.0, it still offered only guitar and piano.
  • It shows what plays: the menu shows the guitar in effect, from the block's guitar: line, else the note's guitar_sound property, else Settings → Playback → Guitar sound. A guitar you pick there plays for that block until the note is drawn again, and it changes neither the setting nor the note.

Other changes

  • In French too: the new texts are translated. The command reads "Simplifier cette grille", the switch "Simplifier" and "Simplifié", and the Sound menu "Guitare (folk)", "Guitare (classique)", "Guitare (son clair)" and "Guitare (son saturé)".

Enjoying this plugin?

README file from

Github

Music Practice

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.

The practice panel: a paused practice timer, a session list of three items with their mastery and BPM, Log this session, and the metronome

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 your session, and writes back what you did: the session note, the items you practiced, your BPM, your review results and the time spent on the activity. Your notes stay plain Markdown with frontmatter; Obsidian Bases can show all of it.

I built this because I'm learning guitar and piano again, and I wanted my practice to live next to the rest of my notes, with a system that tells me what to work on next, instead of a pile of songs and exercises I never get back to.

What changed in each version is in the changelog. What's coming is in the milestones and issues.

Screenshots

Plan a session for the time you have:

A 30-minute practice plan: a focus block of three items and a fun block, each with its mastery and minutes, and the Use in panel and Log this session buttons

Log what you practiced, with the minutes from the timer, or discard a timer you forgot:

Log practice opened from the timer: 12 minutes, the date, the items to tick with their mastery, a note, and the Cancel, Discard timer and Log practice buttons

Change an item's mastery, with what each level means for it:

Change mastery for a scale: the six levels, each with what it means for a scale, and the current one marked

Add a chord from its symbol, and pick its voicing:

Add a learning note for the guitar chord F#m7, with four voicings side by side and the note's name "F Sharp Minor 7 (alias F#m7)"

Practice a song's chords in time, as a backing loop with a click and the speed trainer:

Practice this progression in time: the strum, the tempo, Click and Count-in, the speed trainer, the chords G Em C D, Save BPM and Play

A chord chart with its chord diagrams, lighting the chord that plays:

The chord chart of Campfire Song with a row of G, Em, C and D diagrams, playing, with the C of the second line lit

Features

Practice

  • Log practice: record the minutes (or use the timer), the items you worked on, a quality rating, BPM and review results, and an optional note. One session note per practice, no duplicates. Undo the last log, from the notice or a command.
  • Practice timer in the status bar, with pause. It comes back after a restart. A timer that started more than 4 hours ago shows as forgotten.
  • Discard a forgotten timer: throw away a timer you forgot to stop, without logging it. It asks first and says how long the timer ran.
  • Practice plan: "I have 30 minutes" gives a warm-up, a focus block, due reviews and something fun.
  • Practice next: everything ranked by priority, staleness, BPM gap and what it unlocks.
  • Practice panel: the timer, your session list from a plan, BPM nudges, the metronome, Log this session.
  • Metronome and speed trainer: accents, subdivisions, tap tempo, a count-in and a beat flash, and the meter of the piece you practice. The speed trainer steps up to the note's target BPM, and Save BPM keeps the tempo you reached.
  • Practice a progression in time: a song's chords, one a bar or as its chart's bar lines say, as a backing loop with a click, a count-in and the speed trainer, to practice the changes or to solo over them. Save BPM keeps the tempo you reached.
  • Play along with a recording: a song's audio or video file of your vault, with an A-B loop, the speed from 50 % to 125 % without a pitch change, its sections to jump to or loop, and a count-in before each pass. Save BPM keeps the tempo you reached.
  • Chord change drills: count the changes between two chords in a minute. Your best and last counts go on the pair's note.
  • Note, chord and scale drills: find and name notes on the fretboard or the keyboard by clicking them, name chords and scales, find a scale's notes, and find a note you hear (drills by ear). The drill asks your weak spots most and keeps a map of them on its note.
  • Key, scales and hard changes of a piece: find a song's key and the scales to solo with, and drill its hardest chord changes first.
  • Mastery and spaced review: a rubric for each kind of item, and a light SM-2 review that catches what's getting rusty.
  • Skill tree: prerequisites between items, so you see what's ready to learn.
  • Shortcuts from outside Obsidian: Obsidian URIs start, stop or discard the timer, log, plan or pick what to practice next (phone shortcuts, Stream Deck, NFC tags).

The metronome on a 6/8 piece: tempo 76, "6/8 (2 beats), from the note", triplet clicks, a one-bar count-in, Flash, and the speed trainer up to 100

Chords, scales and voicings

  • Notation blocks: ```chord (guitar diagrams, piano chords), ```keyboard, ```fretboard, ```chords (ChordPro charts, transposable, with their chord diagrams), ```strum (strumming patterns), ```picking (fingerpicking patterns), ```progression and ```circle (the circle of fifths), drawn by the Music Notation library. Put several diagrams side by side (---), in any orientation, or left-handed. They work on Obsidian Publish too, through the library's loader.
  • Save diagrams as images: right-click a diagram or a block to save it as a PNG or SVG file, in the note's attachment folder or a folder you choose, with an optional link after the block. Copy as image on the block's bar copies it instead.
  • Notes draw their own diagram: an empty block in a chord, scale, arpeggio, strumming pattern or fingerpicking pattern note draws from the note's properties (chord, frets, fingers; scale root, type and shape; arpeggio notes their chord in its shape; strumming patterns their pattern, time signature, feel and tempo). Fingerpicking pattern notes draw their pattern, time signature, chord and tempo. They all draw on Publish too. Nothing is written twice.
  • Chords in words or frets: A Major, F Sharp Minor 7, or x02220 (the chord is recognized). Identify this chord names a chord note from its frets, its pitches or its name ("A Minor 7 - Open").
  • Click the notes: no need to know x32010. Click the frets on a fretboard or the keys on a keyboard to enter a chord; it is named as you click, and when the notes make no chord, the chords that hold them show with the notes they miss.
  • All the ways to play a chord: every playable voicing, easiest first, narrowed down by neck area and root string. Switch a chord note to one, or add it as its own note.
  • Triads on string sets, as learning notes titled with their string set and inversion. An inversion comes after its root position.
  • Chord transitions: the easiest way from one chord to the next, with the fingers that stay or slide marked, and tips. And the smoothest voicings for a whole progression.
  • Scales and modes: positions (boxes, CAGED, 3NPS), characteristic notes, comparisons, every mode of a key. Arpeggios in their CAGED shapes, the scale that fits a song's chords, and a chord's notes over a scale.
  • Strumming patterns: paste a pattern the way you find it on the web (D DU UDU), see it on a beat grid and hear it over its chords, straight or swung.
  • Fingerpicking patterns: Travis, alternate bass, 1-2-3-4 or your own (p i m a), as learning notes with mastery and BPM, played in time over a chord or a progression.
  • Progressions and the circle of fifths: write I V vi IV (or 1 5 6m 4) once and see it in any key, with a diagram for each chord, and play it in time. Chord charts play in time too, bar by bar when you write bar lines. The circle shows a key's chords on the wheel; click one to hear it.
  • Capo and piano voicings: a capo on any guitar chord or fretboard, with the chord it sounds. Piano chords in any inversion, shell or rootless, with both hands.
  • Simpler charts: Simplify this chart finds the chords of a song that have an easier one (Cmaj9 → Cmaj7) and the capo that gives the most open shapes, then switches them on in the chart or inserts a simpler copy. The Simplify switch on a chart's bar shows the easier chords without changing the note.
  • Note names: letters (C D E), solfège (Do Ré Mi) or German (H for B), as a setting for the diagrams and the drills (tabs and scores stay in letters), or with a naming: line in one block. Only the display changes: your notes stay in letters.

Six voicings of A, one per shape, each named: Open, G shape, Open strings, Open bass, E shape and Open bass

Tabs, scores and sound

  • Tabs and scores with playback: play, slow down, loop, metronome and count-in. Write them in alphaTex, or use a Guitar Pro / MusicXML file. Export to Guitar Pro 7 or MIDI, or print. Everything is bundled, so it works offline, and in popout windows too.
  • Tab exercises: turn a scale position or an arpeggio shape into a tab that plays in time, with a count-in and a speed control. Save BPM in the tab's player bar keeps the tempo you reached.
  • Hear the diagrams: click a chord, keyboard or fretboard diagram to hear it, or a dot to hear one note. One bar under each block plays its diagrams, one by one or all in turn. Chords strum, scales go up and down. Each note lights up on the drawing as you hear it.
  • Sound pack: better instrument sounds, as an optional download of 14.9 MB in Settings → Playback. Diagrams, patterns, progressions, charts, tabs and scores then play with it; without it, the built-in soundfont plays, offline (see Network use).
  • Four guitars: a steel-string acoustic, a nylon-string classical, a clean electric or an overdriven electric guitar plays the diagrams, patterns, progressions and charts. Pick one in Settings → Playback, for one note with its guitar_sound property (a classical piece on nylon), for one block with a guitar: line, or while you play, in the Sound menu of the block's bar.
  • Imports: Guitar Pro, MusicXML, Capella and ChordPro files, plus pasted text tabs (drum tabs too) and chord sheets. A text tab already in a note shows as tablature you can play, and Edit as alphaTex turns it into alphaTex. Tab, Score and Both in the player bar change the view.

A two-bar guitar part shown as notation over tablature, with the player bar and its Tab, Score and Both buttons

Your notes, your rules

  • Works with the Obsidian Starter Kit (note types, folders, templates and statuses come from it) or on its own: tag your notes type/music/guitar/chord and give them a mastery level.
  • Every rule is a setting: mastery levels, review intervals, score weights, plan blocks, the rubric, property names, playback. It installs with sensible defaults.
  • In English or in French: the plugin follows Obsidian's language. Only what you see is translated; the block syntax, property names and the values stored in your notes stay in English, so your notes work in any vault.
  • Commands for everything, and a public API so scripts and AI assistants can log and plan practice with the same rules.

Documentation

The user guide lives at https://dsebastien.github.io/obsidian-music-practice/ and grows with each release.

Installation

Then follow the getting started guide.

Network use

The plugin makes no network request by itself. The only network use is the optional sound pack, downloaded when you click Download in Settings → Playback → Sound pack. The files come from jsDelivr (cdn.jsdelivr.net), the public CDN of npm packages, from the package @dsebastien/music-notation-sounds at a fixed version. Nothing about you or your vault is sent: it's a plain file download. Every file is checked (its size and SHA-256 hash) before it's saved.

Development

Built with Bun and TypeScript from my Obsidian plugin template. See DEVELOPMENT.md and CONTRIBUTING.md; the rules the plugin implements are in documentation/Business Rules.md.

License

MIT License, see LICENSE.

The plugin embeds, unmodified: alphaTab (MPL-2.0), the Bravura music font (SIL Open Font License 1.1) and the SONiVOX soundfont shipped with alphaTab (Apache-2.0). Their notices and license texts are at the end of main.js.

The optional sound pack is not embedded: it's GeneralUser GS 2.0.3 by S. Christian Collins (GeneralUser GS License v2.0), downloaded only when you ask for it (see Network use).

News & support

To stay up to date about this plugin, Obsidian in general, personal knowledge management and note-taking:

If this plugin is useful to you, here are the best ways to support my work ❤️:

Found a bug or have an idea? Open an issue.