Note about local execution and URL Share QR Code limitations and solutions

Running the Tool Locally

If you download the repo, you can run the tool by opening:

abctools.html

All of the ABC editing features and PDF generation should work identically to my public website.

A few features only fully function if the code is on an actual web server.

URL Share Links and QR Code Limitations When Running Locally

Because these links are created relative to where the abctools.html file is run, when running locally, the URL Share links will look something like:

file:///Users/michaele/Downloads/abctools-main/abctools.html?lzw=BoLgBAjAU...

You can test the link locally using the "Test Share URL" button, but the link won't work for anyone else.

Additionally, if you scan a QR code created from a local URL Share, the phone will not be able to open the local filesystem based URL.

It is possible to convert a local share link into one that points to my public tool site.

Delete this part of the ShareURL in the text box:

file:///Users/michaele/Downloads/abctools-main/abctools.html

and replace it with:

http://michaeleskin.com/abctools/abctools.html

or, if you have the code hosted somewhere on a public website, with the full path to the abctools.html file on your site.

That will open the link on the hosted site when then loads the tune from URL parameters and renders the ABC.

You can also generate a valid URL Share QR Code from the replacement URL.