Javascript library for rendering standard music notation in a browser.

This 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.

List of Examples

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.

Announcement: version 6.4.0

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.

Announcement: version 6.3.0

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.

Announcement: version 6.2.2

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.

Announcement: version 6.1.2

There is a little difference in the generated SVG: Now each line is surrounded with a <g> element. This probably won't affect your program unless you are doing very specific manipulation of the SVG.

Announcement: version 6.1.0

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.

Announcement: version 6.0.0

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.

Informal roadmap for version 7.0.0

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

Major New Feature! 6.0.0-beta.36

String tablature is now available by adding an option to the renderAbc parameters. See tablature documentation

Fix to audio in octave clefs 6.0.0-beta.31

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.

Last version supporting midi.js is 6.0.0-beta.28

The file abcjs version supporting midi.js is the last version of the old style of sound production that will receive updates.

Rename the default branch to main

The default branch is now named main. If you have cloned this repo previously, you can change it with:

git branch -m master main
git fetch origin
git branch -u origin/main main

New css for audio control 6.0.0-beta.27

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:

.abcjs-css-warning {
    display: none;
}

Historical abcjs Packages 6.0.0-beta.27

Old versions of abcjs have been removed from this repo. If you are looking for them, you can find them here: Historical Versions

Breaking change when using midi.js for 6.0.0-beta.26

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 <script> tag this does not apply to you.

Change in wrapping behavior for 6.0.0-beta.25

There have been some tweaks to the way wrapping is calculated. Hopefully this will make your music layout a little better. If you start seeing odd results, let me know.

Change in output folders for 6.0.0-beta.25

The files in /bin are being phased out. You can get the executables from /dist and the file names will not have the version number attached.

Many of the old versions that were in /bin are no longer kept in the active branches. If you need a particular old version then you can go to the branch with that tag to get it.

The last version in each major version number is still available in the active branch as well as many recent versions.

Default soundfont change for 6.0.0-beta.21

In this beta the default soundfont was changed to https://paulrosen.github.io/midi-js-soundfonts/abcjs/ Hopefully you will find that sounds better. If you set the soundfont directly then you won't notice any change. If you prefer the old soundfont, use the soundFontUrl: "https://paulrosen.github.io/midi-js-soundfonts/FluidR3_GM/" option when calling the synth functions.

Issues

Thanks so much for the bug reports and feature requests that are pouring into the issues. I appreciate you taking the time to help improve abcjs. This is not a full time project, though, so I can't promise a quick turn around on the issues. I am going to attempt to be caught up on responding once a week at least.

And I would love some help on this project, including documentation, bug fixes, testing, refactoring, modernizing tools, and adding features. If you are so inclined, please get in touch.

Supported by BrowserStack

If you aren't using the same browser and machine that I use, you can thank BrowserStack for their support of this open-source project.

Version 6.5.1

Bugs

• Fix regression crash in synth when there is both a dynamic decoration and other decoration on the same note.

• Remove debugging statement.

Version 6.5.0

Bugs

• Don't print first ending marks for second voice on the same staff.

• Fix spacing problem when there are empty free text blocks.

• Add octave and other clefs to the list for voice line, i.e. V:1 treble-8

• Test to be sure dataset exists for old browsers.

• Report more exceptions when failing to create synth.

• Don't use A#dim or D#dim when transposing.

• Allow space in key name when transposing.

• Fix crash when setting some directives before the first music line.

• Fix canceling a treble+8 clef.

• Fix playback of guitar chords in parentheses.

• Don't crash if CreateSynth doesn't have options passed in.

Features

• Allow notes in chords to be different volumes.

• Add %%maxstaves directive for creating incipits.

• Add more articles that can be reversed in titles.

• Add %%visualTranspose directive.

• Add %%keywarn support.

• Add filtering of ABC file header.

• Added trillh and pralltriller.

Version 6.4.4

Bugs

• Fix measure numbering when there are multi-measure rests.

• Fix crash when subtitle is right before setting the bar number.

• Don't allow the measure number to overlap the treble clef.

• Improved trill, mordent, and turn playback rendering.

• Increased measure number offset for wide measure numbers and treble clef.

• Not adding the top position if putting a measure number on the clef.

Version 6.4.3

Bugs

• If there is a slur or tie on the top or bottom of a line, make sure there is room for it.

• Fix for crash on malformed @ positioned annotations

• Fix call of getBpm() to use the specified tempo if it isn't supplied.

• Bring bass note in range if transposed out-of-range by a visual transpose

Version 6.4.2

Bugs

• Fix crash when there is a decoration on an invisible rest

• Fix crash when the same voice is set on a line

• Fix crash with rests in graces

• Fix crash with decoration on invisible rests

• Fix various crashes when declaring voices inline or after a line continuation

• Fix for */8 rhythm tempos for MIDI export

• Allow a midi volume of zero to mute a voice

• Fix bug in selecting the correct note for chord arpeggios

• Fix stemless chord parsing i.e. [AB]0

• Don't put lower decorations too low on beamed notes that are beamed up

Features

• add power chords

• add patterns for 5/8, 7/8, 10/8 and 11/8

• Add octave= parameter to bassprog and chordprog

• allow an empty gchord to cancel a previously set gchord

Version 6.4.1

Bugs

• fix regression when playing a specified sequence instead of using visualObj

• don't inject a bass note when chords change mid-measure if the pattern doesn't start on a bass note.

Version 6.4.0

Features

• Support custom rhythm patterns in gChords

• Add swing to the playback

• Allow swing, bassprog, bassvol, chordprog, chordvol, and gchord to be set in the options, and also on the fly.

• Add findSelectableElement and getSelectableArray functions to help with hover.

• Add drumOff to the parameters so that the metronome can only be for the prep beats

• Allow an element to be passed into to the EditArea object in addition to an ID

• Add left alignment option ot time-based-layout

• Add timeBasedLayout parameter

• Add "stafftopmargin" directive

• Add tuneMetrics function

Bugs

• Fix linespacing when using both oneSvgPerLine and scale

• fix placement of inverted fermata

• Fix end points of slurs when there are beams involved

• Fix bug with cursor not following a tie across a line break.

• Improve spacing on time-based layout when left aligned

• fix line distance when scaling

• fix abcjs-staff class appearing in two places

• fix bug in gchord sound when bass and chord programs are different

• Many small fixes to types

Version 6.3.0

Features

Tablature

• Add tab feature hideTabSymbol
• Add 5-string tab named "fiveString"

Synth

• change the default synth control options for "play" and "progress" to be true
• expose the MIDI creator function

Rich Text

• allow up to 9 custom fonts in %%setfont
• for rich text fields, escape two dollar signs
• allow rich text in all non-music fields
• give all non-music fields a unique class

Miscellaneous

• add abcjs-notehead class to note heads;
• add accentAbove parameter
• handle numbered tune names in the reverser
• support reversing tune names with ", a" and ", an", with a variable amount of whitespace and case-insensitive

Bugs

• fix placement of tab staff when there is no label
• fix font placement bugs
• remove spurious quotes in font name in svg attribute
• Fix the name of the abcjs-tab-number class
• Fix tab staff height when there is a label
• Fix for crash when rendering multiple tab staves
• Offset breath mark to the right
• Center text when using expandToWidest set true

Documentation

• add missing typescript types
• fix synth control types
• fixed some typescript types in the TimingCallbacks

Version 6.2.3

Features

• Add expandToWidest option

• Added synonyms for glissando: ~( and ~)

• allow passing in soundfont and debug callback when playing an event directly.

• Add a getIsRunning() function to enable play/pause

Bugs

• fix placement of triangle notehead

• Guard against crash when the synth note wasn't loaded.

• fix crash when skipping a staff when creating tablature

• protect against spurious mouse click in selection

• Add paddingleft to the size of the SVG - it was cut off if the padding was larger than the default.

• various typescript fixes

• afterParsing now works with line wrapping.

• Put start and end char on slurs so they can be selected.

• fixed type of timing callback: TimingEvent is now NoteTimingEvent

Documentation

• Add tablature to typescript types

• add missing items to documentation

Version 6.2.2

Features

• Make "mandolin" and "fiddle" synonyms for "violin" in tablature.

Bugs

• Don't draw staff line for tabs twice if there are two voices on it.

• make the staff line the correct width in Firefox.

