Melodeon.net Forums

Please login or register.

Login with username, password and session length
Advanced search  

News:

Welcome to the new melodeon.net forum

Pages: 1 2 3 [4] 5   Go Down

Author Topic: My new client-side abcjs-based ABC converter  (Read 15350 times)

0 Members and 1 Guest are viewing this topic.

Michael Eskin

  • Hero Member
  • *****
  • Offline Offline
  • Posts: 547
    • AppCordions
Re: My new client-side abcjs-based ABC converter
« Reply #60 on: April 17, 2023, 04:43:31 PM »

Paul Rosen issued an abcjs fix for Firefox 112, and I’ve updated my tools with his code and a few additional bug fixes and visual improvements.
Logged

Michael Eskin

  • Hero Member
  • *****
  • Offline Offline
  • Posts: 547
    • AppCordions
Re: My new client-side abcjs-based ABC converter
« Reply #61 on: April 25, 2023, 04:18:48 PM »

Firefox 112.0.2 is out this morning and fixes the thin line issue for earlier versions of abcjs.  I've updated my tool to remove the previous Firefox hack that Paul Rosen came up with to work around the 112.0 and 112.0.1 versions. Looks good now.
Logged

Michael Eskin

  • Hero Member
  • *****
  • Offline Offline
  • Posts: 547
    • AppCordions
Re: My new client-side abcjs-based ABC converter
« Reply #62 on: May 19, 2023, 11:31:30 PM »

I've added a new feature to the ABC tool to allow you set the PDF quality and have some control over the PDF file size.

Just put this at the top of your ABC:

%pdfquality 0.5

and that will create a PDF about half the previous file size without sacrificing too much quality.

The default value is 0.75, which is lower than before, the previous default was 1.0.

Any new PDF files you create on the new version without overriding the default value will still be very high quality by default but a bit smaller in size than before.

Here's an example, you can paste this all into the tool to try:

%pdfquality 0.5

X: 1
T: The Blackwater
C: Matt Cranitch
R: polka
M: 2/4
L: 1/8
K: Dmaj
|:Fd Bd/B/|AF ED|A,B, DE|FE EF|
Ad Bd/B/|AF EF|DF A/B/A/F/|ED D>E:|
|:FA Bc|d2 Ad|fg/f/ ed|fe e2|
dc/d/ ed|BA FE|DF A/B/A/F/|ED D>E:|

You can play around with the pdfquality value until you find the sweet spot for your use.

You'll need to refresh your browser and make sure you have the latest version.  If not, clear the cache and reload the page.

If you have the latest version and click "New ABC", you should see the pdfquality value listed in the list of optional headers.
« Last Edit: May 20, 2023, 12:54:03 AM by Michael Eskin »
Logged

Michael Eskin

  • Hero Member
  • *****
  • Offline Offline
  • Posts: 547
    • AppCordions
Re: My new client-side abcjs-based ABC converter
« Reply #63 on: May 29, 2023, 07:53:29 PM »

IIn my ABC Tools, I've completely reworked the Table of Contents and Index pages as well as their sorted versions so that they now link back to the tune pages if you click on the tune name or page number.

So, for example, if you put this at the top of your ABC collection in the  editor, you'll get a title page, a table of contents with links back to the pages for each of the tunes, the tunes, followed by a sorted index with links back to the pages for each of the tunes:

%addtitle Session Tune Book
%addsubtitle My Tunes
%addtoc Table of Contents
%addsortedindex Index of Tunes

I've  tested it with several large tunebooks, both one tune per page,  multiple tunes per page, and with text and notation incipits.

If for some reason you specifically don't want the hyperlinks in the table of contents or index pages, you can add this annotation anywhere in the ABC:

%nopagelinks

Please try the latest version of the tool, make sure you're loading the latest  page by clearing cache, if you look at the page source for the main  tool, you should see

<link href="app.css?v=292" media="all" rel="stylesheet" type="text/css">

