/obsidian-plugin-abcjs

Plugin which renders music notations from code blocks

Primary LanguageTypeScript

Obsidian ABC.JS plugin

Obsidian plugin which renders ABC music notation from code blocks using the abc language specifier.

Under the hood it uses abcjs library and supports all the features that abcjs provides.

Examples

Simple song

Example music sheet

```music-abc
X:1
T:The Legacy Jig
M:6/8
L:1/8
R:jig
K:G
GFG BAB | gfg gab | GFG BAB | d2A AFD |
GFG BAB | gfg gab | age edB |1 dBA AFD :|2 dBA ABd |:
efe edB | dBA ABd | efe edB | gdB ABd |
efe edB | d2d def | gfe edB |1 dBA ABd :|2 dBA AFD |]
```

Chorus music

```music-abc
X: 1
T: Chorus
V: T1 clef=treble name="Soprano"
V: T2 clef=treble name="Alto"
V: B1 clef=bass name="Tenor"
V: B2 clef=bass name="Bass"
L:1/8
K:G
P:First Part
[V: T1]"C"ed"Am"ed "F"cd"G7"gf |
[V: T2]GGAA- A2BB |
[V: B1]C3D- DF,3 |
[V: B2]C,2A,,2 F,,2G,,2 |
```

Custom options

You can pass custom options to the renderAbc function by adding a JSON string at the top of the code block followed by ---. Note that there may not be any whitespaces before or after the JSON.

Custom options example music sheet with tablatures

```music-abc
{
  "tablature": [{"instrument": "violin"}]
}
---
X:1
T: Cooley's
M: 4/4
L: 1/8
R: reel
K: G
|:D2|EB{c}BA B2 EB|~B2 AB dBAG|FDAD BDAD|FDAD dAFD|
```

When the JSON is invalid, the plugin will still try to render the music block but shows a big red banner at the top with the error so you can't miss it.

For a full reference of all options you can use, have a look at the official abcjs documentation.

Maintenance & Contributions

The plugin is maintained by the abcjs-music organization of volunteers, including Til Blechschmidt, the original author. If you have any feedback, please feel free to open an issue. If you know your way around source code, please consider making a pull request! All contributions are welcome.

Development

Clone the repository, run npm i to install all the dependencies. npm run build, then copy main.js, manifest.json, and styles.css into your plugin directory (.obsidian/plugins/<plugin-name>)