• Fix bug in Firefox that causes staff lines, bar lines, and stems to be missing.

• Fix bug in Firefox that cuts off the last line of the SVG.

Version 6.2.1

Bugs

• don't crash if "capo" is passed in to tablature as a string

• fix possible crash if setTiming is called before engraving

• Fix bug in Firefox 112 that causes lines to be missing.

• Add more debug messages when creating synth

• Fix type of prime return

• Protect against crash when selecting an element if the element selected is somehow outside of the music svg.

Version 6.2.0

Features

• implement %%MIDI bassprog, bassvol, chordprog, chordvol

• Add support for [r: ... ] remark

• add support for %%voicecolor

• add germanAlphabet option: display chords using German music alphabet

• add lineThickness option: allow tweaking of the size of the lines

• add a public access to the audio buffer through CreateSynth.getAudioBuffer() so that it can be processed outside of abcjs

Bugs

• fix placement of ties when they extend to a new line

• fix crash with tablature and showDebug are used at the same time.

• fix bug in getting the location of the beat from TimingCallbacks when there are prep beats.

• Change D.C. and D.S. decorations to be right aligned

• fix metronome with changing meter

• don't indent unaligned words

• fix handling of accidentals in tablature

Documentation

• Improved the typescript types somewhat.

Refactoring

• Changed the names and moved a number of files in the engraver in anticipation of further refactoring.

• Did some simplification in tablatures.

Version 6.1.9

Features

• Add decorations for !D.C.alcoda!, !D.C.alfine!, !D.S.alcoda! and !D.S.alfine!

Bugs

• keep transposing from crashing when K:none.

• mark the touch events as passive to prevent jank.

• fix crash when the M: line is missing and drum intro is used.

• fix midi output when using percussion voice.

Documentation

• Improved the typescript types somewhat.

• Upgrade VuePress.

• Fix link for new synth in the docs.

Version 6.1.8

Features

• Implement 'octave' modifier for K: and V: fields.

Bugs

• Handle accidentals in a measure in tablature.

• Fix accidental handling in tablature when there is a key signature.

• Add a little padding when tablature doesn't have a label.

• Fix the css styles applied to tablature.

• Allow percmap to use higher octave pitches.

• Fix cursor movement when playing synth and tablature is visible.

Documentation

• Add example of getting lyrics out of a tune.

Version 6.1.7

Bugs

• don't draw measure numbers before the beginning of the line.

• guard against crash on touch selection

Testing

• open the browser and run the test-server in parallel

• add a minimal server for serving test pages

  Documentation

• Add example of getting lyrics out of a tune

Version 6.1.6

Bugs

• Fix error when selecting notes

Version 6.1.5

Bugs

• Fix error when selecting notes

Version 6.1.4

Bugs

• Fix error when selecting notes

Version 6.1.3

Bugs

• fix placement of tablature staff when there is extra space used above the staff.

• Fix regression crash when using 'y' spacer

Version 6.1.2

Bugs

• fix combining oneSvgPerLine with responsive: "resize"

• fix drawing audio controls when the outer stylesheet changes the button's lineHeight

  Version 6.1.1

Bugs

• rewrite oneSvgPerLine; fixes selection and keeping multiline items (like slurs) correctly.

Features

• added mobile browser TouchEvent support for dragging

Documentation

• fixed some typescript definitions

Version 6.1.0

Bugs

• Fix some bugs in startChar; endChar

Features

• Add transposing feature

Documentation

• Document transposing feature
• Clarify the way testing works
• Add tablature tests to "all"

Version 6.0.4

Bugs

• Fix position of staccato when a note is beamed and its stem is backwards.
• Write annotations above bar lines.
• fix placement of rhythm indicator (the R: field) on treble clef when there is nothing else above the staff.
• fix some broken tests; add test for staccato bug and rhythm word placement.
• fixed some Typescript warnings and errors

Features

• Recognize backslash to escape lyrics.
• Add glissando
• pass back the start and end char positions with the audio callbacks.

Documentation

• Add example of adding note names to a tune automatically.
• Add a mention for the VSCode extension.
• Add tune book example.

Version 6.0.3

Bugs

• Fix unhandled rejection if there is a problem with an input note when creating notes.

• put the height of ties/slurs in the line height calculation

• Measurements that used "px" were reporting a warning.

• Fix bass note in jazz chord when it contains a sharp or flat

Features

• Quotation mark in a chord can be escaped.

Documentation

• Add example of reusing created synth buffers.

• Fix example in docs on creating a drum rhythm

Version 6.0.2

Bugs

• Fix paper size so that the bottom of a narrow staff is not cut off.

• Fix example generator for synth

• Fix tablature parameter name and tuning examples

• Fix tablature default tuning for guitar (move A down octave)

Version 6.0.1

Bugs

• Make the printable example long enough to be on two pages.

• Fix paper size so that the bottom of a narrow staff is not cut off.

• Add a little padding to stems so they aren't cut off.

Version 6.0.0

Bugs

• Fix the bar number display when wrapping.

• Don't add extra padding when creating minimal music (like one note)

• Fix selection data for unaligned words

• Pass back actual selectable element when one of its children is clicked.

• Don't put extra classes and data- attributes on compound symbols (like "12/8")

• Fix spacing for triplet number

• Don't add extra space at the bottom if there is no bottom text.

• Allow aria-label to not be set.

• Fix adding class names to dynamics and some other elements.

• Fix regression where the left line of multi-staff music was misplaced if the bottom line is for percussion.

• gracenotes now are processed through %%percmap

Version 6.0.0-beta.39

Bugs

• Add some info to the return of the prime() method

• Fix iOS not playing because audioContext doesn't stay running

Version 6.0.0-beta.38

Bugs

• Regression: Fix return of CreateSynth.init

• Don't do audio on tablature lines.

• Wait until all notes are loaded before continuing to build audio buffer. (Caused the beginning of the buffer to possibly be arpeggiated if there is a race condition.)

• Don't crash when there is a blank staff on the second line.

• The pan option now works if the actual number of tracks doesn't match the panned tracks.

• Don't add chord track if it is empty.

Documentation

• Get more detailed with the typescript declarations

Version 6.0.0-beta.37

• Keep the correct line count when generating one svg per line. (Fixes analysis of the tune for playback and timing)

Features

• Change the default soundfont to the improved Fluid one; add the anticipations on the abcjs soundfont.

Version 6.0.0-beta.36

Bugs

• Fix some typescript definitions.

• When stopping synth, return the position that it stopped at.

• Implement a fix for race conditions during note loading

• Don't call debugger when setting an annotation on an invisible note.

• Put try/catch in editor when creating music so there isn't an unhandled exception if there is an abcjs bug.

• Don't crash when creating audio and there is a suppressed blank line

• When suppressing blank lines, consider a line with only chords as not blank.

• Don't add too much spacing on chord symbols when placing them.

• Don't lose element's scrolling position when rendering music.

• Fix crash when creating timing array and there is a suppressed line because it is empty.

• Allow soundFontVolumeMultiplier to be set to zero.

Features

• Add string tablature

• Implement %%jazzchord directive

Documentation

• Add example page using multiple synths with program switcher

• Add jazzchords to example generator

Version 6.0.0-beta.35

Bugs

• Fix regression on creating oneSvgPerLine

• Fix notes that are one step apart from colliding.

• Fix crash on bad notelength

• Fix note durations in triplets where p != r

• Don't crash if a browser doesn't contain AudioContext

• Don't swallow warning after wrapping.

• Fix some regressions with placing and styling text.

• Fix font on relatively positioned annotations.

• Protect the editor from crashing when synth is attempted and the browser doesn't support AudioContext.

Features

• Create parameter jazzchords

• Add many types to the typescript definitions.

• Add units to TimingCallback.start

• Add staccato to midi creation.

• Add classes to dynamics elements.

• Add more info to the click handler

• Limit the size of the warning message if there is a long string.

• Add initialClef option

• Keep and pass back current time from the timer callbacks.

Documentation

• Fix path for favicon in docs

• Tweak to printing example

• Move examples to github pages.

• Add MIDI download example.

• Fixes to doc building from the vuepress upgrade.

• Add mention of a CDN to load library from.

• Add a couple of errors to analysis demo to show the warning data.

• Option to only render the clef on the first line.

Version 6.0.0-beta.33

Bugs

• Fix crash when there is a missing close bracket on an inline command.