near the top of the file.

If you see a lower value, like v=286, force a page reload.

Hope this is useful to you!

Demo video of the new PDF tunebook tune hyperlinks in the Table of Contents and Index pages:

https://youtu.be/4mxMUuem-2o

Full details at:

http://michaeleskin.com/abctools/userguide.html#adding_a_pdf_tunebook_table_of_contents_and_index

Try my ABC Tools at:

http://michaeleskin.com/abc

« Last Edit: May 31, 2023, 07:39:26 PM by Michael Eskin »
Logged

Roger Hare

  • Hero Member
  • *****
  • Offline Offline
  • Posts: 949
  • Urmston, Lancashire, U.K. éééé
Re: My new client-side abcjs-based ABC converter
« Reply #64 on: June 01, 2023, 07:55:17 AM »

IIn my ABC Tools, I've completely reworked the Table of Contents and Index pages as well as their sorted versions etc...
I tried this yesterday on a small (5 tunes) tune book. It works beautifully!
Logged
My ABC tune collections can be found here (GoogleDrive) & here (Dropbox).

For more about Manchester Morris, The Beech Band Folk Club or anything else,  please use the private messaging facility.

Michael Eskin

  • Hero Member
  • *****
  • Offline Offline
  • Posts: 547
    • AppCordions
Re: My new client-side abcjs-based ABC converter
« Reply #65 on: June 01, 2023, 11:41:26 PM »

ABC Transcription Tools Demo - How to use Adobe Acrobat to automatically convert any URLs in your PDF tunebooks to clickable hyperlinks:

https://youtu.be/_Mh9WwbpoAs
Logged

Michael Eskin

  • Hero Member
  • *****
  • Offline Offline
  • Posts: 547
    • AppCordions
Re: My new client-side abcjs-based ABC converter
« Reply #66 on: June 02, 2023, 07:15:02 AM »

Major new ABC Transcription Tools feature 1 June 2023


You may now add hyperlinks to your PDF tunebook title page title and subtitle, as well as page headers and page footers.


The new ABC comment-based directives are:


To add a title page to your PDF tunebook as a hyperlink, simply add the following comment-based annotation anywhere in the ABC:


%urladdtitle URL (your tunebook title text goes here...)


To add a smaller subtitle as a hyperlink below the title on the title page, simply add the following comment-based annotation anywhere in the ABC:


%urladdsubtitle URL (your tunebook title page subtitle text goes here...)


Examples:


%urladdtitle http://michaeleskin.com Tunebook Title with Hyperlink


%urladdsubtitle http://michaeleskin.com/abc Tunebook Subtitle with Hyperlink


If you'd like to link to a specific URL when users click in the PDF page header or footer, include either the following ABC comment-based annotations anywhere in your ABC:


%urlpageheader (URL) (your header text goes here...)


%urlpagefooter (URL) (your footer text goes here...)


Examples:

%urlpageheader http://michaeleskin.com/abc Click in this page header to visit my home page


%urlpagefooter http://michaeleskin.com/abc Click in this page footer to visit my home page


For the full list of available PDF tunebook directives, please check out the User Guide at:


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


Demo  video:


https://youtu.be/zh8qZhVwVek


This was very messy to implement. Testing looks good, but if you run into anything that seems to be broken, please let me know.
Logged

Chris Ryall

  • "doc 3-row"
  • French Interpreter
  • Hero Member
  • *****
  • Offline Offline
  • Posts: 11153
  • Wirral UK
    • Chris Ryall
Re: My new client-side abcjs-based ABC converter
« Reply #67 on: June 02, 2023, 09:43:35 AM »


 It’s now 3 months since anyone else commented, Michael. Just to suggest that you might simply manage this more efficiently as a static help page on your site. anyone using it is unlikely to plough through … … …  four pages of minor tweaks to find what they want?

 if your purpose is rather to advertise the facility?  … we’ve got the message 🙂
