This library is for a web designer or a web programmer who wants to display standard music notation on their website. It can also be used for generating MIDI on a website.
What, you ask, is ABC Music Notation? There are lots of explanations around the web. Here's a good place to start.
The project is hosted on Github. Go there for all technical information about the project.
Here are the latest versions. You can just download these and include them in your page:
The abcjs libraries come in three basic flavors:
Which flavor should you use?
If you are allowing the user to enter music using ABC notation, whether a whole tune or a fragment, then you probably want to use abcjs-editor. This is just like the basic version, except that it adds the ability for the music generator to watch a textarea and output what the user puts there.
If you are using WordPress, you can use the "ABC Notation" plugin. Just click "Add New" on the plugin page and search for "ABC Notation". Or get it here: WordPress Plugin.
If you are using Rails, you can just use this gem: abcjs-rails. This is the same code, but it has been packaged for you to use with the asset pipeline.
If you already have ABC notation on your page and don't want to modify the page more than you have to, then you can use abcjs-plugin, which will render all ABC that it finds on the page on page load, simply by including one line: the line to include the script.
If you are looking at someone else's website and see ABC on the page and want to see what it looks like in standard notation, you can install the greasemonkey script in FireFox or Chrome and it will render the ABC for you.
We hope you find this library useful and we'd like to see you use it on your own site, whether it is personal, community, or commercial software. It is available under the GNU GPL v3 license. If you have a problem with this license, please write to us! I'm sure we can work something out.
Here it is:
// This program is free software: you can redistribute it and/or modify // it under the terms of the GNU General Public License as published by // the Free Software Foundation, either version 3 of the License, or // (at your option) any later version. // // This program is distributed in the hope that it will be useful, // but WITHOUT ANY WARRANTY; without even the implied warranty of // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the // GNU General Public License for more details. // // You should have received a copy of the GNU General Public License // along with this program. If not, see Licenses.