• Fix the startChar position of chords

• Fix overriding the tempo.

• Fix passing qpm in.

• Fix stem direction bug on wrap.

• Fix bug in calculating the endpoint of the audio when there are multiple voices.

Features

• Add getBarLength() and getTotalTime() to the tune object;

• Add second parameter to seek() for the units percent, seconds, and beats.

• Add detuneOctave parameter

Documentation

• Example of controlling the tempo.

Build

• Remove bin folder

Version 6.0.0-beta.32

Bugs

• Some fixes to startChar and endChar when there are line continuations

• Error messages now report the absolute line in the file that the error occurs, not the offset from the first music line.

• Fix bug where multiple text lines would duplicate text.

• a b !+!c removing the end ! from the !+! will cause the decoration to bleed to the first element in the line.

• Fix audio control buttons on Safari

• Make creating audio more efficient. (was creating buffer twice as long as needed.)

• Fix click-a-note-to-play-it to handle microtones.

• Get rid of audio warning when key changes.

• Fix Safari not making sound when first using playEvent.

• Fix crash when wrapping when using oneSvgPerLine.

Features

• Change the pitch change variable from "warp" to "cents".

• support microtones in midi output.

Refactoring

• Improvements to the handling of line continuations

• Remove some midi.js remnants

• Refactoring of the parser

Build

• update dependencies and fix webpack for v5

Documentation

• Add microtone demo.

• update docs to vuepress2

Version 6.0.0-beta.31

Bugs

• Fix crash when no key signature is passed in.

• Octave clefs were double transposing.

• Made the audio control more robust in dark mode and when the page's css defines basic buttons.

Features

• Support audio for quarter sharp and quarter flat.

• Allow getMidiFile to accept a tune object as well as a string.

Build

• Remove more of the midi.js code

• Deliver the /dist folder for npm.

• Add entry points for testing.

• Start of parser refactoring

Version 6.0.0-beta.30

Bugs

• Fix npm deployment.

Version 6.0.0-beta.29

Bugs

• Fix stem direction on overlay voices.

Features

• Add support for invisible multi-measure rest "X"

• enhance typescript types

Build

• Remove build of midi version

• Simplify the webpack config

• Remove references to "master"

Version 6.0.0-beta.28

Bugs

• Fix some problems with the visual synth control getting out of sync with the music.

• Fix stem direction on overlay voices.

• Don't print accidentals on percussion staves.

• Keep dragging notes from jumping around when the svg is scaled (on Chrome & Safari)

• Fix placement of multi-measure rest.

• Fix crash when using the parser twice instead of creating a new one.

• Fix bug in drawing slurs over the end of a line when there is more than one staff.

• Fix bug in counting measures in the element classes.

Features

• Support dark mode.

• Add support for %%percmap, allowing specifying a shape for each sound.

• Implement the audio for %%percmap.

• Add "triangle" as a note head shape.

Documentation

• Add a "Start here" section to the demo TOC.

• Add demo of tune analysis; fix docs on tune analysis

• Add "zoom to fit" demo.

Build

• Move SVG to separate files.

Version 6.0.0-beta.27

Bugs

• Fix regression bug with setting the tempo when there is no Q: in the ABC string.

• Fix measure class numbering when the line starts with a bar line.

• Fix slur placement over a line break when there is more than one voice.

• Recreate audio when changing the tune in the editor.

• Fix wrapping crash when the first line in the tune is a subtitle.

• Fix synchronization of timing callbacks after changing the tempo.

• Fix regression bug when creating audio buffer in Safari.

• If an audio context is passed in, always use it.

Documentation

• Add warning if audio CSS is missing.

• Improve the animation demo.

• Add warning if a nonsensical rhythm is encountered.

• Add warning if audio CSS is missing.

• Change default branch to main

• Add links and info for old versions.

• Redo the animation demo.

• Add responsive demo.

• Change alt text for example's logo

• Some tweaks to transposition demo.

Version 6.0.0-beta.26

Build

• Added types for TypeScript for renderAbc function

• Change midi.js to a peerDependency.

Accessibility

• Add foregroundColor parameter and set the default to currentColor (for high contrast)

• Add option to set the aria-label; by default aria-label is set to the title.

Bugs

• Fixed some regressions in changing the audio tempo.

• Fix some timing and crashing issues on synth.

• Fix the currentTrackMilliseconds for meters with eighth note denominators that are not compound.

Features

• Add support for triple broken rhythm symbols >>> and <<<

• Add minPadding parameter to keep the notes from getting too close together on crowded lines.

• Change the fadeLength default to 200ms

Version 6.0.0-beta.25

Bugs

• Fix the way pause/resume is handled in the timing callbacks.

• Fix problems with changing the tempo with "warp"

• Keep key sig changes when wrapping.

• Make wrapping use one less line in some cases.

• Fix crash when wrapping music that has unusual voice mismatches.

• Fix meter display when wrapping.

• Prevent out of memory when wrapping long tune.

• Fix some cases where P: and Q: were not handled correctly.

• Fix changing tempo when there is a repeat.

• Fix audio seek: Seek percent should take the fade length into account.

• Fix crash when a tie is right before a repeat sign.

• Improve error handling when creating audio.

Features

• Add entry point in synth controller to programmatically seek

• %%stretchlast takes a number parameter

• Deliver the elapsed time in whole notes as well as milliseconds in the timing callbacks.

• Return the position of the notehead in the click listener.

• Add SynthControl.disable() so that the user can't click on the control before the tune is ready.

Tasks

• Remove many old versions of the minified releases.

• Change the destination folder for the build.

• Refactor wrapping

Documentation

• Some clarification of the build process in the docs.

• Create the example generator.

• Add FAQ

• Some tweaking to the demos; create demo table of contents.

• Add a little css for the examples

• Improvements to examples/basic-transpose.html

• Disabled spellcheck for ABC input textareas

• Document afterParsing function

• Document synthParamChanged

Version 6.0.0-beta.24

Bugs

• If there are pickup notes and a drum track, don't start drum until the first full measure.

• If a dotted slur crosses a line, the slur on the next line should also be dotted.

• Make the audio buffer a little longer so the last note can fade out more naturally.

• Fix abcjs-mmXX class when there are non-music lines present.

• Fix height of bottom text: it was calculating a line too many.

• Fix a couple of crashes when calculating the timing of a tune.

• Fix documentation about how to directly play sound.

Features

• Add resets to MIDI file; carry forward "pan" option to MIDI file.

• %%titleleft should also affect subtitle.

• Add class for the measure count from the start of the tune.

Version 6.0.0-beta.23

Bugs

• Fix calculation of bottom text height when there are blank lines.

• Center chord symbols better.

• Fix crash in the timer when lineEndCallback is not specified.

Features

• Add the staff Y coordinates to the clickListener.

• Implemented %%titleleft

Version 6.0.0-beta.22

Bugs

• Fix crash in audio when there is an odd measure that contains chords.

• Fix definition of some jazz chords, particularly the 13th

• Fix timing on multiple voices when the tempo changes.

• Fix downloading WAV files in stereo.

• Fix the last line in the line end callbacks.

• Simplified and fixed some edge cases when seeking; added return value for eventCallback.

• Fix tempo change in multiple voices

• Fix the reporting of measure numbers in the timing callbacks when there are multiple voices.

• Add more info to the lineEndingCallback so the client can see all of the lines.

• Fix the alignment of %%center text.

• Don't crash if the current beat is later than the last event (can happen when the animation timer is delayed)

• Fix line end callback anticipation handling.

• Fix lower volume of default soundfont to prevent clipping.

• Fix crash when doing audio for tune with subtitle

Features

• Add programOffsets parameter for audio.

• Handle %%MIDI channel 10 when it is in the middle of a tune.

• Add the note style (grace or decoration) to the sequenceCallback.

• Add classes for pinpointing where slurs start and end (abcjs-start-m0-n0, abcjs-end-m0-n0)

• Round many paths to 2 dec. places; add "abcjs-dotted" to dotted slurs.

• Add abcjs-dynamics class to the !f!, etc. symbols.

• Differentiate between slurs and ties in the classes.

• Add more info to the lineEndingCallback so the client can see all of the lines.

• Add some details about the beat callback to straighten out doing a smooth cursor.

Version 6.0.0-beta.21

Bugs

• Don't require soundFontUrl to end in a slash.

