-
Notifications
You must be signed in to change notification settings - Fork 24
/
userguide.html
4520 lines (4400 loc) · 451 KB
/
userguide.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
<!DOCTYPE html>
<html>
<head>
<title>ABC Transcription Tools User Guide</title>
<meta charset="UTF-8">
<meta http-equiv="Content-Type" content="text/html">
<meta content="ABC transposer ABCtransposer transpose jig reel folk" name="keywords">
<meta content="A simple-to-use ABC to standard music notation converter featuring tune play, transposition, tab generation, PDF export, and much more!" name="description">
<meta content="A simple-to-use ABC to standard music notation converter featuring tune play, transposition, tab generation, PDF export, and much more!" name="abstract">
<meta property="og:locale" content="en_US" />
<meta name="description" content="A simple-to-use ABC to standard music notation converter featuring tune play, transposition, tab generation, PDF export and much more!" />
<meta property="og:type" content="website" />
<meta property="og:title" content="Michael Eskin's ABC Transcription Tools User Guide" />
<meta property="og:description" content="A simple-to-use ABC to standard music notation converter featuring tune play, transposition, tab generation, PDF export and much more!" />
<meta property="og:url" content="https://michaeleskin.com/abctools/userguide.html" />
<meta property="og:site_name" content="Michael Eskin's ABC Transcription Tools User Guide" />
<meta property="og:image" content="https://michaeleskin.com/abctools/img/abc-icon-user-guide-basic.png" />
<meta name="msapplication-TileColor" content="#ffffff">
<meta name="msapplication-TileImage" content="https://michaeleskin.com/abctools/img/abc-ms-icon-144x144.png">
<meta name="theme-color" content="#ffffff">
<meta name="apple-mobile-web-app-title" content="ABC Tools">
<meta name="application-name" content="ABC Tools">
<meta name="viewport" content="width=860">
<link rel="apple-touch-icon" sizes="57x57" href="https://michaeleskin.com/abctools/img/abc-apple-icon-57x57.png">
<link rel="apple-touch-icon" sizes="60x60" href="https://michaeleskin.com/abctools/img/abc-apple-icon-60x60.png">
<link rel="apple-touch-icon" sizes="72x72" href="https://michaeleskin.com/abctools/img/abc-apple-icon-72x72.png">
<link rel="apple-touch-icon" sizes="76x76" href="https://michaeleskin.com/abctools/img/abc-apple-icon-76x76.png">
<link rel="apple-touch-icon" sizes="114x114" href="https://michaeleskin.com/abctools/img/abc-apple-icon-114x114.png">
<link rel="apple-touch-icon" sizes="120x120" href="https://michaeleskin.com/abctools/img/abc-apple-icon-120x120.png">
<link rel="apple-touch-icon" sizes="144x144" href="https://michaeleskin.com/abctools/img/abc-apple-icon-144x144.png">
<link rel="apple-touch-icon" sizes="152x152" href="https://michaeleskin.com/abctools/img/abc-apple-icon-152x152.png">
<link rel="apple-touch-icon" sizes="180x180" href="https://michaeleskin.com/abctools/img/abc-apple-icon-180x180.png">
<link rel="icon" type="image/png" sizes="192x192" href="https://michaeleskin.com/abctools/img/abc-android-icon-192x192.png">
<link rel="icon" type="image/png" sizes="32x32" href="https://michaeleskin.com/abctools/img/abc-favicon-32x32.png">
<link rel="icon" type="image/png" sizes="96x96" href="https://michaeleskin.com/abctools/img/abc-favicon-96x96.png">
<link rel="icon" type="image/png" sizes="16x16" href="https://michaeleskin.com/abctools/img/abc-favicon-16x16.png">
<link rel="manifest" href="https://michaeleskin.com/abctools/img/abc-manifest.json">
<style>
p {
font-size:14pt;
font-family:"Helvetica";
line-height: 26px;
margin-bottom: 0px;
}
h1 {
text-align: center;
font-size:18pt;
line-height:32px;
font-family:"Helvetica";
margin-bottom:32px;
padding-left:75px;
}
.h1wide{
padding-left:0px !important;
}
@media print {
h1 {
padding-left:0px;
}
}
hr {
margin-top:24px;
margin-bottom:24px;
}
body {
text-align: center;
}
#maindiv{
position: absolute;
left: 50%;
margin-right: -50%;
transform: translate(-50%, 0%);
text-align: left;
width: 700px;
background-color: white;
}
.image_holder{
text-align: center;
}
.image_holder_p{
text-align: center;
margin-top:24px;
}
.toc{
margin-top:0px;
margin-bottom:12px;
}
.accordion {
font-size:14pt !important;
font-family:"Helvetica" !important;
background-color: #eee;
color: #000 !important;
cursor: pointer !important;
padding: 14px !important;
width: 100% !important;
text-align: left !important;
border: .5px solid #000 !important;
outline: none !important;
margin-bottom:8px;
}
.accordion::after {
content: "+";
font-size: 14pt;
font-weight: bold;
position: absolute;
right: 14px; /* Adjust this value as needed */
top: 50%;
transform: translateY(-50%);
}
.active {
background-color: #eee;
}
.active::after {
content: "-";
font-size: 18pt;
font-weight: bold;
position: absolute;
right: 14px; /* Adjust this value as needed */
top: 50%;
transform: translateY(-50%);
}
@media not all and (pointer: coarse) {
.accordion:hover {
background-color: #9f9;
}
}
.expandall{
font-size:11pt !important;
font-family:"Helvetica" !important;
width:120px !important;
height:40px !important;
padding:7px !important;
border-radius:4px !important;
border:.5px solid #000 !important;
color:black !important;
background-color: #eee;
}
@media not all and (pointer: coarse) {
.expandall:hover {
background-color: #9f9;
}
}
.tocpanel {
padding: 12px !important;
padding-left: 60px !important;
background-color: white !important;
display: none;
overflow: hidden !important;
}
.code {
padding:8px;
font-family: monospace; !important;
color:white;
background-color: black;
line-height: 28px;
}
@media print {
.hidden-print {
display: none !important;
}
}
.page_break_always{
page-break-before: always;
}
.page_break_never {
page-break-before: avoid;
}
@media (hover: hover) {
iframe
{
transition: transform .2s ease-in-out 0s;
}
iframe:hover {
transform: matrix(1.05, 0, 0, 1.05, 0, 0);
}
.accordion
{
transition: transform .2s ease-in-out 0s;
}
.accordion:hover {
transform: matrix(1.025, 0, 0, 1.025, 0, 0);
}
.expandall
{
transition: transform .2s ease-in-out 0s;
}
.expandall:hover {
transform: matrix(1.05, 0, 0, 1.05, 0, 0);
}
}
</style>
</head>
<body>
<div id="table_of_contents" style="padding:10px;">
<div id="maindiv">
<div style="text-align: center;">
<font id="pagetitle" face="Comic Sans MS" size="5">ABC Transcription Tools User Guide</font><br/>
</div>
<hr class="hidden-print">
<div class="hidden-print">
<p style="margin-bottom:20px;line-height:12px;padding-left:0px;text-align: center;">To search for any subject press Ctrl+F (Windows) or ⌘+F (Mac)</p>
<hr>
<p style="margin-bottom:20px;line-height:12px;padding-left:0px;text-align: center;">Click any topic to show/hide the subtopics</p>
<h1 style="margin-bottom:16px;padding-left:0px;"><button class="expandall" onclick="ExpandAll();">Expand All</button> <button class="expandall" onclick="CollapseAll();">Collapse All</button></h1>
<button class="accordion" title="Click to expand/collapse this section">Basic Operation</button>
<div class="tocpanel">
<p class="toc"><a style="text-decoration:none;" href="#introduction">Introduction</a></p>
<p class="toc"><a style="text-decoration:none;" href="#getting_started">Getting Started</a></p>
<p class="toc"><a style="text-decoration:none;" href="#abc_editor">ABC Editor</a></p>
<p class="toc"><a style="text-decoration:none;" href="#abc_editor_resize">Resizing the ABC Editor</a></p>
<p class="toc"><a style="text-decoration:none;" href="#top_bar_buttons">Top Bar Buttons</a></p>
<p class="toc"><a style="text-decoration:none;" href="#open_dialog">Open an ABC, MusicXML, BWW, or MIDI File</a></p>
<p class="toc"><a style="text-decoration:none;" href="#add_templates_dialog">Adding Your Own Tunes to Your Tunebook</a></p>
<p class="toc"><a style="text-decoration:none;" href="#search_and_add_tunes">Search and Add Tunes</a></p>
<p class="toc"><a style="text-decoration:none;" href="#change_tune_order">Change the Order of the Tunes</a></p>
<p class="toc"><a style="text-decoration:none;" href="#delete_selected_tunes">Delete Tunes from the Tunebook</a></p>
<p class="toc"><a style="text-decoration:none;" href="#add_examples">Adding Example Tunes and Templates to Your Tunebook</a></p>
<p class="toc"><a style="text-decoration:none;" href="#highlighting">Notation and ABC Highlighting</a></p>
<p class="toc"><a style="text-decoration:none;" href="#viewing_the_notation_full_screen">Viewing the Notation Full Screen</a></p>
</div>
<button class="accordion" title="Click to expand/collapse this section">Controls and Features</button>
<div class="tocpanel">
<p class="toc"><a style="text-decoration:none;" href="#basic_controls">Basic Controls and Features</a></p>
<p class="toc"><a style="text-decoration:none;" href="#basic_tablature">Notation and Tablature Display</a></p>
<p class="toc"><a style="text-decoration:none;" href="#basic_transpose">Transpose Controls</a></p>
<p class="toc"><a style="text-decoration:none;" href="#basic_snapshot">Saving and Restoring Snapshots</a></p>
<p class="toc"><a style="text-decoration:none;" href="#basic_more_tools">More ABC Tools</a></p>
<p class="toc"><a style="text-decoration:none;" href="#basic_sharing">Share Controls</a></p>
<p class="toc"><a style="text-decoration:none;" href="#basic_clear">Clearing the ABC Editor</a></p>
</div>
<button class="accordion" title="Click to expand/collapse this section">Playing Your Tunes</button>
<div class="tocpanel">
<p class="toc"><a style="text-decoration:none;" href="#playing_your_tunes">Playing Your Tunes</a></p>
<p class="toc"><a style="text-decoration:none;" href="#tune_trainer">"Step-Up" Tempo Tune Trainer</a></p>
</div>
<button class="accordion" title="Click to expand/collapse this section">Selecting Playback Instruments</button>
<div class="tocpanel">
<p class="toc"><a style="text-decoration:none;" href="#selecting_the_instruments_for_playback">Choosing the MIDI Soundfont and Instruments for Playback</a></p>
<p class="toc"><a style="text-decoration:none;" href="#general_midi_instrument_program_numbers">General MIDI Instrument Program Numbers</a></p>
<p class="toc"><a style="text-decoration:none;" href="#general_midi_percussion_map">General MIDI Drum Sound ABC Note Map</a></p>
<p class="toc"><a style="text-decoration:none;" href="#banjo_style">Using the Tenor Banjo (%%MIDI program 105) Instrument</a></p>
<p class="toc"><a style="text-decoration:none;" href="#bodhran_map">Using the Bodhran (%%MIDI program 117) Instrument</a></p>
<p class="toc"><a style="text-decoration:none;" href="#uilleann_map">Using the Uilleann Pipes (%%MIDI program 129) Instrument</a></p>
<p class="toc"><a style="text-decoration:none;" href="#looping_drones">Automatic Looping Bagpipe Drones</a></p>
<p class="toc"><a style="text-decoration:none;" href="#marching_drums_map">Using the Marching Drums (%%MIDI program 142) Instrument</a></p>
<p class="toc"><a style="text-decoration:none;" href="#voice_tuning">Setting the Tuning Offset for Individual Voices</a></p>
<p class="toc"><a style="text-decoration:none;" href="#reverb">Adding Reverb When Playing Tunes</a></p>
</div>
<button class="accordion" title="Click to expand/collapse this section">Exporting Tune Audio or Image Files from the Player</button>
<div class="tocpanel">
<p class="toc"><a style="text-decoration:none;" href="#export_audio_image">Exporting Tune Audio or Image Files from the Player</a></p>
</div>
<button class="accordion" title="Click to expand/collapse this section">Advanced Playback Features</button>
<div class="tocpanel">
<p class="toc"><a style="text-decoration:none;" href="#adding_swing">Adding Playback Swing to Tunes</a></p>
<p class="toc"><a style="text-decoration:none;" href="#grace_timing">Setting Grace Note Duration for Ornamentation</a></p>
<p class="toc"><a style="text-decoration:none;" href="#roll_timing">Defining Custom Roll Timing Parameters</a></p>
<p class="toc"><a style="text-decoration:none;" href="#custom_ornament_timing">Custom Timing and Offsets for Trills, Mordents, and Turns</a></p>
<p class="toc"><a style="text-decoration:none;" href="#custom_backup_rhythms">Custom Backup Rhythms</a></p>
<p class="toc"><a style="text-decoration:none;" href="#custom_backup_beat_timing">Custom Backup Beat Timing</a></p>
<p class="toc"><a style="text-decoration:none;" href="#strummed_chords">Enabling Strummed Chords</a></p>
<p class="toc"><a style="text-decoration:none;" href="#midigchord">Using %%MIDI gchord for Custom Backup Patterns</a></p>
<p class="toc"><a style="text-decoration:none;" href="#inversions">Specifying Chord Inversions in the ABC</a></p>
<p class="toc"><a style="text-decoration:none;" href="#sung_solfege">Select the Solfège Instrument to Sing Note Names</a></p>
<p class="toc"><a style="text-decoration:none;" href="#voice_hiding">Voice Combining and Hiding</a></p>
<p class="toc"><a style="text-decoration:none;" href="#highlighting_control">Controlling Note Highlighting in the Player</a></p>
</div>
<button class="accordion" title="Click to expand/collapse this section">More ABC Tools</button>
<div class="tocpanel">
<p class="toc"><a style="text-decoration:none;" href="#more_tools">More ABC Tools</a></p>
<button class="accordion" title="Click to expand/collapse this section">Hiding/Showing ABC Annotations, Text, Chords, Tab, and Ornaments</button>
<div class="tocpanel">
<p class="toc"><a style="text-decoration:none;" href="#advanced_showhidefeatures">Hide/Show ABC Features</a></p>
<p class="toc"><a style="text-decoration:none;" href="#advanced_showhideannotations">Hide/Show Annotations</a></p>
<p class="toc"><a style="text-decoration:none;" href="#advanced_showhidetext">Hide/Show Text</a></p>
<p class="toc"><a style="text-decoration:none;" href="#advanced_showhidechords">Hide/Show Chords</a></p>
<p class="toc"><a style="text-decoration:none;" href="#advanced_showhidetab">Hide/Show Injected Tab</a></p>
<p class="toc"><a style="text-decoration:none;" href="#advanced_showhideornaments">Hide/Show Ornaments</a></p>
</div>
<button class="accordion" title="Click to expand/collapse this section">Stripping Out ABC Annotation, Text, Chords, Tab, and Ornaments</button>
<div class="tocpanel">
<p class="toc"><a style="text-decoration:none;" href="#advanced_stripfeatures">Strip ABC Features</a></p>
<p class="toc"><a style="text-decoration:none;" href="#advanced_stripannotations">Strip Annotations</a></p>
<p class="toc"><a style="text-decoration:none;" href="#advanced_striptext">Strip Text</a></p>
<p class="toc"><a style="text-decoration:none;" href="#advanced_stripchords">Strip Chords</a></p>
<p class="toc"><a style="text-decoration:none;" href="#advanced_striptab">Strip Injected Tab</a></p>
<p class="toc"><a style="text-decoration:none;" href="#advanced_stripornaments">Strip Ornaments</a></p>
</div>
<button class="accordion" title="Click to expand/collapse this section">Useful Utilities for Injecting ABC Annotations and Features</button>
<div class="tocpanel">
<p class="toc"><a style="text-decoration:none;" href="#advanced_injectionfeatures">ABC Utility Injection Features</a></p>
<p class="toc"><a style="text-decoration:none;" href="#advanced_injecttunetitlenumbers">Inject Tune Title Numbers</a></p>
<p class="toc"><a style="text-decoration:none;" href="#advanced_injectsectionheader">Inject PDF Section Header</a></p>
<p class="toc"><a style="text-decoration:none;" href="#advanced_inject_font_settings">Inject Font Settings</a></p>
<p class="toc"><a style="text-decoration:none;" href="#advanced_injectmidi">Inject MIDI Programs and Volumes</a></p>
<p class="toc"><a style="text-decoration:none;" href="#advanced_injectmetronome">Inject Metronome</a></p>
<p class="toc"><a style="text-decoration:none;" href="#injectrepeatsandtwobarclickintros">Inject Repeats + Intros</a></p>
<p class="toc"><a style="text-decoration:none;" href="#advanced_injectabcheader">Inject ABC Header Text</a></p>
<p class="toc"><a style="text-decoration:none;" href="#advanced_injectstaffwidth">Inject %%staffwidth</a></p>
</div>
</div>
<button class="accordion" title="Click to expand/collapse this section">Tablature, Comhaltas Transform, Shape Note, and Solfège Injectors</button>
<div class="tocpanel">
<p class="toc"><a style="text-decoration:none;" href="#injecting_tablature">Tablature, Comhaltas Transform, Shape Note, and Solfège Injectors</a></p>
<p class="toc"><a style="text-decoration:none;" href="#tab_box_bc">Inject B/C Box Tab</a></p>
<p class="toc"><a style="text-decoration:none;" href="#tab_box_cd">Inject C#/D Box Tab</a></p>
<p class="toc"><a style="text-decoration:none;" href="#reading_the_box_tablature">Reading the Box Tablature</a></p>
<p class="toc"><a style="text-decoration:none;" href="#tab_concertina">Inject Anglo Concertina Tab</a></p>
<p class="toc"><a style="text-decoration:none;" href="#reading_the_concertina_tablature">Reading the Anglo Concertina Tablature</a></p>
<p class="toc"><a style="text-decoration:none;" href="#tab_fiddle">Inject Fiddle Fingerings</a></p>
<p class="toc"><a style="text-decoration:none;" href="#tab_dulcimer">Inject Dulcimer Tab</a></p>
<p class="toc"><a style="text-decoration:none;" href="#tab_bamboo">Inject Bamboo Flute Tab</a></p>
<p class="toc"><a style="text-decoration:none;" href="#advanced_comhaltas">Comhaltas Transform</a></p>
<p class="toc"><a style="text-decoration:none;" href="#advanced_shapenoteshapes">Inject Shape Note/Solfège</a></p>
<p class="toc"><a style="text-decoration:none;" href="#tablature_settings">Configuring Tablature/Solfège Fonts and Settings</a></p>
<p class="toc"><a style="text-decoration:none;" href="#clearing_tablature">Clearing the Injected Tablature</a></p>
<p class="toc"><a style="text-decoration:none;" href="#tablature_limitations">Tablature/Solfège Injection Issues and Limitations</a></p>
</div>
<button class="accordion" title="Click to expand/collapse this section">Spacing, MIDI Instrument, Swing, Grace Duration, Roll, and Reverb Explorers</button>
<div class="tocpanel">
<p class="toc"><a style="text-decoration:none;" href="#advanced_notationspacingexplorer">Notation Spacing Explorer</a></p>
<p class="toc"><a style="text-decoration:none;" href="#midi_instrument_explorer">MIDI Instrument Explorer</a></p>
<p class="toc"><a style="text-decoration:none;" href="#swing_explorer">Swing Explorer</a></p>
<p class="toc"><a style="text-decoration:none;" href="#grace_duration_explorer">Grace Duration Explorer</a></p>
<p class="toc"><a style="text-decoration:none;" href="#roll_explorer">Roll Explorer</a></p>
<p class="toc"><a style="text-decoration:none;" href="#reverb_explorer">Reverb Explorer</a></p>
</div>
<button class="accordion" title="Click to expand/collapse this section">Export All Tunes, Sort by Tag, Transpose to Key, Inject Bagpipe Sounds + More</button>
<div class="tocpanel">
<p class="toc"><a style="text-decoration:none;" href="#export_all">Export All Tunes</a></p>
<p class="toc"><a style="text-decoration:none;" href="#export_all_as_mp3">Export All Tunes as Audio</a></p>
<p class="toc"><a style="text-decoration:none;" href="#export_all_images">Export All Tunes as Images</a></p>
<p class="toc"><a style="text-decoration:none;" href="#export_all_musicxml">Export All Tunes as MusicXML</a></p>
<p class="toc"><a style="text-decoration:none;" href="#smartdraw_export">SmartDraw Set List Builder</a></p>
<p class="toc"><a style="text-decoration:none;" href="#sort_dialog">Sort by Tag</a></p>
<p class="toc"><a style="text-decoration:none;" href="#incipits_builder">Incipits Builder</a></p>
<p class="toc"><a style="text-decoration:none;" href="#advanced_transposetokey">Transpose to Key</a></p>
<p class="toc"><a style="text-decoration:none;" href="#advanced_injectbagpipesounds">Inject Bagpipe Sounds</a></p>
<p class="toc"><a style="text-decoration:none;" href="#advanced_compliance">ABC Compliance Transform</a></p>
</div>
<button class="accordion" title="Click to expand/collapse this section">Sharing Tunes via Share URLs and QR Codes</button>
<div class="tocpanel">
<p class="toc"><a style="text-decoration:none;" href="#sharing_controls">Sharing Tunes with Share URLs and QR Codes</a></p>
<p class="toc"><a style="text-decoration:none;" href="#shortening_abc_share_urls">Shortening Share URLs</a></p>
<p class="toc"><a style="text-decoration:none;" href="#shared_tunes_open_full_screen">Shared Tunes Open Full Screen</a></p>
<p class="toc"><a style="text-decoration:none;" href="#adding_a_qr_code_to_the_pdf_export">Adding a QR Code to the PDF Export</a></p>
<p class="toc"><a style="text-decoration:none;" href="#reading_the_qr_codes">Reading the QR Codes</a></p>
<p class="toc"><a style="text-decoration:none;" href="#qr_code_example">QR Code Example</a></p>
<p class="toc"><a style="text-decoration:none;" href="#generate_share_link">Adding Tune Share Link Generation to Your Website</a></p>
</div>
<button class="accordion" title="Click to expand/collapse this section">PDF Tunebook Generation</button>
<div class="tocpanel">
<p class="toc"><a style="text-decoration:none;" href="#export_pdf_tunebook">Exporting a PDF Tunebook</a></p>
<p class="toc"><a style="text-decoration:none;" href="#pdf_font_override_settings">PDF Font Override Settings</a></p>
<p class="toc"><a style="text-decoration:none;" href="#pdf_quality_setting">PDF Quality Setting</a></p>
<p class="toc"><a style="text-decoration:none;" href="#pdf_tunebook_spacing_overrides">PDF Tunebook Tune Size and Layout Spacing Overrides</a></p>
<p class="toc"><a style="text-decoration:none;" href="#adding_a_pdf_title_page">Adding a PDF Tunebook Title Page</a></p>
<p class="toc"><a style="text-decoration:none;" href="#adding_a_pdf_tunebook_table_of_contents_and_index">Adding a PDF Tunebook Table of Contents and Index</a></p>
<p class="toc"><a style="text-decoration:none;" href="#pdf_section_headers">Adding Table of Contents and Index Section Headers</a></p>
<p class="toc"><a style="text-decoration:none;" href="#table_of_contents_and_index_font_size_and_spacing_overrides">Table of Contents and Index Font Size and Spacing Overrides</a></p>
<p class="toc"><a style="text-decoration:none;" href="#pdf_page_headers_and_footers">PDF Page Headers and Footers</a></p>
<p class="toc"><a style="text-decoration:none;" href="#tunebook_hyperlinks">PDF Tunebook Hyperlinks and Automatic Play Links</a></p>
</div>
<button class="accordion" title="Click to expand/collapse this section">PDF Tunebook Advanced Formatting</button>
<div class="tocpanel">
<p class="toc"><a style="text-decoration:none;" href="#custom_font_overrides">Custom Font Overrides</a></p>
<p class="toc"><a style="text-decoration:none;" href="#inject_fonts_into_share_links">Automatically Inject Fonts into Share Links</a></p>
</div>
<button class="accordion" title="Click to expand/collapse this section">All Available PDF Tunebook Annotations</button>
<div class="tocpanel">
<p class="toc"><a style="text-decoration:none;" href="#all_pdf_annotations">All Available PDF Tunebook Annotations</a></p>
</div>
<button class="accordion" title="Click to expand/collapse this section">Editing PDF Tunebooks With Other Tools</button>
<div class="tocpanel">
<p class="toc"><a style="text-decoration:none;" href="#editing_pdf_tunebooks">Editing PDF Tunebooks With Other Tools</a></p>
</div>
<button class="accordion" title="Click to expand/collapse this section">Tool Settings and Fonts</button>
<div class="tocpanel">
<p class="toc"><a style="text-decoration:none;" href="#settings_dialog">ABC Transcription Tools Settings</a></p>
<p class="toc"><a style="text-decoration:none;" href="#manage_databases">Managing Notes, Reverb, and Tune Search Databases for Offline Use</a></p>
<p class="toc"><a style="text-decoration:none;" href="#advanced_settings">Advanced Settings</a></p>
<p class="toc"><a style="text-decoration:none;" href="#advanced_resetsettings">Reset All Tool Settings</a></p>
<p class="toc"><a style="text-decoration:none;" href="#configure_fonts">Configuring ABC Rendering Fonts</a></p>
</div>
<button class="accordion" title="Click to expand/collapse this section">MusicXML/MIDI Import</button>
<div class="tocpanel">
<p class="toc"><a style="text-decoration:none;" href="#musicxml">MusicXML/MIDI Import Settings</a></p>
<p class="toc"><a style="text-decoration:none;" href="#microtonal">Importing MusicXML With Microtonal Accidentals</a></p>
</div>
<button class="accordion" title="Click to expand/collapse this section">Printing Your Tunes Using the Browser's Built-in Print Feature</button>
<div class="tocpanel">
<p class="toc"><a style="text-decoration:none;" href="#printing_your_tunes">Printing Your Tunes Using the Browser's Built-in Print Feature</a></p>
</div>
<button class="accordion" title="Click to expand/collapse this section">Advanced abcjs Rendering Options</button>
<div class="tocpanel">
<p class="toc"><a style="text-decoration:none;" href="#customabcjsparams">Adding Custom abcjs Rendering Parameters</a></p>
<p class="toc"><a style="text-decoration:none;" href="#expandtowidest">Opting-out of "Expand to Widest" Layout</a></p>
</div>
<button class="accordion" title="Click to expand/collapse this section">ABC Tricks and Tips</button>
<div class="tocpanel">
<p class="toc"><a style="text-decoration:none;" href="#largeprint">"Large Print" Edition Tune Notation</a></p>
<p class="toc"><a style="text-decoration:none;" href="#tabtranspose">Transposing Notation Independent of Tablature</a></p>
<p class="toc"><a style="text-decoration:none;" href="#learningtunes">Learning New Tunes Part-by-Part Using ABC</a></p>
<p class="toc"><a style="text-decoration:none;" href="#clicktrack">Adding a Two-Bar Click Intro to Tunes</a></p>
<p class="toc"><a style="text-decoration:none;" href="#abcadditions">Additional Tool-Specific ABC Directives</a></p>
<p class="toc"><a style="text-decoration:none;" href="#sequential_play">Creating Sets of Tunes that Will Play Sequentially in the Player</a></p>
<p class="toc"><a style="text-decoration:none;" href="#boxplayerstemplate">Useful Symbols for Annotating Box Transcriptions</a></p>
</div>
<button class="accordion" title="Click to expand/collapse this section">Adding Shape Note Shapes</button>
<div class="tocpanel">
<p class="toc"><a style="text-decoration:none;" href="#shapenote">Adding Shape Note Shapes</a></p>
</div>
<button class="accordion" title="Click to expand/collapse this section">Typing ABC Using a MIDI Input Device</button>
<div class="tocpanel">
<p class="toc"><a style="text-decoration:none;" href="#midi_input">Typing ABC Using a MIDI Input Device</a></p>
</div>
<button class="accordion" title="Click to expand/collapse this section">iOS-Specific Topics</button>
<div class="tocpanel">
<p class="toc"><a style="text-decoration:none;" href="#iphone_ipad_chord_entry_issue_fix">iPhone/iPad Chord Entry Issue Fix</a></p>
<p class="toc"><a style="text-decoration:none;" href="#goodreader">Using Interactive PDF Tunebooks with GoodReader</a></p>
<p class="toc"><a style="text-decoration:none;" href="#iosreset">Resetting the Tool on Safari for iOS</a></p>
</div>
<button class="accordion" title="Click to expand/collapse this section">ABC 2.1 Specification and Quick Reference Card</button>
<div class="tocpanel">
<p class="toc"><a style="text-decoration:none;" href="#abc_specification">ABC Specification</a></p>
<p class="toc"><a style="text-decoration:none;" href="#abc_21_quick_reference_card">ABC Quick Reference Card</a></p>
</div>
<button class="accordion" title="Click to expand/collapse this section">Demo Videos and Tutorials</button>
<div class="tocpanel">
<p class="toc"><a style="text-decoration:none;" href="#demovideos">Demo Videos and Tutorials</a></p>
</div>
<button class="accordion" title="Click to expand/collapse this section">Single Tune Optimized "Quick Editor" Version</button>
<div class="tocpanel">
<p class="toc"><a style="text-decoration:none;" href="#quickeditor">Single Tune Optimized "Quick Editor" Version</a></p>
</div>
<button class="accordion" title="Click to expand/collapse this section">Using the Tool Offline (Airplane Mode)</button>
<div class="tocpanel">
<p class="toc"><a style="text-decoration:none;" href="#app">Using the Tool Offline (Airplane Mode)</a></p>
</div>
<button class="accordion" title="Click to expand/collapse this section">Updating the Tool</button>
<div class="tocpanel">
<p class="toc"><a style="text-decoration:none;" href="#updatingthetool">Updating the Tool</a></p>
</div>
<button class="accordion" title="Click to expand/collapse this section">Uninstalling the Tool</button>
<div class="tocpanel">
<p class="toc"><a style="text-decoration:none;" href="#uninstall">Uninstalling the Tool</a></p>
</div>
<button class="accordion" title="Click to expand/collapse this section">Source Code, Privacy, Support, and Tip Jars</button>
<div class="tocpanel">
<p class="toc"><a style="text-decoration:none;" href="#github">Source Code Available on GitHub</a></p>
<p class="toc"><a style="text-decoration:none;" href="#run_from_source">Notes on Running the Tool from the GitHub Repo</a></p>
<p class="toc"><a style="text-decoration:none;" href="#privacy">Privacy</a></p>
<p class="toc"><a style="text-decoration:none;" href="#support">Support</a></p>
<p class="toc"><a style="text-decoration:none;" href="#tipjars">Tip Jars</a></p>
</div>
</div>
<hr class="hidden-print" id="introduction">
<h1 class="page_break_never">Introduction<span class="hidden-print"> (</span><a style="text-decoration:none;" href="#table_of_contents" class="hidden-print">Top</a><span class="hidden-print">)</span></h1>
<p class="hidden-print" style="margin-top:24px;margin-bottom:24px;text-align:center"><iframe width="620" height="338" loading="lazy" src="https://www.youtube.com/embed/NYCfRW8EbXM" title="ABC Transcription Tools Webinar" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture;" allowfullscreen></iframe></p>
<p>ABC Transcription Tools is a free, web-based, open-source tool for converting music in ABC, MusicXML, BWW, and MIDI format to both standard notation and tablature for a wide variety of instruments.</p>
<p>Imports and exports tunes in ABC, MusicXML, and MIDI formats.</p>
<p>Imports bagpipes tunes in BWW format.</p>
<p>Search for ABC tunes by name from a built-in database of over 60,000 ABC tune settings and quickly add them to your tunebooks.</p>
<p>Play your tunes with seven different soundfonts providing over 800 high-quality, sampled instruments.</p>
<p>Use the Tune Trainer to practice your tunes starting slowly and then with increasing tempos.</p>
<p>Create PDF tunebooks with title pages, table of contents, tune index, custom headers, footers, hyperlinks, tune incipits (notation or raw ABC), and sharing QR codes using the tool's built-in Export PDF feature.</p>
<p>Quickly transpose a single ABC tune or entire ABC tunebooks to any key.</p>
<p>Sort your tunes by name, key, meter, rhythm, and other ABC headers.</p>
<p>Search and replace text in your ABC with full regular expression support.</p>
<p>You can fully customize the look of your notation using the standard ABC spacing and font annotations.</p>
<p>Easily share your tunes with others via Share URLs and QR Codes.</p>
<p>After first run, the tool runs both online and offline (Airplane mode).</p>
<hr class="hidden-print" id="getting_started">
<h1 class="page_break_always">Getting Started<span class="hidden-print"> (</span><a style="text-decoration:none;" href="#table_of_contents" class="hidden-print">Top</a><span class="hidden-print">)</span></h1>
<p>On desktop browsers, when the tool is run, you should be seeing a side-by-side view with the ABC editor on the left and the notation on the right:</p>
<br/>
<div class="image_holder">
<img class="image" loading="lazy" style="width:700px;" src="img/overview_11.jpg"/>
</div>
<p><strong>On a desktop browser, if you are seeing a single column view with the ABC editor at the top and the notation below, or the welcome dialog is taller than the screen, try zooming your browser view out using the following keystrokes:</strong></p>
<p><strong>Windows: Ctrl -</strong></p>
<p><strong>Mac: ⌘ -</strong></p>
<hr>
<p>Note: On iOS and Android devices, by default, the tool runs in a portrait-mode single-column layout with the ABC editor on the top and the notation below.</p>
<p>iPad users can opt-in for the side-by-side view from the <a href="#settings_dialog">Settings</a> dialog.</p>
<hr>
<p>Click the <strong>?</strong> at the top-left of the window or any dialog to open the related User Guide topic in a new browser tab.</p>
<hr>
<p>When notation is present, you can:</p>
<p>- Click the Zoom arrows at the top-right of the window to view the notation full screen.</p>
<p>- Click the Play icon button at the bottom-right of the window to play the currently selected tune. </p>
<p>- Click the PDF icon button at the bottom-left of the window to export a PDF of the tunebook. </p>
<p>The Play and PDF icon buttons are always available in the notation full screen view mode on both desktop and mobile browsers.</p>
<p>They are both available in ABC edit mode on desktop browsers but not mobile device browsers to avoid interfering with the notation display on narrow screens.</p>
<hr>
<p>Most features in the tool have tool tips you can view by hovering your mouse cursor over the button or other control.</p>
<hr class="hidden-print" id="abc_editor">
<h1 class="page_break_always">ABC Editor<span class="hidden-print"> (</span><a style="text-decoration:none;" href="#table_of_contents" class="hidden-print">Top</a><span class="hidden-print">)</span></h1>
<div class="image_holder">
<img class="image" loading="lazy" style="width:700px;" src="img/ug2.jpg"/>
</div>
<p>Type or paste your ABC notation here.</p>
<p>Changes are reflected immediately in the displayed notation below the ABC Editor.</p>
<p>You may also paste some ABC text into the ABC Editor or just start typing.</p>
<p>Click on any tune in the ABC to have the notation scroll into view. </p>
<p>Click in the notation for any tune and the ABC area will be autoscrolled so that the ABC for the tune is displayed (or within a few lines, browser dependent).</p>
<p><strong>Note:</strong> The tune autoscroll features are <strong>not</strong> available on iOS or Android devices.</p>
<hr class="hidden-print" id="abc_editor_resize">
<h1 class="page_break_always">Resizing the ABC Editor<span class="hidden-print"> (</span><a style="text-decoration:none;" href="#table_of_contents" class="hidden-print">Top</a><span class="hidden-print">)</span></h1>
<p>On desktop browsers, the ABC text area can be resized by dragging the lower right corner.</p>
<p>When you resize the text area while in the "side-by-side" display mode, the notation will slide over to the right as much as it can:</p>
<div class="image_holder_p">
<img class="image" loading="lazy" src="img/dynamic_resize_3.jpg"/>
</div>
<p class="hidden-print" style="margin-top:24px;margin-bottom:24px;text-align:center"><iframe width="620" height="338" loading="lazy" src="https://www.youtube.com/embed/zwdsEXrKIp0" title="Dynamic resize demo" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture;" allowfullscreen></iframe></p> <hr class="hidden-print" id="top_bar_buttons">
<h1 class="page_break_always">Top Bar Buttons<span class="hidden-print"> (</span><a style="text-decoration:none;" href="#table_of_contents" class="hidden-print">Top</a><span class="hidden-print">)</span></h1>
<div class="image_holder">
<img class="image" loading="lazy" style="width:700px;" src="img/topbar_4.jpg"/>
</div>
<hr>
<p><strong>Open:</strong></p>
<p>Opens an ABC, MusicXML, BWW, or MIDI file.</p>
<p>Details below in the <a href="#open_dialog">Open an ABC, MusicXML, BWW, or MIDI File</a> section.</p>
<hr>
<p><strong>Add:</strong></p>
<p>Brings up a dialog where you can add your own ABC, MusicXML, BWW, or MIDI tunes, restore from previously saved Snapshots, re-order the tunes, add example ABC tunes, add useful ABC templates, or inject PDF tunebook feature commands.</p>
<p>Details below in the <a href="#add_templates_dialog">Adding Your Own Tunes to Your Tunebook</a> section.</p>
<hr>
<p><strong>Save:</strong></p>
<p>Saves the contents of the ABC editor to a .abc file.</p>
<p>If you specify .xml as the file extension, the first ABC tune in the editor will be saved out as a MusicXML file with the entered filename.</p>
<hr>
<p><strong>Export PDF:</strong></p>
<p>Exports the currently displayed score as a high quality PDF file.</p>
<p>The saved ABC or PDF file will be in your browser's Downloads directory.</p>
<p>On iOS the downloaded files will be found in the "Downloads" directory in the iOS "Files" app.</p>
<p>On desktop browsers, you can also click the PDF icon at bottom-left of the window.</p>
<hr>
<p><strong>Copy All:</strong></p>
<p>Copies all the ABC text to the system clipboard so you can easily paste it into social media posts, emails, or other tools.</p>
<hr>
<p><strong>Play:</strong></p>
<p>Opens the ABC Player where you can play the current tune. Full details below in the <a style="text-decoration:none;" href="#playing_your_tunes">Playing Your Tunes</a> section.</p>
<p>On desktop browsers can also click the Play icon at the bottom-right of the window.</p>
<p>Holding down the Shift key on your keyboard while clicking the toolbar play button will open the current tune in the Tune Trainer.</p>
<p>If multiple tunes are in the ABC editor, holding down the Alt key on your keyboard while clicking the toolbar play button will play a random tune from the tunes available.</p>
<hr>
<p><strong>Highlighting On/Off:</strong></p>
<p>Toggles Notation/ABC automatic highlighting On/Off.</p>
<p>Full details below in the <a href="#highlighting">Notation and ABC Highlighting</a> section.</p>
<hr id="moretoolsdropdown">
<p><strong>☰</strong></p>
<p>Brings up a menu of useful commands:</p>
<div class="image_holder_p">
<img class="image" loading="lazy" src="img/moretools_14.jpg"/>
</div>
<p><strong>Find and Replace</strong> (Desktop browsers only)</p>
<p>Brings up a dialog where you can search and replace text in the ABC editor.</p>
<p>Also available by pressing ⌘+F on Mac or Ctrl+F on Windows/Linux when working in the ABC editor.</p>
<p><strong>Toggle Top/Bottom Toolbars</strong></p>
<p>Hides/shows the header at the top and any visible controls below the ABC text area so you can have more room to work on your music.</p>
<p><strong>Maximize Editor</strong></p>
<p>Maximizes the width of the ABC text editing area.</p>
<p><strong>Reorder Tunes</strong></p>
<p>Brigns up a dialog where you can change the order of the tunes.</p>
<p><strong>Delete Tunes</strong></p>
<p>Brigns up a dialog where you can selectively delete tunes.</p>
<p><strong>Align Bars (One Tune)</strong></p>
<p>Aligns the measures in the ABC text for the current tune you are working on.</p>
<p>Also available by pressing ⌘+/ on Mac or Ctrl+/ on Windows/Linux when working in the ABC editor.</p>
<p><strong>Align Bars (All Tunes)</strong></p>
<p>Aligns the measures in the ABC text for all the tunes in the tunebook.</p>
<p><strong>Split Long Tags and Text</strong></p>
<p>abcjs doesn't wrap long text lines in descriptive tags or text annotations:</p>
<p>%%text, %%center, or %%begintext / %%endtext blocks.</p>
<p>This feature allows you to split any long text in the ABC at a specific length in your tags, text, or both so that they display properly.</p>
<p>You may select which tags you want to split.</p>
<p>You may choose to split either the current tune being worked on or all tunes in the ABC editor.</p>
<p>The splitter attempts to split the text at a word boundary.</p>
<p id="reformatusingxml"><strong>Reformat Using MusicXML</strong></p>
<p>Round-trips either the current tune or all the tunes in the ABC through MusicXML export and import back to ABC.</p>
<p>This can be useful for cleaning up some ABC files that have odd formatting or use & measure note overlays which sometimes cause rendering and playback issues:</p>
<p class="hidden-print" style="margin-top:24px;margin-bottom:24px;text-align:center"><iframe width="620" height="338" loading="lazy" src="https://www.youtube.com/embed/YwpecZmHvMs" title="Reformat Using MusicXML" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture;" allowfullscreen></iframe></p>
<p>It can also be used to quickly reformat the number of bars-per-staff on an existing ABC tune:</p>
<p class="hidden-print" style="margin-top:24px;margin-bottom:24px;text-align:center"><iframe width="620" height="338" loading="lazy" src="https://www.youtube.com/embed/m9ynCua8zWA" title="Reformat Using MusicXML to Change Bars-per-Staff" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture;" allowfullscreen></iframe></p>
<p>MusicXML import formatting is done using the values set in <a style="text-decoration:none;" href="#musicxml">MusicXML/MIDI Import Settings</a>.</p>
<p>When reformatting large ABC collections, since MusicXML-based reformatting doesn't require rendering the tunes, I suggest using the "Quick Editor" which only renders the first tune in the collection.</p>
<p>This can be particularly helpful if the initial rendering of the collection is slow in the standard editor because of "one measure per ABC line" formatting of the ABC.</p>
<p>From the "Quick Editor" you can then run "Reformat Using MusicXML", save the resulting ABC, then open the reformatted ABC in the standard editor.</p>
<p><strong>Settings</strong></p>
<p>Brings up the default playback instruments and other tool-wide settings dialog.</p>
<p>Full details below in the <a href="#settings_dialog">ABC Transcription Tools Settings</a> section.</p>
<p><strong>Advanced Settings</strong></p>
<p>Brings up a dialog where you can configure low level tool features and settings.</p>
<p>Full details below in the <a href="#advanced_settings">ABC Transcription Tools Advanced Settings</a> section.</p>
<p><strong>Launch Quick Editor</strong></p>
<p>Launches the Quick Editor in a new tab.</p>
<hr id="new_version_check">
<p>In general, the tool will normally update itself if required when launched.</p>
<p>Occasionally, particularly on mobile devices, that auto-update process might not happen immediately.</p>
<p>If an update for the tool is available online, the following items will appear at the bottom of the menu:</p>
<p><strong>A new version is available!</strong></p>
<p><strong>Click here to update the tool</strong></p>
<p>If you click either item, after confirmation, the version of the tool stored in your browser will be updated and the tool restarted.</p>
<p>After the tool is updated and restarted, you may need to refresh the tab one more time to see the updated version.</p>
<p class="page_break_always"></p>
<hr class="hidden-print" id="open_dialog">
<h1 class="page_break_always">Open an ABC, MusicXML, BWW, or MIDI File<span class="hidden-print"> (</span><a style="text-decoration:none;" href="#table_of_contents" class="hidden-print">Top</a><span class="hidden-print">)</span></h1>
<p><strong>Open:</strong></p>
<p>The tool supports reading ABC, MusicXML, BWW, and MIDI files.</p>
<p>The file of type being opened depends on the file extension:</p>
<p><strong>.abc or .txt</strong></p>
<p>Opens an ABC file from your computer and loads it into the ABC Editor.</p>
<p><strong>.xml, .musicxml, or .mxl</strong></p>
<p>Imports a MusicXML file from your computer, converts it to ABC, and loads it into the ABC Editor.</p>
<p>If there is a title tag present in the MusicXML, it will be used for the tune title, otherwise one will be created from the filename.</p>
<p><strong>.bww</strong></p>
<p>Imports a Bagpipes Reader/Player .bww file from your computer, converts it to ABC, and loads it into the ABC Editor.</p>
<p>Pitch is shifted to A=480 Hz using the following directive:</p>
<p class="code">%voice_tuning_cents 48 148</p>
<p>For more information on the %voice_tuning_cents directive, see the <a href="#voice_tuning">Setting the Tuning Offset for Individual Voices</a> section below.</p>
<p>To inject drone and chanter sounds into a tune imported from a BWW file, check out the <a href="#advanced_injectbagpipesounds">Inject Bagpipe Sounds</a> command on the <strong>More Tools</strong> dialog.</p>
<p><strong>.mid, or .midi</strong></p>
<p>Imports a MIDI file from your computer, converts it first to MusicXML, converts the MusicXML to ABC, and loads it into the ABC Editor.</p>
<p>Details on MusicXML and MIDI import settings below in the <a style="text-decoration:none;" href="#musicxml">MusicXML/MIDI Import Settings</a> section.</p>
<p>On desktop browsers, you may also drag-and-drop a single ABC, MusicXML, BWW, or MIDI file on the editor area to add it.</p>
<p>If you have unsaved work, you will be asked to confirm that you want to abandon your work in progress and load a new ABC file.</p>
<hr class="hidden-print" id="add_templates_dialog">
<h1 class="page_break_always h1wide">Adding Your Own Tunes to Your Tunebook<span class="hidden-print"> (</span><a style="text-decoration:none;" href="#table_of_contents" class="hidden-print">Top</a><span class="hidden-print">)</span></h1>
<p><strong>Add:</strong></p>
<p>Brings up a dialog where you can add your own ABC, MusicXML, BWW, or MIDI tunes, restore from previously saved Snapshots, re-order the tunes, delete tunes, add example ABC tunes, add useful ABC templates, or inject the commands for PDF tunebook features:</p>
<div class="image_holder_p">
<img class="image" loading="lazy" src="img/add_example_template_23.jpg"/>
</div>
<p>If you would like to only show the buttons for the features you commonly use and hid the others, click the controls icon at the top-right of the dialog to choose features of the dialog you would like to show/hide:</p>
<div class="image_holder_p">
<img class="image" loading="lazy" src="img/add_abc_features_options_1.jpg"/>
</div>
<p>The most commonly used buttons are always shown.</p>
<p>Your preferences are saved and restored the next time you use the tool.</p>
<hr>
<p><strong>Choose File to Add:</strong></p>
<p>Browse your system for an ABC, MusicXML, BWW, or MIDI file with one or more tunes to add to the end of the current tunes.</p>
<hr>
<p><strong>Restore from Snapshot:</strong></p>
<p>This button appears if there is a saved Snapshot available in browser storage.</p>
<p>When clicked, restores a saved Snapshot from browser storage, replacing the contents of the ABC editor.</p>
<p>There are four Snapshots available in browser storage.</p>
<p>Hold down the following modifier keys while clicking the button to select which Snapshot to restore:</p>
<p>Click - Snapshot #1</p>
<p>Shift-Click - Snapshot #2</p>
<p>Alt-Click - Snapshot #3</p>
<p>Shift-Alt-Click - Snapshot #4</p>
<p>If you click the button and no Snapshot is available for the selected slot based on the modifier keys held down, the next highest available Snapshot will be used.</p>
<p>Since it completely replaces the contents of the ABC editor, you will be asked to confirm the operation.</p>
<hr>
<p><strong>Restore from Auto-Snapshot:</strong> (Desktop browsers only) </p>
<p>This button appears if there is a saved Auto-Snapshot available in browser storage.</p>
<p>When clicked, restores the last Auto-Snapshot, replacing the contents of the ABC editor.</p>
<p>Since it completely replaces the contents of the ABC editor, you will be asked to confirm the operation.</p>
<p>On desktop browsers, automatic Snapshots when closing or reloading the browser tab the tool is running in can be enabled in the tool's <strong>Settings</strong> dialog. </p>
<hr class="hidden-print" id="search_and_add_tunes">
<h1 class="page_break_always">Search and Add Tunes<span class="hidden-print"> (</span><a style="text-decoration:none;" href="#table_of_contents" class="hidden-print">Top</a><span class="hidden-print">)</span></h1>
<p>Brings up a dialog where you search either Gavin Heneghan's tune collection (over 20,000 tune settings) or the FolkFriend.app tune collection (over 45,000 tune settings) by tune name and style and then optionally add them to your tunebook:</p>
<div class="image_holder_p">
<img class="image" loading="lazy" src="img/tune_search_8.jpg"/>
</div>
<p class="hidden-print" style="margin-top:24px;margin-bottom:24px;text-align:center"><iframe width="620" height="338" loading="lazy" src="https://www.youtube.com/embed/9HgEBIPXHCU" title="Tune search overview" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture;" allowfullscreen></iframe></p>
<p>When first entering this dialog or changing the search collection, the tool will need to load the tune collection.</p>
<p>The status will read "Ready to search" when the tune collection has been loaded.</p>
<p>Once loaded the tune collection is stored for future use and will load much quicker.</p>
<p>Enter some text to search for in the title of the tunes and click <strong>Search</strong> or press the Enter key.</p>
<p>By default, the search will return only the first variation of a tune found.</p>
<p>If you want all the variations for a tune, uncheck <strong>Only return first variation found?</strong></p>
<p>If you want to match the search text only at the start of the tune name, check <strong>Match start of title?</strong></p>
<p>If you want to only match tunes that also have chords, check <strong>Only return tunes with chords?</strong></p>
<p>Select the tune style you want from the <strong>Tune style</strong> dropdown.</p>
<p>If you want to filter the results by key/mode, select the key/mode from the <strong>Key</strong> dropdown.</p>
<p>Select the maximum number of search results you want from the <strong>Maximum number of results</strong> dropdown.</p>
<p>Click <strong>Add Results to Tunebook</strong> to append the search results tunes at the end of the ABC editor.</p>
<p>If you don't want all the tunes in the search results added to your tunebook, you can simply copy and paste the results you want back into the ABC editor.</p>
<p>You can also get to this dialog by clicking the <strong>Search for Tunes</strong> link at the top of the tool.</p>
<hr class="hidden-print" id="change_tune_order">
<h1 class="page_break_always h1wide">Change the Order of the Tunes<span class="hidden-print"> (</span><a style="text-decoration:none;" href="#table_of_contents" class="hidden-print">Top</a><span class="hidden-print">)</span></h1>
<p>On desktop browsers, brings up a dialog where you can drag and drop the tune names to change their order in the tunebook:</p>
<div class="image_holder_p">
<img class="image" loading="lazy" src="img/change_order_2.jpg"/>
</div>
<p class="hidden-print" style="margin-top:24px;margin-bottom:24px;text-align:center"><iframe width="620" height="338" loading="lazy" src="https://www.youtube.com/embed/UbDZ7SGvKX0" title="Changing the order of the tunes" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture;" allowfullscreen></iframe></p>
<p>On mobile browsers, select a tune name and then use the <strong>Move Up</strong> and <strong>Move Down</strong> buttons to change the order of the tune in the tunebook.</p>
<div class="image_holder_p">
<img class="image" loading="lazy" src="img/change_order_mobile_1.jpg"/>
</div>
<hr class="hidden-print" id="delete_selected_tunes">
<h1 class="page_break_always h1wide">Delete Tunes from the Tunebook<span class="hidden-print"> (</span><a style="text-decoration:none;" href="#table_of_contents" class="hidden-print">Top</a><span class="hidden-print">)</span></h1>
<p>Brings up a dialog where you can select tunes to delete from the tunebook:</p>
<div class="image_holder_p">
<img class="image" loading="lazy" src="img/delete_selected_tunes_1.jpg"/>
</div>
<p class="hidden-print" style="margin-top:24px;margin-bottom:24px;text-align:center"><iframe width="620" height="338" loading="lazy" src="https://www.youtube.com/embed/CQarxTw-fKU" title="Deleting tunes from the tunebook" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture;" allowfullscreen></iframe></p>
<p>Click on the tune names to select/deselect them.</p>
<p>Click <strong>Select All</strong> to select all the tunes for deletion.</p>
<p>Click <strong>Clear Selection</strong> to unselect all the tunes for deletion.</p>
<p>Click <strong>Delete</strong> to delete the tunes after confirmation.</p>
<hr class="hidden-print" id="add_examples">
<h1 class="page_break_always h1wide">Adding Example Tunes and Templates to Your Tunebook<span class="hidden-print"> (</span><a style="text-decoration:none;" href="#table_of_contents" class="hidden-print">Top</a><span class="hidden-print">)</span></h1>
<p><strong>Add an Example Reel:</strong></p>
<p>Adds "Cooley's" as an example of a typical reel.</p>
<hr>
<p><strong>Add an Example Reel:</strong></p>
<p>Adds "Cooley's" as an example of a typical reel.</p>
<hr>
<p><strong>Add an Example Jig:</strong></p>
<p>Adds "The Kesh" as an example of a typical jig.</p>
<hr>
<p><strong>Add an Example Hornpipe:</strong></p>
<p>Adds "Alexander's" as an example of a typical hornpipe.</p>
<hr>
<p><strong>Add J.S. Bach Two-Part Invention #1:</strong></p>
<p>Adds the J.S. Bach Two-Part Invention #1 for Harpsichord.</p>
<p>This piece was originally imported from a MusicXML transcription.</p>
<hr>
<p><strong>Add J.S. Bach BWV570 Fantasia:</strong></p>
<p>Adds the J.S. Bach BWV570 Fantasia in four parts for Pipe Organ.</p>
<p>This piece was originally imported from a MusicXML transcription.</p>
<hr>
<p><strong>Add a Tune Template:</strong></p>
<p>Adds a minimal ABC template for a tune.</p>
<hr>
<p><strong>Add a Song Template:</strong></p>
<p>Adds a minimal self-documenting ABC template for a song with lyrics.</p>
<hr>
<p><strong>Add an Example Song:</strong></p>
<p>Adds a detailed self-documenting example of ABC for a song with lyrics.</p>
<hr>
<p><strong>Add Bodhran Backing Track Tune Template:</strong></p>
<p class="hidden-print" style="margin-top:24px;margin-bottom:24px;text-align:center"><iframe width="620" height="338" loading="lazy" src="https://www.youtube.com/embed/VpfQH4CiW1A" title="Bodhran backing track template demo" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture;" allowfullscreen></iframe></p>
<p class="hidden-print" style="margin-top:24px;margin-bottom:24px;text-align:center"><iframe width="620" height="338" loading="lazy" src="https://www.youtube.com/embed/Lz2_wMc_gZY" title="All bodhran backing track templates" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture;" allowfullscreen></iframe></p>
<p class="hidden-print" style="margin-top:24px;margin-bottom:24px;text-align:center"><iframe width="620" height="338" loading="lazy" src="https://www.youtube.com/embed/dtrc0CbwaDs" title="Setting the Bodhran pitch" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture;" allowfullscreen></iframe></p>
<p>Brings up a dialog where you can add a bodhran backing track for various tune styles to the end of the ABC.</p>
<p>These are two-voice templates.</p>
<p>Voice 1 is the melody. Replace the rests in the template with your tune.</p>
<p>Voice 2 is the Bodhran backing track. Use the existing template or edit to meet your needs.</p>
<p>You can change the tuning of the Bodhran by changing the value A in the template line:</p>
<p class=code>%bodhran_tuning A</p>
<p>to the pitch you'd prefer.</p>
<p>Valid values are: C, C#, Db, D, D#, Eb, E, F, F#, Gb, G, G#, Ab, A, A#, Bb, or B.</p>
<p>If no pitch is specified, the default is A.</p>
<p>Full details on the Bodhran ABC note-to-sound mapping are available in the following section:</p>
<p style="text-align: center;"><a href="#bodhran_map"><strong>Using the Bodhran (%%MIDI program 117) Instrument</strong></a></p>
<hr>
<p><strong>Add Offline Notes Database Loader Templates:</strong></p>
<p>Adds two ABC templates to assist with loading notes into the offline instrument notes and reverb settings database:</p>
<p><strong>Single Soundfont Instrument Notes + Reverb Setting Database Loader</strong></p>
<p>ABC template with all notes for a specific soundfont and MIDI instrument as well as reverb setting to make it easy to load all the notes for a single instrument plus a single reverb setting into the instrument notes and reverb settings database for offline use.</p>
<p>After setting your desired MIDI instrument and reverb setting in the template, click <strong>Play</strong> to load the notes and reverb setting into the database.</p>
<p>You do not need to actually play the ABC, simply opening the template in the player will fetch the instrument notes and reverb setting and save them in the database.</p>
<p><strong>All Soundfont Instruments Notes Database Primer Loader</strong></p>
<p>ABC template soundfont MIDI instrument notes database primer loader that includes a single note assigned to each of the 128 MIDI instruments in a soundfont (plus my custom instruments 129-144).</p>
<p>After setting your desired soundfont in the template, click <strong>Play</strong> to load the single notes of each instrument into the database.</p>
<p>You do not need to actually play the ABC, simply opening the template in the player will fetch the instrument notes save them in the database.</p>
<p>Once the single notes for each soundfont instrument are in the database, use the <strong>Load All Notes for All Instruments</strong> feature on the <strong>Manage Notes, Reverb, and Tune Search Databases</strong> / <strong>Instrument Notes Database</strong> dialog to load all the rest of the notes for all the instruments in the soundfont into the database for use offline.</p>
<hr>
<p>For more details, see the <strong><a href="#manage_databases">Managing Notes, Reverb, and Tune Search Databases for Offline Use</a></strong> section below.</p>
<hr>
<p><strong>Inject PDF Tunebook Features:</strong></p>
<p>Brings up a dialog that you can use to inject commands at the top of the ABC that will add an optional Title Page, Table of Contents, Index, Page Header, Page Footer, playback links, and/or QR code to an exported PDF tunebook.</p>
<p>Full details on PDF tunebook features can be found in the <a href="#inject_pdf_tunebook_features"><strong>Inject PDF Tunebook Features</strong></a> section of <a href="#export_pdf_tunebook"><strong>Exporting a PDF Tunebook</strong></a>.</p>
<hr class="hidden-print" id="highlighting">
<h1 class="page_break_always">Notation and ABC Highlighting<span class="hidden-print"> (</span><a style="text-decoration:none;" href="#table_of_contents" class="hidden-print">Top</a><span class="hidden-print">)</span></h1>
<p>Notation and ABC Highlighting can be toggled On/Off by clicking the <strong>Highlighting On/Off</strong> button in the top toolbar.</p>
<div class="image_holder_p">
<img class="image" loading="lazy" style="width:700px;" src="img/highlighting_2.jpg"/>
</div>
<p>When Highlighting is turned on:</p>
<p>- Select ABC text to highlight the corresponding notes in red in the notation.</p>
<p>- Click any element in the notation to select the corresponding ABC text in the editor.</p>
<p>- Highlighting requires redrawing all tunes on each change to the ABC.</p>
<p>- This may be slow on large numbers of tunes.</p>
<p>- All pre-processing of the ABC at notation drawing time is turned off. Any hiding of Annotations/Text/Chords selected in the More ABC Tools dialog as well as automatic injection of staff separation space will be disabled. Your settings will be restored when you turn highlighting off.</p>
<p>This feature is only available for desktop browsers.</p>
<p class="hidden-print" style="margin-top:24px;margin-bottom:24px;text-align:center"><iframe width="620" height="338" loading="lazy" src="https://www.youtube.com/embed/3YsY-ReSt2k" title="Highlighting demo" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture;" allowfullscreen></iframe></p>
<hr class="hidden-print" id="viewing_the_notation_full_screen">
<h1 class="page_break_always">Viewing the Notation Full Screen<span class="hidden-print"> (</span><a style="text-decoration:none;" href="#table_of_contents" class="hidden-print">Top</a><span class="hidden-print">)</span></h1>
<div class="image_holder">
<img class="image" loading="lazy" src="img/ug3.jpg"/>
</div>
<p>If any ABC is present in the ABC Editor, this double-arrow control shows up on the top-right corner of the page.</p>
<p>The control hides or shows the ABC Editor and all controls so you can view your notation full screen.</p>
<p>Click once to hide the ABC Editor and all controls.</p>
<p>Click again to show the ABC Editor and all controls.</p>
<p>Click the <strong>?</strong> at the top-left of the window for help using the tool in the full screen view.</p>
<p>Click the PDF icon at the bottom-left of the window to export the tunes in PDF format.</p>
<p>Click the Play icon at the bottom-right of the window to play the current tune.</p>
<p>The size of the full screen notation as a percentage of the browser window width is set in the <strong>Advanced Settings</strong> dialog. Default is: 50%.</p>
<p class="hidden-print" style="margin-top:24px;margin-bottom:24px;text-align:center"><iframe width="620" height="338" loading="lazy" src="https://www.youtube.com/embed/KagT-Aq8mY8" title="Full-Screen Tune Display Options" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture;" allowfullscreen></iframe></p>
<p>If the resulting scaled width is less than 850 pixels (820 pixels for iOS/Android) the width will be set to 850 pixels (820 pixels for iOS/Android).</p>
<hr class="hidden-print" id="basic_controls">
<h1 class="page_break_always">Basic Controls and Features<span class="hidden-print"> (</span><a style="text-decoration:none;" href="#table_of_contents" class="hidden-print">Top</a><span class="hidden-print">)</span></h1>
<p id="basic_tablature" style="margin-top:24px;">The instrument tablature button bar controls how the notation and tablature is displayed:</p>
<div class="image_holder">
<img class="image" loading="lazy" style="width:700px;margin-top:24px;" src="img/tab_options_2.jpg"/>
</div>
<p>The instrument tablature button bar is shown by default, but can be hidden if desired.</p>
<p>See the <a href="#settings_dialog">ABC Transcription Tools Settings</a> section for details.</p>
<hr>
<p><strong>Notation</strong> - Standard notation only.</p>
<hr>
<p><strong>Names</strong> - Shows standard notation with note names below.</p>
<p>Choose between standard ABC d e f style octave notes or Comhaltas-preferred "Blackboard ABC" D' E' F' octave note display in the <strong>Settings</strong> dialog.</p>
<p><strong>Important:</strong> While the note Names display will show the Comhaltas-preferred note names, the ABC standard requires that the second octave C in the ABC itself either be represented by c or C' so that may requires some minor changes when pasting in your Comhaltas-formatted tunes.</p>
<p>Note names font and size in the tab is set by the <strong>Tab number font</strong> value in the <strong>Configure ABC Rendering Fonts</strong> dialog.</p>
<hr>
<p><strong>Mandolin</strong> - Shows standard notation and tablature for Mandolin.</p>
<hr>
<p><strong>GDAD</strong> - Shows standard notation and tablature for GDAD-tuned Irish Bouzouki.</p>
<p>This can be changed to <strong>CGDA</strong> for CGDA-tuned Mandola or Mandocello in the tool's Settings dialog.</strong></p>
<hr>
<p><strong>CGDAE</strong> - Shows standard notation and tablature for 5-string CGDAE-tuned Fiddle.</p>
<p>This can be changed to <strong>DGDAE</strong> for 5-string DGDAE-tuned Bouzouki in the tool's Settings dialog.</p>
<hr>
<p><strong>Guitar</strong> - Shows standard notation and tablature for standard EADGBE-tuned Guitar.</p>
<hr>
<p><strong>DADGAD</strong> - Shows standard notation and tablature for DADGAD-tuned Guitar.</p>
<hr>
<p><strong>Uke</strong> - Shows standard notation and tablature for GCEA tuned Ukulele.</p>
<p>This tablature solution puts the majority of the notes on the CEA strings and only uses the G string for notes lower than C.</p>
<hr>
<p><strong>Whistle</strong> - Shows standard notation and fingering tablature for Tin Whistle in the key of D.</p>
<p>Note: For notes that go below D on of the whistle (lowest note supported is the G below middle-C), the suggested "folded" octave-up fingerings are shown.</p>
<hr>
<p>Up to 8 voices may be displayed with tablature.</p>
<hr>
<p style="text-align: center;"><strong>Showing/Hiding Stringed Instrument Tablature in Multi-Voice ABC Tunes</strong></p>
<p>The two following annotations only work for stringed instrument tablatures and not the note names or whistle tablature.</p>
<p>To show the tablature on the first voice of a multi-voice tune and hide it on all the others, add the following comment based annotation anywhere in the tune:</p>
<p class="code">%tab_first_voice_only</p>
<p>To hide the tablature on the first voice of a multi-voice tune and show it on all the others, add the following comment based annotation anywhere in the tune:</p>
<p class="code">%tab_first_voice_exclude</p>
<p>If both are present in a tune, %tab_first_voice_only takes precedence over %tab_first_voice_exclude.</p>
<p>If a tunebook contains multiple tunes, all of the tunes in the tunebook should all either contain or not contain these annotations.</p>
<p>Mixed use of these annotations across multiple tunes in a tunebook may not produce the desired result.</p>
<hr>
<p style="margin-top:24px;margin-bottom: 12px;"><strong>These buttons perform common operations on the ABC:</strong></p>
<div class="image_holder" style="margin-top:24px;">
<img class="image" loading="lazy" style="width:700px;" src="img/bottom_toolbar_1.jpg"/>
</div>
<hr>
<p id="basic_transpose"><strong>Transpose Down</strong> - Transposes the selected tunes down one semitone. Shift-click transposes down one full step. Alt-click transposes down one octave.</p>
<hr>
<p><strong>Transpose Up</strong> - Transposes the selected tunes up one semitone. Shift-click transposes up one full step. Alt-click transposes up one octave.</p>
<p>To transpose multiple tunes, just click anywhere in the first tune you want to transpose, and drag to select any part of additional tunes you want transposed.</p>
<p>To transpose all the tunes at once, select them all before clicking the Transpose buttons.</p>
<hr>
<p>To transpose tune(s) to a specific root key rather than in steps, see the section on <a href="#advanced_transposetokey">Transpose to Key</a> below.</p>
<hr>
<p id="basic_snapshot"><strong>Snapshot</strong> - Saves a Snapshot of the contents of the ABC editor to browser storage.</p>
<p class="hidden-print" style="margin-top:24px;margin-bottom:24px;text-align:center"><iframe width="620" height="338" loading="lazy" src="https://www.youtube.com/embed/doPwU-BgCAc " title="Snapshots" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture;" allowfullscreen></iframe></p>
<p>If you save a Snapshot and leave the tool, the next time you run the tool the Snapshot will be available to restore by either clicking the <strong>Restore</strong> button on the main toolbar or the <strong>Restore from Snapshot</strong> button in the <strong>Add</strong> dialog.</p>
<p>There are four Snapshots available in browser storage.</p>
<p>Hold down the following modifier keys while clicking the button to select which Snapshot to save into:</p>
<p>Click - Snapshot #1</p>
<p>Shift-Click - Snapshot #2</p>
<p>Alt-Click - Snapshot #3</p>
<p>Shift-Alt-Click - Snapshot #4</p>
<hr>
<p><strong>Restore</strong> - If one is available, replaces the current contents of the ABC editor with a saved Snapshot from browser storage.</p>
<p>There are four Snapshots available in browser storage.</p>
<p>Hold down the following modifier keys while clicking the button to select which Snapshot to restore:</p>
<p>Click - Snapshot #1</p>
<p>Shift-Click - Snapshot #2</p>
<p>Alt-Click - Snapshot #3</p>
<p>Shift-Alt-Click - Snapshot #4</p>
<p>Since this completely replaces the contents of the ABC editor, you will be asked to confirm the operation.</p>
<hr>
<p id="basic_more_tools"><strong>More Tools</strong> - Shows the <a style="text-decoration:none;" href="#more_tools">More ABC Tools</a> dialog with several additional ABC filtering and display controls.</p>
<hr>
<p id="basic_sharing"><strong>Sharing</strong> - Shows the <a style="text-decoration:none;" href="#sharing_controls">Sharing Controls</a> dialog with options for sharing your tunes via a share URL or QR code.</p>
<hr>
<p id="basic_clear"><strong>Clear</strong> - Clears the ABC Editor so you can start over.</p>
<p>If you don't want to be asked to confirm the deletion every time, there is a setting in the <a href="#advanced_settings">Advanced Settings</a> dialog where you can disable the confirmation.</p>
<hr class="hidden-print" id="playing_your_tunes">
<h1 class="page_break_always">Playing Your Tunes<span class="hidden-print"> (</span><a style="text-decoration:none;" href="#table_of_contents" class="hidden-print">Top</a><span class="hidden-print">)</span></h1>
<p>To play a specific tune, click anywhere in the ABC for the tune and then click <strong>Play</strong>.</p>
<p>Holding down the Shift key on your keyboard while clicking the toolbar play button will open the current tune in the Tune Trainer.</p>
<p>The tool will find the tune you've clicked on and bring it up in the ABC Player for playback.</p>
<p>If you have selected some notes in the tune, only the selected notes will be played.</p>
<div class="image_holder_p">
<img class="image" loading="lazy" src="img/player_12.jpg"/>
</div>
<p>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. </p>
<hr>
<p>If there is more than one tune in the tunebook, click <strong> ← </strong> or <strong> → </strong> to play the previous or next tune in the ABC tunebook.</p>
<p>Shift-click on <strong> ← </strong> to jump to the first tune, shift-click on <strong> → </strong> to jump to the last tune.</p>
<p>The text in the lower right corner shows you the tune number of the current tune in the tunebook and the total number of tunes.</p>
<p>You may also select a tune in the tunebook by title from the pop-up list and the player will switch to that tune.</p>
<p>In the <strong>Settings</strong> dialog there is an option to have the tunebook navigation controls on the left instead of the right.</p>
<hr>
<p>Click <strong>Start Tune Trainer</strong> to bring up the Tune Trainer.</p>
<p>Full details below in the <a style="text-decoration:none;" href="#tune_trainer">"Step-Up" Tempo Tune Trainer</a> section.</p>
<hr>
<p>Click <strong>Enable Metronome</strong> to switch to a version of the tune that has a metronome click sound when playing.</p>
<p>When playing a tune with the metronome enabled, click <strong>Disable Metronome</strong> to return to the original version.</p>
<p>If you save the tune to .WAV or .MP3 while the metronome is enabled, the resulting audio file will have the metronome sound.</p>
<p>While most common tune meters are supported by the metronome system, if the tune you are playing is in a meter that is not supported, you will be presented with a alert explaining the issue and will only be able to play the original version.</p>
<hr>
<p>If you would prefer larger Player controls, for example for use on mobile devices, open the <strong>Advanced Settings</strong> dialog and set the check on: <strong>Player uses large controls (easier to touch on mobile and tablet)</strong></p>
<hr>
<p>If a wider view of the notation is available for the current tune based on the aspect ratio of the staves, the <strong>Wide View</strong> button will appear. (Desktop browsers only)</p>
<p>Clicking this button toggles between wide and normal views of the Player. (Desktop browsers only)</p>
<hr>
<p>Click <strong>Export Audio or Image</strong> to bring up a dialog where you can export your tune in various audio, MIDI, and image formats.</p>
<p>Full details below in the <a style="text-decoration:none;" href="#export_audio_image">Exporting Tune Audio or Image Files from the Player</a> section.</p>
<hr>
<p>Click <strong>Settings</strong> to bring up a dialog where you can select your default abcjs soundfont, instruments, and instrument volumes.</p>
<p class="hidden-print" style="margin-top:24px;margin-bottom:24px;text-align:center"><iframe width="620" height="338" loading="lazy" src="https://www.youtube.com/embed/_f2_RAcrVhk" title="Player Instrument Settings" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture;" allowfullscreen></iframe></p>
<div class="image_holder_p">
<img class="image" loading="lazy" src="img/abc_transcription_tool_settings_fs_1.jpg"/>
</div>
<p>The default abcjs soundfont, MIDI instruments, and MIDI volumes are used when a tune doesn't already have those values present in the ABC.</p>