Logged
  _       _    _      _ 

Michael Eskin

  • Hero Member
  • *****
  • Offline Offline
  • Posts: 547
    • AppCordions
Re: My new client-side abcjs-based ABC converter
« Reply #68 on: June 02, 2023, 03:27:43 PM »

Chris, I don't make any money from this tool. It free to use and I give away the full source code on GitHub.

Some people actually appreciate hearing about new features and send me emails and messages with suggestions for additional features they'd like to see added in the future.

Nearly every one of the posts here is because somebody either on this board or another board sent me a suggestion for a feature.

For example, the recent focus on adding hyperlinks to titles and page headers was directly from a suggestion by a user earlier in the week.  I added the feature and I let others know it is now available.

When I started the project I had no idea it would get this full-featured. I was just trying to create a completely client-side replacement for the now defunct mandolintab.net converter which I previously used almost daily to generate handouts for lessons and tune PDFs for both myself and other players in my Irish session.

As I add new features I let people know about them here and on other boards where people commonly use ABC tools.  I didn't intend for this to turn into some kind of extended multi page post.

But here we are.

Chris, if you don't care or for some reason offended by my posts, just don't read the thread and never use the tool.  Don't know what else to say.
« Last Edit: June 02, 2023, 04:25:59 PM by Michael Eskin »
Logged

Michael Eskin

  • Hero Member
  • *****
  • Offline Offline
  • Posts: 547
    • AppCordions
Re: My new client-side abcjs-based ABC converter
« Reply #69 on: June 11, 2023, 04:48:18 PM »

Here's the recording of this morning's (Saturday, June 11, 2023) ABC Transcription Tools Webinar and Q&A on Zoom (90 minutes):

https://youtu.be/qKu1IcSjfEQ
Logged

Michael Eskin

  • Hero Member
  • *****
  • Offline Offline
  • Posts: 547
    • AppCordions
Re: My new client-side abcjs-based ABC converter
« Reply #70 on: June 12, 2023, 07:38:46 PM »

In my ABC Tools, you now have two new comment-based directives for PDF tunebooks that embed a link on each page of music back to either the index or the table of contents for quick navigation:
 
%addlinkbacktotoc
or
%addlinkbacktoindex
 
If either of these are present, I add a "<<" on the left side of each page of music that links back to either the table of contents, and/or a ">>" on the right side that links to the index.

As previously the table of contents and index entries link back to the tunes, so now there are two-way links between the tunes and the table of contents or index.
« Last Edit: June 13, 2023, 03:35:02 PM by Michael Eskin »
Logged

Michael Eskin

  • Hero Member
  • *****
  • Offline Offline
  • Posts: 547
    • AppCordions
Re: My new client-side abcjs-based ABC converter
« Reply #71 on: June 15, 2023, 03:42:27 AM »

My ABC Transcription tool can now add hyperlinks to external websites to the tune notation in a PDF tunebook.

Tune hyperlinks are available for tune notation and tune incipits tunebooks, and are not available for ABC text incipit tunebooks.

When a hyperlink is present, touch the title of the tune and you will automatically launch the associated tune hyperlink.

To add a hyperlink to an external website in any tune, add the following comment-based annotation anywhere in the ABC for a specific tune:

%hyperlink URL

Examples:

%hyperlink http://michaeleskin.com

%hyperlink https://cnn.com

You may automatically add a hyperlink for every tune to the thesession.org search page for the tune title by adding the following comment-based annotation anywhere in the ABC file:

%addlinkstothesession

Any manually added tune hyperlinks take precedence over an automatically generated thesession.org hyperlink.

Demo video:

https://youtu.be/Na4XwOKYP4A
Logged

Michael Eskin

  • Hero Member
  • *****
  • Offline Offline
  • Posts: 547
    • AppCordions
Re: My new client-side abcjs-based ABC converter
« Reply #72 on: June 17, 2023, 12:36:53 AM »