• Force stretchlast on all lines except the last when printing one svg per line.

• Fix placement of brackets and braces when there are two voices on a staff.

• Fix typo in lead_8_bass_lead instrument name.

Features

• Added soundFontVolumeMultiplier parameter;

• made the abcjs soundfont the default.

Version 6.0.0-beta.20

Bugs

• Fixed bug in smooth cursor when repeat is on one line.

• Fix timing callbacks calling stop() when playing in a loop.

Documentation

• Add example for adding swing.

• Add example for playing on repeat.

Version 6.0.0-beta.19

Bugs

• Fix crash when processing a string that contains no note events.

• Don't let odd crescendo or diminuendo cause a nonsensical volume.

• Initialize the gap in audio files.

• Fix bug in timing callbacks when the position changes inside an event handler.

• Fix bug in turning off individual voices.

• Fixed chord placement when there are more than one chord in a measure in compound meter.

Features

• Implement a smooth cursor in the timing callbacks.

• Expose setWarp so that the tempo can be changed programmatically.

Version 6.0.0-beta.18

Bugs

• Slight speedup when laying out scores with names in the voices.

• Increase the size of the annotation's lane to account for descenders.

• Fix calculation of beat length for 3/8 time.

Features

• Return the cursor position for each beat in the timing callbacks.

• Add the x position of the end of each note to the note timings.

Documentation

• Document the renderer debug option.

• Document the new parameter on the TimingCallback's beatCallback.

Version 6.0.0-beta.17

Bugs

• Fix positioning of "3" on triplets.

• Add a tiny bit on margin for the annotation lanes.

• Fix positioning of lower annotations (that is: "_annotation").

• Fix generating audio using the SynthSequence object.

Version 6.0.0-beta.16

Features

• If there is a repeat, then include both of the currentTrackMilliseconds in the callback. (Note: if you consume this, be sure you can handle either a number or an array.)

• Allow as many lanes as needed for annotations below the staff.

• Add Tune.getElementFromChar method for convenience.

• Allow setTiming to be called without parameters.

Bugs

• Fix the audio interpretation of dynamics.

• Fix vertical positioning of annotations when they appear on the same line as other annotations.

• Fix bug when there is a spacer in a triplet.

• Fix drawing of slur at beginning of line.

• Fix bug where editor swallows the clickListener callback.

• Fix timing when there are tempo changes.

• Move tempo note up slightly so it aligns with the number, not the font's baseline.

Documentation

• Document the return value of renderAbc

• A little improvement to the Editor documentation.

• Document classes a little more comprehensively.

• Document lineBreaks parameter.

• Remove the circular requirement for abcjs in the docs.

• Start to document the rest of the options for renderAbc

• Create example of how to annotate music.

• Improve documentation of audio.

• Changed the object that onEnded is passed in with to match documentation.

Version 6.0.0-beta.15

Bugs

• Slightly increase the spacing for the dynamics lane.
• Fix crash when inline tempo is the first thing in the file.
• If selectTypes is not passed in, then the click behavior matches the last version of abcjs.
• Various positioning tweaks for clefs and key signatures.
• Get the fingerings to not interfere with chords.
• Fix dynamic volume calculation when dynamic is defined on bar line.
• Fix regression when wrapping short lines.
• Don't crash when creating a drum track (the inserted rests don't have elements attached.)
• Create AudioContext if one isn't passed in.
• fix some minor positioning problems with text boxes.

Features

• Use two lines for annotations and chords if they would run into each other.
• Recognize !^! as a synonym for !marcato!.
• Add a little more vertical space so nearby elements don't touch.
• Add support for dotted slurs and dotted ties.
• Pass back original mouse event when an element is clicked.
• Implement vocalspace.
• Add showDebug parameter to display element placement.
• Support beambr1 and beambr2.
• Add the option fontboxpadding.
• Allow annotationfont, composerfont, historyfont, infofont, subtitlefont, textfont, titlefont, and voicefont to have a text box.

Refactoring

• Some refactoring of layout functionality.

Documentation

• Change all the examples to use the /dist folder so the path doesn't change every release.
• Create test for web audio.
• Set a custom font for the chords in the docs.

Version 6.0.0-beta.14

Bugs

• Don't crash if setTiming is called too early.

• Fix length of accompaniment notes in compound meters.

• Fix inaccuracies with JS floating point on the length of notes.

• Fix crash when unmatched quote is in V: line.

• Get the multi-measure rest to have the correct duration for both display and audio.

• Fix crash "undefined size".

• Fix computing the pickup length when there are triplets.

• Don't transpose the perc clef.

• The audio should ignore the visualTranspose.

• Fix tempo calculation.

Features

• Improve the drawing of the double flat symbol.

• Detect chords that aren't on the beat and move them.

• Play chords on incomplete measures.

• Fix selection of tempo element.

• Handle no key sig in transpose.

• Allow synth parameters to be changed on the fly when using the editor.

• Don't require generate_warnings in editor params if warnings_id is present.

• Accept an element as well as an ID in warnings_id.

Refactoring

• Refactor the way notes are placed to create audio.

• Move layout functionality to a separate directory.

Documentation

• Make a better example of how to transpose.

Testing

• Add Mocha

• Add mocha tests covering most of the audio note placement.

• Add mocha tests for the selectable items.

• Add mocha tests for the line wrapping code.

• Add mocha tests that will run cross browser.

Version 6.0.0-beta.13

Bugs

• Fix staff spacing bug when nothing is below the staff (like with bass clef only containing high notes)

• If a triplet is beamed with anything else, add a bracket.

• Fix supportsAudio() so it always return a bool

• allow more than one brace on a system

• Don't start dragging a note unless only the main mouse button is clicked.

• Don't crash audio if the time signature is malformed.

• Fix tempo on 9/4 and 12/4 meters

• Restore staccato note length

• fix bug in audio transposing middle C

• fix placement and sizing of text and the text box

• fix bug with sizing gchordfont

• Fix some crashes and bugs in the visible audio control.

Features

• Calculate tempo using passed in bpm if the millisecondsPerMeasure is not supplied.

• Refactor the editor to use renderAbc so that all the renderAbc functionality is available.

• allow multiple lines on a voice name

• center the voice name when there is one name in a brace.

• Implement vskip for regular music lines.

• allow changing gchordfont in the middle of the tune

• Create chords from whichever voice chords are encountered first.

• Get the octave clefs to sound in the correct octave.

Documentation

• update example to show onSvgPerLine and use new audio.

• Fix example links in docs.

• Add example for playing synth with no visual music.

• Fix midi download link on full synth example.

Refactoring

• split tunebook from tunebook parsing.

• More refactoring of the drawing code.

• separate bottom text into creation/drawing stages; cut down on dependencies in the draw functions.

• separate editarea from editor to allow function redefinitions

Version 6.0.0-beta.12

Bugs

• Fix selection of items in a cross-browser way, in different markups and css that the SVG can appear.

• Fixes #440 second staff rendering too early.

• Fix regression bug when rendering.

Version 6.0.0-beta.11

Features

• Allow "K:C none" to be the same as "K:C clef=none"
• Allow a finer grained selection mechanism.
• Allow braces to be selected.
• Allow o 0 and ^ as input for º ø and ∆ in chords.
• Don't play notes that are drawn with the rhythm notehead: replace with chord.
• Implement graceslurs
• Make the annotation not take horizontal space.

Bugs

• Crash in Firefox <= 50 when selecting.
• Don't crash if a rest is put inside a chord i.e. [z]
• Improve downward stem and beam rendering
• Remove the gaps between notes in audio.
• When removing latex commands, don't mess up the character positioning.
• fix to scale the click coords when paper is set to responsive
• support viewBox differences between chrome and firefox

Refactoring

• Extract the chord/annotation function to a separate file.
• Much refactoring to start putting all of the drawing commands together.

Documentation

• Add example for using wrap.
• Improve documentation for the call to initialize the synth.
• use https link over ssh for building documentation

Version 6.0.0-beta.10

Features

• Add option to turn off individual voices when producing the audio.
• Add track names to midi file output.

Documentation

• Example of how to play only chords or only melody.

Bugs

