Renderer for abc music notation
npm install abcjsThis library makes it easy to incorporate sheet music into your websites. You can also turn visible ABC text into sheet music on websites that you don't own using a greasemonkey script, or change your own website that contains ABC text with no other changes than the addition of one javascript file. You can also generate MIDI files or play them directly in your browser.
Full documentation is here: abcjs documentation
There is an organization that has a collection of useful projects related to abcjs called abcjs-music. See some examples there. If you have a project that you think would be of general interest and would like to add it to that organization, contact me.
This has the new feature chordGrid, which is a view of the chords similar to some of the trad jazz lead sheets. If you have chordGrid: "noMusic" then only the chords will show, if you have chordGrid: "withMusic" then the chords will print above the standard music.
There is also completely new handling for the repeated sections that can handle more complicated repeating patterns. This should make more charts play correctly but it might cause an issue if you are counting on the old behavior.
The method for creating chord accompaniment has changed. Hopefully there aren't any regressions but if you have an example that doesn't match what it used to be, please open an issue.
Most users won't see any difference, but there was some changes to the underlying SVG structure for the top (the title, etc.) and bottom (the notes, etc.) text, so if your code depends on particular classes then this might be a breaking change. Hopefully the new structure will be clearer and will allow css to target particular parts easier.
There was a major bug in Firefox 112 that causes some lines to disappear. That is supposed to be fixed in Firefox 113 but in the meantime this update will take care of the problem.
There is a little difference in the generated SVG: Now each line is surrounded with a
There is a brand new transposing feature. This allows you to input an ABC string and get a new ABC back in a different key. See the documentation for details. I'm sure there are ways to expand this - let me know if your use case is missing.
After way too long, abcjs 6.0.0 is now out of beta.
There are only a few bug fixes since the last beta.
The current plan is to continue doing bug fixes and minor features to the 6.x.x branch, but version 7 is already in planning.
There are some minor features that will still be added to the version 6 branch, along with fixing transposition.
There will be some architecture changes which will go in a 7.0.0 release:
* Improve the API for controlling the synth. That is, make the parameters less confusing.
* Create a plugin architecture so that large features that are not widely used can be added without bloating this library.
* Change the build to use typescript while still maintaining legacy browser capability.
* Reduce the size of the library by optimizing code.
* Control the spacing of the elements on the line better: support equal size measures, and support allowing control of the spacing between notes.
* Improved documentation, particularly for synth.
* Bug fixes.
I anticipate that for a user that wants the most common functionality, the size of the library might be cut in half.
Thanks, Paul
String tablature is now available by adding an option to the renderAbc parameters. See tablature documentation
If you are using an octave clef (for instance K:C clef=treble-8) it will now sound an octave different. The octave calculation was happening twice.
The file abcjs version supporting midi.js is the last version of the old style of sound production that will receive updates.
mainThe default branch is now named main. If you have cloned this repo previously, you can change it with:
``shell`
git branch -m master main
git fetch origin
git branch -u origin/main main
Be sure to download the latest abcjs-audio.css file if you are using it. If you are styling the audio control with your own css, add the rule:
`css`
.abcjs-css-warning {
display: none;
}
Old versions of abcjs have been removed from this repo. If you are looking for them, you can find them here: Historical Versions
The midi.js package is no longer a direct dependency, it is now a peerDependency so it is not included by default. That way, users who aren't using the old style of sound generation won't need to load the package. If you are using the old style that uses midi.js, include this line in your package.json file:
`
"midi": "https://github.com/paulrosen/MIDI.js.git#abcjs"
Note that if you are using the minified version of the library with a