Added a bunch of new PDF hyperlink features to my ABC Transcription Tools, including an new option to have either all the tunes or any specific tune in the PDF automatically link back to Paul Rosen's ABCjs QuickEditor site for playback:

Here's the section in the user guide:

The tool can add hyperlinks to external websites to the tune notation in a PDF tunebook.

Tune hyperlinks are available for tune notation and tune incipits tunebooks, and are not available for ABC text incipit tunebooks.

When a hyperlink is present, touch the title of the tune and you will automatically launch the associated tune hyperlink.

To add a hyperlink to an external website in any tune, add the following comment-based annotation anywhere in the ABC for a specific tune:

%hyperlink URL

Examples:

%hyperlink http://michaeleskin.com

%hyperlink https://cnn.com

To add a hyperlink to Paul Rosen's ABC Quick Editor for playing a specific tune with a specific General MIDI program number sound, add the following comment-based annotation anywhere in the ABC for a specific tune:

%add_playback_link MIDI_PROGRAM_NUMBER

The MIDI_PROGRAM_NUMBER is optional.

Some MIDI program numbers I recommend:

74 - Flute, 49 - Fiddle, 23 - Accordion, 25 - Guitar, or 0 - Piano

Example: To have a specific tune played with a fiddle sound

X:1
T:The Tarbolton
M:4/4
K:Edor
%add_playback_link 49
Beed e2BA|GBAF GFEF|Dddc d2AG|FAGE FEDF|
Eeed efge|fedf e2BA|GABG FGAF|BGAF GEE2:|
|:gfef gebe|gebe gfec|d2fd Adfd|cdAG FDEF|
GABG FGAF|E2ef gfed|BcdB A2FA|BGAF GEE2:|

To add a hyperlink to a specific tune to the thesession.org search page for the tune title, add the following comment-based annotation anywhere in the ABC for a specific tune:

%add_link_to_thesession

Example:

X:1
T:The Tarbolton
M:4/4
K:Edor
%add_link_to_thesession
Beed e2BA|GBAF GFEF|Dddc d2AG|FAGE FEDF|
Eeed efge|fedf e2BA|GABG FGAF|BGAF GEE2:|
|:gfef gebe|gebe gfec|d2fd Adfd|cdAG FDEF|
GABG FGAF|E2ef gfed|BcdB A2FA|BGAF GEE2:|

Precedence order for multiple manually added hyperlinks on one specific tune is website hyperlinks take highest priority, then playback hyperlinks, then thesession.org hyperlinks.

Adding playback or thesession.org hyperlinks to every tune in a PDF tunebook:

You may automatically add a hyperlink for every tune to Paul Rosen's ABC Quick Editor for playing the tune with a specific General MIDI program number sound by adding the following comment-based annotation anywhere in the ABC file:

%add_all_playback_links MIDI_PROGRAM_NUMBER

The MIDI_PROGRAM_NUMBER is optional.

Some MIDI program numbers I recommend:

74 - Flute, 49 - Fiddle, 23 - Accordion, 25 - Guitar, or 0 - Piano

Example: To have all tunes played with a flute sound

%add_all_playback_links 74

You may automatically add a hyperlink for every tune to the thesession.org search page for the tune title by adding the following comment-based annotation anywhere in the ABC file:

%add_all_links_to_thesession

%add_all_playback_links takes precedence for all tunes over %add_all_links_to_thesession

Any manually added tune hyperlinks, thesession.org hyperlinks, or playback hyperlinks take precedence over automatically generated thesession.org or playback hyperlinks.

Demo video:

https://youtu.be/EcSknrJOxBE
« Last Edit: June 17, 2023, 04:52:48 PM by Michael Eskin »
Logged

Lester

  • MADman
  • Mods and volunteers
  • Hero Member
  • ***
  • Offline Offline
  • Posts: 9327
  • Hohners'R'me
    • Lester's Melodeon Emporium and Tune-a-Rama