• Fix placement of multiline overlay voices.
• Fix crash when setting the name of the midi file to download.
• Many timing tweaks and other improvements to the audio creation.
• Playback treble+8, etc. clefs in the correct octave.
• Don't transpose chord accompaniment more than an octave.
• Extra resume of audio context for Safari 13
• Fix setting the sound font url.
• Support pppp and ffff in audio.
• Fill midiPitches when doing any timing operation.
• Fix seeking when paused moved the cursor but not the audio.
• Fix audio timing when there are grace notes present.
• Fix end tie that happens over an ending.
• Fix audio for ties when there are accidentals.
• Fix the alternating bass note for chords with #5 and b5.
• Fix arithmetic inaccuracies in triplets.
• Fix interpreting a "maj" chord as minor.
• Fix tempo of 3/4 tunes.

Version 6.0.0-beta.9

Bugs

• Add a fail-safe timer for the timingCallbacks (for some mobile devices that don't properly do requestAnimationFrame)

Tasks

• Add Docker files for running npm.

Version 6.0.0-beta.8

Bugs

• Give the percussion clef a little more room to the right.

• Fix line ending callbacks after random access seeking.

Version 6.0.0-beta.7

Bugs

• Some tweaks to improve audio output.

• Element.prepend is not available on older browsers.

Version 6.0.0-beta.6

Bugs

• When doing line wrap, don't drop the meter when there are multiple staves.

• Keep the line callbacks in TimingCallbacks accurate after seeking.

Version 6.0.0-beta.5

Features

• Add offset parameter for TimingCallbacks start()

• Somewhat improved documentation.

Bugs

• Make the timing of beats more accurate in TimingCallbacks.

• Only select element if the click is within 12 pixels.

• Fix crash when using the built in audio control.

Version 6.0.0-beta.4

Features

• Add a callback for the client to select items programmatically.

• Add midi download to the synth example.

• Add "link" as the default style of midi file return value.

Bugs

• Call resume on the AudioContext just before playing, just in case. (Fixed Safari bug)

• Fixed regression with the line number on the staves.

• Fixed regression: the class "abcjs-top-line" lost the "abcjs-" part.

Tasks

• Update copyright years.

• Update dragging example.

Version 6.0.0-beta.3

Bugs

• Remove warning in audio creation when the track name is specified.

• Don't crash in creating audio when the length of the music is zero.

• Fix some timing problems with loading note mp3 that are already pending.

• Fix selection of free text.

• Set the correct defaults for a bare "%%sep" command.

• Set the right font face when a font is specified with only "box"

• Fix crash in audio when trying to play unisons.

• Fix setting the position of braces and brackets when the start staff isn't present.

• Fix computation of pickup length because of JavaScript math problems

• Fix setting the position of braces and brackets when the end staff isn't present.

• Fix some inaccuracies in getting height of text.

Improvements

• Improve efficiency of creating the audio buffer; improve sound quality and volume of the buffer.

• Round many of the calculations to make the SVG draw the same on different systems.

• Improve the selection data.

Version 6.0.0-beta.2

Bugs

• Fix crash when creating music when the SVG is not shown.

Version 6.0.0-beta.1

Selection

• Completely revamp the selection of elements code.
• Implement dragging notes vertically.
• Give more information when clicking on the staff label.
• Get the box around text to be selected with the text.
• Fix selection of the text at the top.
• Click listener parameters now have analysis.
• Add more element types that can be selected by the user.
• Add option "selectAll" for only being able to select notes/rests/bars.
• Add option "selectionColor".
• Add option "dragColor".
• Add option "dragging".

Audio

• Add "pan" parameter for the audio.
• Pass changes to audio parameters into the editor.
• Improve error handling of midi.
• Guard against crash when a negative duration is given to the midi.
• If an unknown chord pattern starts with an "m", default to minor chord (was always defaulting to major.)
• Redo audio buffer creation to use built in audio nodes.
• Add key and time sig to midi output; use the "note off" command instead of volume 0 in midi file.
• Add track name to midi file.
• Don't override channel for the percussion clef if the program or channel was explicitly set.
• Fix small, accumulating rounding error in midi file timing.
• Fix crash when there isn't a title or other things about the first music line.
• Fix detection of whether a meter is compound.
• Add audio support for trills, mordent, turn, and roll.
• Fix grace note pitch; implement staccato, tenuto, and accent in audio.
• Add option for retrieving the binary midi data.
• Expose the code for creating a MIDI file to the basic library.

Rendering

• Draw bracket; fix positioning of the brace and bracket.
• Fix grouping and classes of triplets and beams.
• Some tweaks to the grouping of svg elements.
• Optimize calls to getBBox
• Give measure numbers that appear on the left edge more room when they would interfere with the treble clef.
• Make the invisible marker zero pixels so it can't accidentally get shown with css.
• Add classes to ledger lines
• Add more identifying classes.
• Adjust the bass octave indicator a little.
• Group some svg elements together that belong together.
• Remove the selector box for each element - entire SVG is selectable.

Tasks

• Add testing for the output of the selection.
• Set gitmodules for the vuepress docs (so that commits can be in npm.)
• Remove some dependencies on the window object.
• Put all drawing actions in an array

Documentation

• Create demo of dragging and selection.
• Documentation should import on the latest abcjs.
• Fix link to audio examples in docs.
• Fix logo path in readme
• Add reference to the standard.

Version 5.12.0

Features

• Add entry point for changing glyphs.

• Improved documentation.

• Add example for changing glyphs.

Bugs

• Fixed midi plugin example to demonstrate defaultQpm.

• Fix rendering quarter tones in the key signature.

Version 5.11.0

Features

• Changed documentation to vuepress.

• Implement the defaultQpm parameter.

• In TimingCallbacks, accept a tune that hasn't created noteTimings yet.

• Audio: Implement beataccents, nobeataccents, vol, volinc, and set the correct default accent values.

• Add onEnded callback for the CreateSynth object.

• Add headless rendering with the "*" parameter.

• Add callback context to audio calls.

• Allow using audio without a visible control.

• Add a callback when the selection changes in the editor.

Bugs

• Fix bug in double reporting a note's millisecond; fix bug in playing gracenote.

• Fix grace notes in percussion track.

• Fix crash in creating audio when there is a mismatch of ties.

• Fix bug with lining up ties with the correct voice on multipart music.

• Change the TimingCallbacks input parameters into integers.

• When querying a tunebook for an id, accept either string or number.

• Fixed the value of currentTrackMilliseconds that is returned when the user clicks on a note.

• Fix wrapLines with several titles

• Don't add duplicate program commands in audio

• Don't ignore chord basses with accidentals when generating midi

Tasks

• Update dependencies

Version 5.10.3

Bugs

• Don't crash when calculating the wrap lines if the staff width is too short.

Features

• Allow boolean directives to use "true" and "false", in addition to 0 and 1.

• Added freegchord option.

• Show example of getting timing info on note callback function.

Version 5.10.2

Bugs

• Fix line wrapping problem when the total number of measures is less than the target number of measures.

Version 5.10.1

Bugs

• Fix crash when attempting to manipulate tunes that are created with oneSvgPerLine.

Version 5.10.0

Bugs

• Fix crash on init of synth if tempo is not passed in.

• Fix the tempo for synth pieces that are not in 4/4.

Features

• Rests that take up a measure should always be a whole rest, no matter what the time sig.

• Allow beat subdivisions to be set for the synth control object.

• Update the test for whether audio is possible to include access to ac.resume

• Add sequenceCallback option for the synth.

• Add api function to expose the tune's key signature.

• Add sequenceCallback option for the synth.

• Add the rest of the possible TimingCallback parameters when calling through the new synth.

Version 5.9.1

Bugs

• Fix crash when using different combinations of options for the audio control.

• Fix some browser compatibility issues.

Version 5.9.0

Features

• Add parameter afterParsing to provide a hook before displaying the music.

• Added entry point for seeing if audio is possible.

• Play gracenotes (when present) when playing a single event.

• Keep a running total of the time that a note should be played for convenience in callbacks.

• Add gracenote midi pitches to the return object on timing callbacks.

• Support %%MIDI program channel program syntax.

• Much improved interface for using the new audio.

• Incorporate playing a single note.

Bugs

• Fix crash in editor/synth demo.

• Fix placement of triplets

• Let the timingCallbacks be used with one SVG per line.

Tasks

• Improve demos relating to audio.

• Update all node dependencies.

• Document the "mark" class.

• Update webpack

• Make uncompressed version of abcjs.

Version 5.8.1

Bugs

• Fix vertical spacing of %%text

• Fix output of getTune() when more than one tune is parsed with the same parser.

Version 5.8.0

Bugs

• Fix alignment issue when a tempo is over a barline.

• Fix alignment issue when a part is over a barline.

• Change startChar and endChar to be aware of the position in the entire tunebook.

• Some tweaks to the slur and tie positioning.

• Protect against crash when an element is added before the staff is ready.

Features

• Add a new method of creating synthesized sound. (see Synth Documentation )

• Implement "setbarnb" measure number

Tasks

• Add demos for transposing.

• Add demo of clicking on a note to play it.

• Add examples of how to use the new synth.

• Update build dependencies

• Simplify the build process by not requiring a version number change for each entry point.

• Add info about x and width to renderer regression tests.

Version 5.7.0

Bugs:

• Improve slur and tie direction and placement by following "Standard Practice Engraving".

• Use override when calculating beats per measure in the timing functions.

• Fix crash when using the old animation routine without a cursor.

• Handle blank lines in the verses at the bottom.

• Allow calling pauseAnimation and stopAnimation even if the animation hasn't started.

• Fix alignment of overlay voices when the line starts with a bar line.

• Don't start TimingCallbacks timer if there is a seek before the timer starts.

• Expose TimingCallbacks in the midi and test versions.

Features:

• Allow creation of SVG when it isn't visible in the DOM (by creating a dummy one if necessary).

• Add classes to lyric lines.

• Separate the tempo element into its own svg path so that it can be treated separately.

• Support 6/4 time.

• Invert beatCallback and timingCallback events.

• Add more information in the callback for both the timingCallbacks and the note click callback about the sound of the note clicked.

• In midi, support switching instruments in the same track.

• In midi, return the pitch that is being played in the event; add the total duration as a parameter of the midi; expose getBeatsPerMeasure() in the tune structure.

• In TimingCallbacks, allow subdividing beat callbacks.

Tasks:

• Update webpack/babel to the latest versions.

• Clean up the text size estimation to just be done in one place, and create a dummy svg if there isn't one available.

• Remove the examples and the font_generator from the npm version.

Version 5.6.11

Bugs

• Fix bug in TimingCallbacks where some beats won't be reported if the javascript processing is interrupted (for instance, if the user changes tabs while it is running.)

Version 5.6.10

Bugs

• Fix bug in TimingCallbacks where last beat can sometimes be skipped if the animation timer wakes up right at the end.

Version 5.6.9

Bugs

• Make overlay work with first & second endings

• Fix bug in measure counting in TimingCallbacks when line starts with a measure of rests.

• Keep stem direction when doing line wrapping.

• Improve the algorithm for wrapping lines.

Version 5.6.8

Bugs

• Improve the line wrapping algorithm.

• When seeking in the TimingCallbacks, call the new position's callbacks right away.

Version 5.6.7

Bugs

• When note is far from the centerline, the stem is extended, so put the flag in the right place.

Version 5.6.6

Bugs

• Calculate the correct number of beats in TimingCallbacks: fixes rounding error.

Version 5.6.5

Features:

• Add random access seeking to TimingCallbacks.

• Pass back more progress info in the beat callback of TimingCallbacks.

Bugs

• Add render_options to the midi version of the plugin.

• Add missing release files; remove the "latest" versions, since they were not kept up to date.

• Updated build packages.

Version 5.6.4

Features:

• Add %%vskip

• Add %%sep

Bugs

• Don't include the minified versions of the libraries in the npm package.

Version 5.6.3

Features:

• Add arpeggio decoration.

• Add "voicescale" and "cue=on".

• Add "%%flatbeams".

• Add entry point for "extractMeasures()" to analyze the tune. (Just single voice music for now.)

Bug fixes:

• Add startChar and endChar for many non-note elements (parts, clefs, tempos, etc.)

• Fix triplet bracket placement when there are rests or really high notes.

• Handle triplets correctly when figuring out the length of the pickup measure.

• Don't count spacers when seeing if there are pickup notes in a tune.

• Fix bug not recognizing an inline header after a "&".

Version 5.6.2

Features:

• Add more chord definitions.

• Support changing fonts in W: statements using $1 syntax.

Bug fixes:

• Don't attach midi control listeners to the global object.

• Fix some midi control visual issues.

• Fix mousemove listener in the midi control, we want to consume only our events.

• Sort the events for midi creation more deterministically.

• Fix handling ties over a bar line when there is an overlay.

• Adjust text a little when there is a box around it to be centered better.

Version 5.6.1

Bug fixes:

• Fix bug where wrapping code was ignoring one SVG per line.

Version 5.6.0

Features:

• Enable progress indicator dragging

• Clicks on progress bar now move the indicator correctly

Bug fixes:

• Fix the title (with unicode chars) in the downloadable MIDI file.

• In midi, sort program changes before other events that happen at the same time.

• Fix crash when calculating the title for a piece with a missing voice.

• Fix bug where wrapping code was ignoring one SVG per line.

• Fix off-by-one error when calculating line widths during wrapping.

Version 5.5.0

Features:

• Add "chordsOff" parameter to just play midi of the melody.

Bug fixes:

• Don't duplicate slurs on chords when using wrap.

• Figure out correct accidental when transposing to a key with accidentals in the key signature.

• Fix problem with calculating the height of beamed notes when the top or bottom one is middle C.

Version 5.4.2

Bug fixes:

• TimingCallbacks was reporting the end of the animation at the beginning of the last event - it now waits until the end of that event.

Version 5.4.1

Bug fixes:

• Improve the decision on how to break lines in line wrapping.

• Don't duplicate meter when wrapping lines.

• Return the correct version of the tune when doing line wrapping.

Version 5.4.0

Features:

• Add preferredMeasuresPerLine as a parameter to the line wrap.

Bug fixes:

• Improvements to the speed and stability of the line wrapping code.

• Fix lyric placement on wrapped lines.

• Fix the timing of whole rests in the TimingCallback.

Version 5.3.5

Features:

• Always send start of measure event on TimingCallbacks, even if the measure starts with a tie.

• Support ^8 and _8 for clefs.

Version 5.3.4

Bug fixes:

• Fix crash when doing multi-stave music in wrap mode.

Version 5.3.3

Bug fixes:

• Fix test for shrinking the only line when wrapping.

Version 5.3.2

Bug fixes:

• Test all options in the wrap parameter for legal values.

• Ignore the explicit line breaks when using wrap.

• Get the amount of spacing more even on each line when using wrap.

Version 5.3.1

Bug fixes:

• Don't require passing scale as a parameter to get the wrap parameter to work.

Version 5.3.0

Features

• Add parameter wrap: { minSpacing, onlyLineLimit, lastLineLimit } and automatically calc num measures for each line.

• When animating, return an array of start and end chars if there is more than one voice.

• Add line and measure info into the TimingCallbacks for the convenience of the clients.

• Don't require qpm to be passed to TimingCallbacks: look for a qpm in the music.

• In TimingCallbacks, add a callback when it is near the end of a line.

• Add replaceTarget() to the timing callback so that re-engraving can happen when the cursor is running.

• Include the original abcString in the callback when rendering.

• Allow multiple overlays in the same measure.

• Add %%tripletfont directive.

• Add unicode versions of flats and sharps in midi chords.

• Support %%MIDI beat command.

• Support %%MIDI gchordoff and %%MIDI gchordon.

Bug fixes:

• The tune positions were off by one because a newline is removed for each tune and was not counted.

• Fix crash in renderAbc if the output container isn't an html element.

• Fix default tempo in animation for compound meters to match the MIDI interpretation.

• Refactored the animation to use the TimingCallbacks instead of duplicating code.

• Fix a couple of bugs when sequencing elements for the TimingCallbacks and animation.

• Center the time signature better (particularly 12/8).

• Add extra space to the left of bar lines.

• Add extra space to the width of a note when there is an accidental.

• Lots of refactoring of the engraving code.

• Fix crash when using barsperstaff.

• Fix usage of staffnonote

• In TimingCallbacks, make extraMeasuresAtBeginning default to 0.

Version 5.2.0

Features

• Add a version of the plugin that supports midi.

• Add getMeterFraction() convenience function.

• Add a generic timer that provides callbacks in time with the music.

• Small change to classes: add abcjs-n... to rests; add duration to triplet marks.

Bug fixes:

• Correct the speed of animation in 3/8 meter.

• Fix accidentally creating a global variable.

Version 5.1.2

Bug fixes:

• Fix horizontal spacing calculation for multiline text.

Version 5.1.1

Bug fixes:

• Fix regression for having the SVG responsive.

Version 5.1.0

Bug fixes:

• Fix bug with spacing triplets when the stem direction is not explicitly set.

• Fix problem with sizing the music div when zooming.

• Fix crash when clicking on the time signature.

• Fix bug in beat detection in midi listener.

Features

• Add entry point for parseOnly().

• Expose midi.setRandomProgress().

• Expose midi.setLoop().

• Expose midi.restartPlay().

Version 5.0.1

Bug fixes:

• Comply with the Chrome change to not play audio unless the AudioContext is resumed inside a user interaction.

Version 5.0.0

Bug fixes:

• Don't crash animation when there are invisible rests.

• Don't crash when illegal value for scale is passed in.

• Change guitar chord flat and sharp to the right symbols in a few more cases.

• Begin to support mensural time signatures.

Features

• Remove dependency on Raphael.

Version 4.1.1

Bug fixes:

• Fix double transposition of the key signature when transposition is specified in the parameters.

Version 4.1.0

Bug fixes:

• When the perc clef is defined in the voice, add the midimap translation to the pitches (this was already being done when perc is in the key sig.)

• Get lines with lots of notes to align properly.

• Do more edge cases with triplets; fix some triplet bugs.

• Double bar lines were messing up the place for the repeat to return to.

• MIDI animation now follows tempo changes.

• Don't get off on the midi animation when encountering a spacer type rest.

• Be sure the div to be written to is empty before engraving.

• When midi is redrawn, stop playing the old midi.

• After calling midi's stopPlaying, reset the inline midi control.

• Fix midi animation when there are no explicit 1st & 2nd ending marks.

• Add fix for getting the Font Awesome 5 icons to show up in audio control; some cosmetic tweaks to large version on audio control.

• Fix click listener in Editor mode.

Features:

• Allow "style=" parameter on V: line.

• Add a spinner to the audio play button when the soundfonts are loading.

• Allow rhythm slashes to be placed on rests.

• Add feature to transpose a single voice, using "V: ... score=_B"

• Add public function: midi.deviceSupportsMidi()

• Add all the fonts to the directives that can be specified in the renderAbc call.

Version 4.0.1

Bug fixes:

• Respect repeats in animation.

• Fix crash when using metronome intro in minified version.

Version 4.0.0

Breaking Changes:

• Don't generate classes unless requested. (This is a bug fix, but client code might mistakenly been relying on that behavior.)

• Add "abcjs-" as a prefix to all class names that are generated.

• Change the metronome track to use the Channel 10 sounds.

Features:

• Simplify the options used to call renderAbc and renderMidi.

• Add clearer names for clickListener, midiListener, midiTranspose, and visualTranspose.

• Implement "partsBox"

• Add a few missing text encodings.

• Handle "%%MIDI transpose" syntax.

• Add a larger version of the audio control.

Bug fixes:

• Remove a few deprecated options that were broken anyway.

• Move first and second ending lines down a little.

• Put a little more spacing around text that has a box around it.

• Remove some ES6 syntax that snuck in.

• Ignore %%scale formatting command if responsive=resize.

• Remove some debug messages.

• Fix bug with setting only one voice to percussion voice.

Version 3.3.4

Bug fixes:

• Fix build error causing percussion soundfont to be missing.

• Fix lining up multline lyrics when there is a syllable missing on the first line.

Features:

• Add "rest" class to all rest objects.

• Add multi-measure rests.

Version 3.3.3

Bug fixes:

• Fix parsing when "V:" is inline.

• Allow stafflines on the V: line.

• Add "perc" to clefs recognized by V:

• Fix the parsing of the "middle" parameter.

• Fix centering of lyrics.

• Fix midi animation when repeating over more than one line.

• Take pickup notes into consideration for the lead in metronome beats.

Features:

• Add transpose parameter for engraving.

• Implement "MIDI drummap".

• Use percussion channel whenever the clef=perc.

• Change default soundfont location to paulrosen github.

• Add percussion channel to the soundfont.

• Change to percussion track when "channel 10" is specified.

• New parameter for download midi link: "downloadClass".

• Pass the startChar and endChar to the MIDI animate callback.

Version 3.3.2

Bug fixes:

• Fix the tuneNumber in the listener callback.

• Fix the listener callback with separate SVG for each line.

• Preload all the instruments needed; don't assume the default "piano".

• Allow calling startPlaying() with the target being the parent control.

• Expose the startPlaying and stopPlaying methods.

• Change the midi git line to use https.

• When unpausing the MIDI, immediately redraw the MIDI.

• If a tempo is described as a string, don't let it be undefined in the MIDI tempo control.

• Protect against writing "undefined" in class names.

• Add setSoundFont() entry point.

• Validate the startingTune parameter.

• Add protection in case animation pause is called at an unexpected time.

• Fix midi formatting issues caused by box-sizing change.

Features:

• Translate some common tempo strings to BPM.

• Do basic accessibility for SVG.

• Add pitch and duration to the classes that notes are tagged with.

• Add note number in a measure to the classes that notes are tagged with.

• Add the element's classes to the listener callback.

Version 3.3.1

Bug fixes:

• Modify main index.js to avoid using ES6 (is not transpiling, and some testing platforms can fail)

• Expose the soundfontUrl variable.

Version 3.3.0

Bug fixes:

• Only put the first/second ending marker on the top staff of a system.

• Fix crash when voice is incomplete.

• Fix position of the clock on the midi controls; make midi controls aware of box-sizing.

• Only play chords once if there is more than one staff.

• Fix JS math rounding error when figuring out the timing of the notes for MIDI animation.

• Add tied notes to the objects that will get returned during MIDI animation.

• Don't let the MIDI duration be a negative number on really short notes.

• Sequence the repeats correctly when doing MIDI animation.

• Don't put MIDI.js in debug mode.

• Remove dependency on midi for the editor version

• Fix declaration of "galactic".

• Add polyfill for Object.remove() for IE

• Fix creating downloadable midi

• Fix bug where there couldn't be two different note heads on a stem.

• When splitting a line with barsperline, propagate certain control items on the next line.

• Fix some midi control visual conflicts with box-sizing.

• Fix the playback tempo for non-4/4 meters.

• Support a couple more rhythm patterns with generated chords; fix a couple errors in generated chords.

• Fix problem with ending a beam when a chord is the last element.

Features:

• Add support for "instrument" in midi playback; restrict usage of channel to be one per track.

• Make metronome track use the next free channel.

• Pick a free channel for the chords.

• Add "context" as a parameter to the MIDI controls so that multiple MIDI on a page can be kept separate.

• Set the default soundfont location to the CDN.

• Add a signature/version to the exports so that the client can detect it.

• Add the midi listener for the editor.

Infrastructure:

• Moved source code into a subfolder.

• Moved examples into a subfolder.

• Moved font generation into a subfolder.

• Moved documentation into a subfolder.

• Removed many no longer used build files.

• Remove "editor" as a separate build.

• Just have three maintained minimized builds: abcjs_basic, abcjs_midi, and abcjs_plugin.

• Create separate entry point for "test" which is only useful for those working on abcjs.

• Create separate npm entry points for "basic" and "midi".

• Switch to webpack for creating static versions of libs.

• Don't need a plugin version under npm - that's just for standalone.

• Remove dependency on midi for the standalone version.

• Remove unneeded public entry points.

• Add old minified versions that were previously missed.

Documentation

• Clarified config of "drum" track in midi.

• Updated copyrights

• Create a "contributing" doc page.

• Lots of readme file clean up.

• Create an example that demonstrates formatting for printing.

Version 3.2.1

Bug fixes:

• Don't crash if window.performance is not defined.
• Don't move the position of the rest unless there are more than one voice on a staff.

Version 3.2.0

Features:

• Implement overlay from the ABC standard.

Bug fixes:

• Update the license notice in the source code to match the MIT notice.
• Fix some npm dependencies.
• When clicking on MIDI control, have the buttons be non-submitting.
• Fixed missing pauseAnimation function.
• Fix the height of the SVG when doing the responsive=resize option.
• Measure number classes should not be placed on the staff lines or the brace.
• When animating midi, make qpm parameter optional.
• When animating an editor-type engraving, don't pass in the tune object: the editor already has it.

Version 3.1.4

Feature:

• Added new parameter "responsive=resize" to do responsive SVG.

Version 3.1.3

Features:

• Rearrange the code so that an npm module is created.
• Provide access to warning messages as objects.

Bug fixes:

• Fix crash in generating midi when the meter isn't expressly defined.
• Don't throw an error if the midi control has been removed from the DOM by the time the midi stops playing.
• Don't require Raphael to be visible to a client creating an EngraverController.
• Fix problem with title not showing when using the plugin.

Version 3.1.2

Bug fixes:

• L: 1 (whole note) should be accepted as note length
• Do not change the default note length when meter is change inline
• If no meter is specified, free meter is assumed
• If a default note length is set by a meter, it shouldn't be changed another inline meter
• Fix crash on inline V:
• Fix overlapping of low annotations.
• Fix spacing after voice label.
• Make ties a little more rounded.
• Some minor adjustment to drawing ties.

Features:

• Add an option to hide the current measure on animation.

Version 3.1.1

Bug fixes:

• Change slur direction if there is a tie on the first or last note.
• Adjust placement of slash on a note stem; make sure the stem is long enough.
• Work on placement of triplets.
• Make tie shallower than slur.

Version 3.1.0

Bug fixes:

• Fix midi beat length; some improvements to the midi animation.
• Write ledger lines for grace notes.
• Fix crash in parsing.
• qpm was being passed in twice for midi animation.
• When doing the call back in the midi animation, pass the absolute coordinates of the item that is current.
• Handle case where there is an intro drum beat, but it ends at the first note.
• Handle common and cut time when doing midi drum beats.
• Fix midi transposition.
• Fix bug in midi animation when starting and stopping the midi.
• Fix bug in finding the written notes when animating the midi output.
• Handle creating midi for grace note that appears at the beginning of a part that is not the first part.
• Fix bug introduced in creating midi for gracenote.
• Fix when the metronome track starts, and fix the tempo of it when the meter is not 4/4
• Allow passed in tempo to override the defined tempo.
• Fix crash when creating midi for multipart music where the first note has a grace.
• Make midi control's css more stable when combined with other css.
• Fix bug in displaying note values in tempo field.
• Fix crash when there are bar numbers on multi-line music.

Features:

• Add "pause/resume" to the standard animation.
• Report when there is a new beat in the midi listener.
• Added drum intro to the MIDI, using a new midiParameter.
• Add midi option "voicesOff" to mute the midi output, while leaving the metronome, guitar chords, and the animation.
• Implement animation callback when playing MIDI.
• Completely change the parsing of %%MIDI parameters; support the "%%MIDI drum" parameters; allow setting midi instrument and channel.
• Allow three digit version numbers.

Warning:

• Turn off instrument/channel selection in midi until it is debugged.

Version 3.0

Bug fixes:

• Fix crash when encountering Cbm or other theoretical-only keys.
• Fix crash when there is no start or end point for a dynamic mark.
• Don't crash in Firefox if text is written to an element that is not currently visible (Raphael reports NaN for the size.)
• Don't crash if the music was removed before animation is done.
• Fix centering text using %%center.
• Allow blank %%text lines.
• Misspelled botmargin.
• Fix bugs in measure numbering: put number over the bar line.
• Fix placement and style of the measure numbers.
• Fix crash when there is a key change after a subtitle line in the header.
• Make the + sign of the meter not lay right on the staff line.
• Fix note length bugs in the tempo marker.

Features:

• Added viewPortHorizontal and scrollHorizontal to the renderParams.
• Add class "slur" to slurs and ties.
• Add "hint measure"
• Allow scrolling in the animation.
• Handle %%titlecaps directive.
• Add curly brace to indicate piano part (with inspiration from Anthony P. Pancerella).
• Add invisible marker to the top of each system so that it can be found easily.
• Add an option to put each line in a separate svg so that browsers will paginate correctly.

MIDI:

• First pass at using a new inline MIDI generator.
• Make the default MIDI instrument "0" instead of "2"
• Implement some MIDI controls: play, pause, reset, tempo, progress bar, BPM, clock, pre- and post-text

Version 3.0 Beta

MIDI:

• Update documentation for using MIDI.

• Update creating a release to package the MIDI.

• Integrate midi.js and remove the old MIDI attempts.

• Create MIDI output for both download and playing through midi.js.

• Create the html for an interactive audio control and implement standard functionality.

• Make the default midi instrument "0" instead of "2"

• Don't crash if a chord containing a slash doesn't contain a bass note.

• Fix playing second repeat; allow strings as parameters.

Bug fixes:

• Fix crash when encountering Cbm or other theoretical-only keys.

• Report the tune number on clicking the absolute element

• Fix crash when there is no start or end point for a dynamic mark.

• Clarify how to use the animation() functionality.

• Added viewPortHorizontal and scrollHorizontal to the renderParams

Version 2.3

• Completely refactor the midi processing: now supports chords and grace notes and embeds the tune's title.

• Remove the automatic generation of the QuickTime element.

• Fix crash when a triplet with a 0 duration is created. That is: (3B0BB

• Fix having a spacer 'y' between two notes that are tied.

• Fix starting first line with [P:A]

Version 2.2

• Fix drawing of tempo indicator.

• Add voice number to the css classes.

Version 2.1

• Fix startChar for chords.

• Fix placement of left annotation, that is: "< text"

• Updated compressor version (note: 2.4.8 has a bug and doesn't work, so using 2.4.7)

• Some improvements to decoration placement.

• Fix triplet not lining up properly in multiple voices bug.

• Fix note lengths when chords and broken rhythms interact.

• If a font appears in the header, then it becomes the default font.

• Add some debugging capability to the plugin. 4313963

• Implement gchordfont; make the extra spacing respect the font height.

• Upgrade bundled version of jQuery to 1.11.3.

Version 2.0

• Many bug fixes.

• Much work on vertical spacing of elements.

• Much refactoring of the codebase to make future maintenance easier.

• Beginning support of "print" mode, that lays out music in a way suitable for creating printable PDFs.

• Fixed animation jumping around when there is a whole rest or after a bar line.

• Fixed slurs not behaving across lines.

• Improved the handling of generating glyphs.

• Added support for setting a number of fonts.

• Added support for positioning of lyrics, dynamics, volume marks, ornaments, and guitar chords.

• Fixed grace note note lengths.

• Added a set of regression data for the engraver.

• Added note head choices for slash notation, harmonics, and indeterminate pitch.

• Fix vertical positioning of many elements.

• Fixed positioning of ties.

• Fixed beam height.

• Set padding for "print" version.

• Support of many formatting options.

• Expanded click target so that users can easily select note.

Version 1.12

• Improved documentation.

• Accept %%abc-* meta commands.

Version 1.11

Features

• Added new entry points: ABCJS.startAnimation() and ABCJS.stopAnimation(), which allow for a bouncing ball-type cursor.

• Added getBeatLength() to the returned tune to get the length of a beat in measures.

• Return the tune object from renderABC() so it can be manipulated further by the caller.

• Put a copy of the engraver with the outputted tune, so that it can be manipulated later.

• Made highlighting notes more flexible: both the class name for the highlight and the note-head color can be specified or not used.

• Added descriptive classes to all SVG elements, including element type, line number, and measure number.

Bugs

• Fixed positioning of the highlighted characters in the editor when a line begins with a space.

• Fix the duration of whole rests to always be the length of a measure.

• Fixed bug in "unpausing" the editor's connection with the rendering.

• Move chord names above everything else on the line.

• Made more room for decorations, so they don't overlap.

• Center whole rests in the measure.

• Put accent on opposite side of the note stem.

Refactoring

• Moved Raphael out of the "write" folder; updated jQuery version.

• Split graphelements file into many different files.

• Changed the internal name of "printer" to "engraver" as a first step in refactoring.

• Updated the minify script to find all js files.

• Updated the minify script to change the version number in the readme automatically.

• Updated the minify script to support "a" and "b" in the version name for alpha and beta versions.

Examples

• Created versions of the minimized files with a name that includes "_latest", for easy reference.

• Updated the example files to always use the latest version.

• Fixed font displaying html file to note have the elements write on top of each other.