Re: My new client-side abcjs-based ABC converter
« Reply #73 on: June 17, 2023, 09:10:43 AM »

I like the hyperlink additions a lot. Just means I will have to redo my Slow and Steady Session's Tunebook yet again (:)

Michael Eskin

  • Hero Member
  • *****
  • Offline Offline
  • Posts: 547
    • AppCordions
Re: My new client-side abcjs-based ABC converter
« Reply #74 on: June 19, 2023, 06:10:10 PM »

I like the hyperlink additions a lot. Just means I will have to redo my Slow and Steady Session's Tunebook yet again (:)

Glad they are useful!
Logged

Michael Eskin

  • Hero Member
  • *****
  • Offline Offline
  • Posts: 547
    • AppCordions
Re: My new client-side abcjs-based ABC converter
« Reply #75 on: June 19, 2023, 08:02:49 PM »

I've added a bunch of new features and enhancements related to share URL shortening and QR codes in PDF files.

ABC Share URLs can get pretty long, particularly for large sets of tunes.

A third-party service like TinyURL can be used to shorten the ABC Share URLs.

Click "Shorten URL" to automatically copy the ABC Share URL to the clipboard and then launch TinyURL in another browser tab.

Paste the already copied ABC Share URL into the TinyURL "Enter long link" box and click "Shorten URL".

You may have to agree to the TinyURL terms-of-service before you can shorten the URL.

Copy the shortened URL from TinyURL and paste it into emails or share it on social media.

For example, here is the "Sliabh Notes" polka set Share URL as a shortened URL:

https://tinyurl.com/5n9293yu

TinyURL also allows you to create and save a simple QR code for the shortened URL.

Note: Incorporating URL shortening  directly into the tool itself would require having a server-side component (since it's a very bad idea to include service API keys in client-side code) to call the URL shortening service APIs.

This would go against my "no reliance on server-side code" requirement for this tool.

Additionally, URL shortening services like TinyURL have a limited number of free shortening calls per month for web applications before you need to go to a paid service. 

I'd probably run out of free shortened URLs in the first week or two of each month. 

Individuals should have no problem shortening as many URLs as they like using the streamlined manual system now in the app.

Also, you can now override the automatically generated ABC share URL used during PDF file QR Code generation:

%qrcode URL

where the URL is optional. If not present, it uses the ABC share link generated by the tool to create the QR code.

You can also now override the caption under the QR code with the following directive:

%caption_for_qrcode YOUR_CAPTION_FOR_THE_QR_CODE_HERE

If not present, it will use the auto-generated QR code based on the tune names in the tunebook.

QR codes and their captions in PDF tunebooks now also have clickable hyperlinks to the URL used to create the QR code.

Demo video on Share URL shortening assist using TinyURL:

https://youtu.be/MZEsEPnr7Sk
« Last Edit: June 20, 2023, 01:10:47 AM by Michael Eskin »
Logged

Michael Eskin

  • Hero Member
  • *****
  • Offline Offline
  • Posts: 547
    • AppCordions
Re: My new client-side abcjs-based ABC converter
« Reply #76 on: June 22, 2023, 10:00:02 PM »

In case anyone wants a PDF version of the ABC Transcription Tools User Guide:

http://michaeleskin.com/documents/abc_transcription_tools_user_guide_22jun2023.pdf
Logged

Michael Eskin

  • Hero Member
  • *****
  • Offline Offline
  • Posts: 547
    • AppCordions
Re: My new client-side abcjs-based ABC converter
« Reply #77 on: June 25, 2023, 02:28:06 AM »

Power user tip for using a shortened URL to add a QR code to a PDF tunebook that has too many tunes to create a normal ABC Share URL QR code:

https://youtu.be/f8c8gPx6Q5I
Logged

Michael Eskin

  • Hero Member
  • *****
  • Offline Offline
  • Posts: 547
    • AppCordions
Re: My new client-side abcjs-based ABC converter
« Reply #78 on: June 27, 2023, 03:02:43 AM »

Keeping busy while recovering from my wisdom teeth extraction:

You can now play your ABC tunes from right inside the ABC Transcription Tools!

To play a specific tune, click anywhere in the ABC for the tune and then click "Play".

The tool will automatically find the tune you've clicked on bring it up in a window for playback.

Using the playback controls at the bottom, you can enable looping, rewind to start, start/pause playback, click in the progress bar to seek, or change the tempo as a percentage.

Click "Close" to return to the ABC editor.

If you hold down the Shift key while clicking the Play button the tool will automatically find the tune you've clicked on and send it to Paul Rosen's abcjs Quick Editor for playback:

If there is a text selection in the ABC area, whatever is selected will be sent.

You can use this to send more than one tune to the abcjs Quick Editor

The abcjs Quick Editor only plays the first tune in it's own ABC editor.

If you select more than one tune in the ABC editor, and click "Play", you will need to edit the ABC in the abcjs Quick Editor editor to bring the tune you are interested in playing to the top.

The abcjs Quick Editor can also export MIDI and audio files of tunes.

Once you are happy with the playback, copy the ABC from the "abcjs Quick Editor tool, then paste the edited ABC back into this tool for further editing.

If you single-clicked and played one tune, the entire tune will be selected when you come back to the tool from the abcjs Quick Editor.

This makes it simple to paste any changes you might have made and copied from the abcjs Quick Editor.

Selecting the Instrument for Playback

You may select which instrument sound the abcjs Quick Editor uses for playback of your tunes.

By default, the instrument used is a piano.

To choose the sound when played, add an additional line to your ABC right after any headers and before the ABC notes, for example for a flute sound:

%%MIDI program 74

To change the instrument used for playback, change the MIDI program # above to one of:

74 - Flute, 49 - Fiddle, 23 - Accordion, 25 - Guitar, or 0 - Piano

For example:

X: 1
T: The Kesh
R: Jig
M: 6/8
L: 1/8
K: Gmaj
%%MIDI program 74
D|: GAG GAB | ABA ABd | edd gdd | edB dBA |
GAG GAB | ABA ABd | edd gdB |1 AGF G2D :|2 AGF G2A||
|: B2B dBd | ege dBA | BAB dBG | ABA AGA |
B2 B dBd | ege dBd | gfg aga |1 bgg g2A :|2 bgg g2D |]

Any General MIDI (level 1) instrument number can be selected.

Visit https://www.midi.org/specifications-old/item/gm-level-1-sound-set for the full list of MIDI instruments and their program numbers.

Power User Tip:

To have the tool automatically inject a %%MIDI program directive for every tune with a specific MIDI instrument program number, hold down the Alt-key while clicking the "Play" button.

You will be prompted for a MIDI instrument program number to inject.

Demo video:

https://www.youtube.com/watch?v=bLV8XsYTIkc

More on the auto-injection of melody and chord MIDI program numbers feature:

https://youtu.be/N3oF5NLPJ_c
« Last Edit: June 27, 2023, 10:17:28 PM by Michael Eskin »
Logged

Michael Eskin

  • Hero Member
  • *****
  • Offline Offline
  • Posts: 547
    • AppCordions
Re: My new client-side abcjs-based ABC converter
« Reply #79 on: June 27, 2023, 04:52:20 AM »

New playback features are detailed in the latest PDF User Guide:
 

http://michaeleskin.com/documents/abc_transcription_tools_user_guide_26jun2023.pdf
Logged
Pages: 1 2 3 [4] 5   Go Up
 


Melodeon.net - (c) Theo Gibb; Clive Williams 2010. The access and use of this website and forum featuring these terms and conditions constitutes your acceptance of these terms and conditions.
SimplePortal 2.3.5 © 2008-2012, SimplePortal