-
Notifications
You must be signed in to change notification settings - Fork 10
/
Copy pathmanual.html
2578 lines (2442 loc) · 438 KB
/
manual.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
<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>Hydrogen v1.1 Manual</title><link rel="stylesheet" type="text/css" href="res/docbook.css"><script src="res/docbook.js" type="text/javascript"></script><meta name="generator" content="DocBook XSL Stylesheets V1.79.1"><meta name="description" content="Hydrogen is a software synthesizer which can be used alone, emulating a drum machine based on patterns, or via an external MIDI keyboard/sequencer software. Hydrogen runs on Linux, Mac OS X and Windows."><meta name="viewport" content="width=device-width,initial-scale=1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div lang="en" class="book"><div class="titlepage"><div><div><h1 class="title"><a name="Hydrogen-manual"></a>Hydrogen v1.1 Manual</h1></div><div><h2 class="subtitle">2021-03-04</h2></div><div><div class="authorgroup"><div class="author"><h3 class="author"><span class="firstname">Antonio</span> <span class="surname">Piraino</span></h3></div><div class="author"><h3 class="author"><span class="firstname">Alessandro</span> <span class="surname">Cominu</span></h3></div><div class="author"><h3 class="author"><span class="firstname">Thijs</span> <span class="surname">Van Severen</span></h3></div><div class="author"><h3 class="author"><span class="firstname">Sebastian</span> <span class="surname">Moors</span></h3></div><div class="author"><h3 class="author"><span class="firstname">Colin</span> <span class="surname">Evans</span></h3></div><div class="author"><h3 class="author"><span class="firstname">Philipp</span> <span class="surname">Müller</span></h3></div></div></div><div><div class="abstract"><p class="title"><b>Abstract</b></p><p>Hydrogen is a software synthesizer which can be used alone,
emulating a drum machine based on patterns, or via an external <abbr class="abbrev">MIDI</abbr>
keyboard/sequencer software. Hydrogen runs on Linux, Mac OS X and Windows.</p></div></div></div><hr></div><div class="toc"><p><b>Table of Contents</b></p><dl class="toc"><dt><span class="part"><a href="#part.1">I. Introduction</a></span></dt><dd><dl><dt><span class="chapter"><a href="#chpt.download">1. Download</a></span></dt><dt><span class="chapter"><a href="#chpt.compilation">2. Build</a></span></dt><dt><span class="chapter"><a href="#chpt.keyboard_and_mouse">3. Keyboard and Mouse</a></span></dt></dl></dd><dt><span class="part"><a href="#part.using_hydrogen">II. Using Hydrogen</a></span></dt><dd><dl><dt><span class="chapter"><a href="#chpt.overview">4. Overview</a></span></dt><dd><dl><dt><span class="sect1"><a href="#chpt.overview.gui">4.1. Main User Interface</a></span></dt><dt><span class="sect1"><a href="#chpt.overview.drumkits">4.2. Drumkit Concept</a></span></dt><dt><span class="sect1"><a href="#chpt.overview.midi_mapping_and_virtual_keyboard">4.3. MIDI-mapping and Virtual Keyboard</a></span></dt><dt><span class="sect1"><a href="#chpt.overview.recording">4.4. Recording in Hydrogen</a></span></dt><dt><span class="sect1"><a href="#chpt.overview.session_management">4.5. Session Management</a></span></dt><dt><span class="sect1"><a href="#chpt.overview.cli">4.6. Command-line Options</a></span></dt></dl></dd><dt><span class="chapter"><a href="#chpt.preferences">5. Preferences</a></span></dt><dd><dl><dt><span class="sect1"><a href="#chpt.preferences.general_tab">5.1. General</a></span></dt><dt><span class="sect1"><a href="#chpt.preferences.audio_tab">5.2. Audio System</a></span></dt><dt><span class="sect1"><a href="#chpt.preferences.midi_tab">5.3. MIDI System</a></span></dt><dt><span class="sect1"><a href="#chpt.preferences.osc_tab">5.4. OSC</a></span></dt><dt><span class="sect1"><a href="#chpt.preferences.appearance_tab">5.5. Appearance</a></span></dt></dl></dd><dt><span class="chapter"><a href="#chpt.main_menu">6. Main Menu</a></span></dt><dd><dl><dt><span class="sect1"><a href="#sect.main_menu.projects">6.1. Project</a></span></dt><dt><span class="sect1"><a href="#sect.main_menu.undo">6.2. Undo</a></span></dt><dt><span class="sect1"><a href="#sect.main_menu.drumkits">6.3. Drumkits</a></span></dt><dt><span class="sect1"><a href="#sect.main_menu.instruments">6.4. Instruments</a></span></dt><dt><span class="sect1"><a href="#sect.main_menu.view">6.5. View</a></span></dt><dt><span class="sect1"><a href="#sect.main_menu.options">6.6. Options</a></span></dt><dt><span class="sect1"><a href="#sect.main_menu.debug">6.7. Debug</a></span></dt><dt><span class="sect1"><a href="#sect.main_menu.info">6.8. Info</a></span></dt></dl></dd><dt><span class="chapter"><a href="#chpt.main_toolbar">7. Main Toolbar</a></span></dt><dd><dl><dt><span class="sect1"><a href="#sect.main_toolbar.transport_control">7.1.
Transport Control
</a></span></dt><dt><span class="sect1"><a href="#sect.main_toolbar.tap_tempo_beat_counter">7.2. Tap Tempo and Beat Counter</a></span></dt><dt><span class="sect1"><a href="#sect.main_toolbar.bpm_control_and_metronome">7.3. BPM Control and Metronome</a></span></dt><dt><span class="sect1"><a href="#sect.main_toolbar.cpu_usage_midi_in">7.4. CPU Usage and MIDI in</a></span></dt><dt><span class="sect1"><a href="#sect.main_toolbar.jack_control">7.5. JACK Control</a></span></dt><dt><span class="sect1"><a href="#sect.main_toolbar.gui_state">7.6. GUI State</a></span></dt></dl></dd><dt><span class="chapter"><a href="#chpt.song_editor">8. Song Editor</a></span></dt><dd><dl><dt><span class="sect1"><a href="#chpt.song_editor.main_controls">8.1. Main Controls</a></span></dt><dt><span class="sect1"><a href="#chpt.song_editor.editor_modes">8.2. Song Editor modes</a></span></dt><dt><span class="sect1"><a href="#chpt.song_editor.sidebar">8.3. Sidebar</a></span></dt><dt><span class="sect1"><a href="#chpt.song_editor.timeline">8.4. Timeline</a></span></dt><dt><span class="sect1"><a href="#chpt.song_editor.tag">8.5. Tags</a></span></dt><dt><span class="sect1"><a href="#chpt.song_editor.playbackTrack">8.6. Playback Track</a></span></dt><dt><span class="sect1"><a href="#sect.song_editor.automation_path">8.7. Automation Path</a></span></dt></dl></dd><dt><span class="chapter"><a href="#chpt.pattern_editor">9. Pattern Editor</a></span></dt><dd><dl><dt><span class="sect1"><a href="#chpt.pattern_editor.general">9.1. General</a></span></dt><dt><span class="sect1"><a href="#chpt.pattern_editor.drumkit">9.2. Drum Pattern Editor</a></span></dt><dt><span class="sect1"><a href="#chpt.pattern_editor.note_properties">9.3. Note Properties Editor</a></span></dt><dt><span class="sect1"><a href="#chpt.pattern_editor.piano_mode">9.4. Piano Roll Editor</a></span></dt></dl></dd><dt><span class="chapter"><a href="#chpt.sound_library">10. Sound Library (Drumkit/Pattern/Song Manager)</a></span></dt><dd><dl><dt><span class="sect1"><a href="#chpt.sound_library.drumkits">10.1. Drumkits</a></span></dt><dt><span class="sect1"><a href="#sect.sl.songs">10.2. Songs</a></span></dt><dt><span class="sect1"><a href="#sect.sl.patterns">10.3. Patterns</a></span></dt></dl></dd><dt><span class="chapter"><a href="#chpt.instrument_editor">11. Instrument Editor</a></span></dt><dd><dl><dt><span class="sect1"><a href="#chpt.instrument_editor.general">11.1. General</a></span></dt><dt><span class="sect1"><a href="#chpt.instrument_editor.layers">11.2. Layers</a></span></dt></dl></dd><dt><span class="chapter"><a href="#chpt.sample_editor">12. Sample Editor</a></span></dt><dd><dl><dt><span class="sect1"><a href="#chpt.sample_editor.wave_display">12.1. Wave Display and Region Editing</a></span></dt><dt><span class="sect1"><a href="#chpt.sample_editor.pitch">12.2. Pitch Shifting</a></span></dt><dt><span class="sect1"><a href="#chpt.sample_editor.playback_and_envelope_editor">12.3. Playback and Envelope Editor</a></span></dt></dl></dd><dt><span class="chapter"><a href="#chpt.mixer">13. Mixer</a></span></dt><dd><dl><dt><span class="sect1"><a href="#chpt.mixer.channel_strips">13.1. Instrument Channel Strips</a></span></dt><dt><span class="sect1"><a href="#chpt.mixer.component_strips">13.2. Component Channel Strips</a></span></dt><dt><span class="sect1"><a href="#sect.fx_rack_LADSPA">13.3. FX Rack and LADSPA Plugins</a></span></dt><dt><span class="sect1"><a href="#chpt.mixer.master_fader_strip">13.4. Master Fader Strip</a></span></dt></dl></dd><dt><span class="chapter"><a href="#chpt.director">14. Director</a></span></dt><dt><span class="chapter"><a href="#chpt.playlist_editor">15. Playlist Editor</a></span></dt><dd><dl><dt><span class="sect1"><a href="#chpt.playlist_editor.main_window">15.1. Main Window</a></span></dt><dt><span class="sect1"><a href="#chpt.playlist_editor.menu">15.2. Menu</a></span></dt></dl></dd><dt><span class="chapter"><a href="#chpt.midi">16. MIDI API</a></span></dt><dd><dl><dt><span class="sect1"><a href="#chpt.midi.actions">16.1. MIDI Actions</a></span></dt><dt><span class="sect1"><a href="#chpt.midi.learnable">16.2. MIDI-learnable Widgets</a></span></dt></dl></dd><dt><span class="chapter"><a href="#chpt.osc">17. OSC API</a></span></dt><dd><dl><dt><span class="sect1"><a href="#chpt.osc.basics">17.1. Basics</a></span></dt><dt><span class="sect1"><a href="#chpt.osc.commands">17.2. Commands</a></span></dt></dl></dd></dl></dd><dt><span class="part"><a href="#part.demos">III. Examples</a></span></dt><dd><dl><dt><span class="chapter"><a href="#chpt.create_song">18. A New Song</a></span></dt><dd><dl><dt><span class="sect1"><a href="#sect.song_vs_pattern">18.1. Song Mode and Pattern Mode</a></span></dt><dt><span class="sect1"><a href="#sect.create_pattern">18.2. A New Pattern</a></span></dt><dt><span class="sect1"><a href="#sect.create_sequence">18.3. A New Sequence</a></span></dt><dt><span class="sect1"><a href="#sect.create_song.adjust_mixer">18.4. Adjust from the Mixer</a></span></dt></dl></dd><dt><span class="chapter"><a href="#chpt.examples.drumkit">19. Create a New Drumkit</a></span></dt><dd><dl><dt><span class="sect1"><a href="#chpt.examples.drumkit.new_kit">19.1. Creating a New Drumkit</a></span></dt><dt><span class="sect1"><a href="#chpt.examples.drumkit.new_instrument">19.2. Creating a New Instrument</a></span></dt><dt><span class="sect1"><a href="#chpt.instrument_editor.tips">19.3. Tips on Editing Instruments</a></span></dt></dl></dd></dl></dd><dt><span class="part"><a href="#appendix">IV. Appendix</a></span></dt><dd><dl><dt><span class="chapter"><a href="#chpt.file_types">20. Used File Types</a></span></dt><dt><span class="chapter"><a href="#chap.shortcuts">21. Shortcut Lists</a></span></dt><dt><span class="glossary"><a href="#glossary">Glossary</a></span></dt></dl></dd></dl></div><div class="list-of-figures"><p><b>List of Figures</b></p><dl><dt>4.1. <a href="#fig.UI_overview">The Main UI in Single Pane mode</a></dt><dt>4.2. <a href="#fig.tabbed_UI_overview">The Main UI in Tabbed mode</a></dt><dt>5.1. <a href="#fig.preferences.general_tab">The General Tab</a></dt><dt>5.2. <a href="#fig.preferences.audio_tab">The Audio System Tab</a></dt><dt>5.3. <a href="#fig.preferences.midi_tab">The MIDI System Tab</a></dt><dt>5.4. <a href="#fig.preferences.osc_tab">The OSC Tab</a></dt><dt>5.5. <a href="#fig.preferences.appearance_tab">The Appearance Tab</a></dt><dt>6.1. <a href="#fig.main_menu">The Main Menu</a></dt><dt>6.2. <a href="#fig.import_drumkit">Import Drumkit</a></dt><dt>6.3. <a href="#fig.preferences.audio_engine_tab">The Audio Engine View</a></dt><dt>7.1. <a href="#fig.main_toolbar">The Main Toolbar</a></dt><dt>8.1. <a href="#fig.song_editor">The Song Editor</a></dt><dt>8.2. <a href="#fig.song_editor.virtualPattern.selectedMenu">The Pattern Options menu</a></dt><dt>8.3. <a href="#fig.pattern_properties">The Dialog to Change the Pattern Properties</a></dt><dt>8.4. <a href="#fig.add_tag">Dialog Window for Adding Tags</a></dt><dt>8.5. <a href="#fig.automation_path">The Automation Path Widget</a></dt><dt>9.1. <a href="#fig.PatternEditor_DrumMode">Pattern Editor in Drum Mode</a></dt><dt>9.2. <a href="#fig.PatternEditorControls">Pattern Editor Controls</a></dt><dt>9.3. <a href="#fig.pattern_editor.sidebar">The Sidebar of the Pattern Editor</a></dt><dt>9.4. <a href="#fig.PatternEditor_drumkit">Pattern Editor in Drum Mode</a></dt><dt>9.5. <a href="#fig.note_properties_ruler">The Note Properties Ruler set to Velocity</a></dt><dt>9.6. <a href="#fig.NoteKey">The Note Properties Ruler showing the NoteKey Property</a></dt><dt>9.7. <a href="#fig.PatternEditor_PianoMode">Pattern Editor in Piano Mode</a></dt><dt>10.1. <a href="#fig.soundlibrary">The Soundlibrary</a></dt><dt>11.1. <a href="#instrumenteditor.general">The Instrument editor General view</a></dt><dt>11.2. <a href="#instrumenteditor.layers">The Instrument Editor Layers View</a></dt><dt>11.3. <a href="#fig.instrument_editor.layers.layers">The Layer Section of the Instrument Editor</a></dt><dt>12.1. <a href="#sample.editor">The Sample Editor</a></dt><dt>12.2. <a href="#fig.sample_editor.wave_display">The Wave Display Section of the Sample Editor</a></dt><dt>12.3. <a href="#fig.sample_editor.pitch_shift">The Pitch Shifting Section of the Playlist Editor</a></dt><dt>12.4. <a href="#fig.sample_editor.envelope">The Envelope Section of the Sample Editor</a></dt><dt>13.1. <a href="#fig.mixer">The Mixer</a></dt><dt>13.2. <a href="#fig.mixer.channel_strip">The Instrument Channel Strip in the Mixer</a></dt><dt>13.3. <a href="#fig.mixer.component_strip">The Component Channel Strip in the Mixer</a></dt><dt>13.4. <a href="#fig.mixer.fx_strip">The FX Rack in the Mixer</a></dt><dt>13.5. <a href="#fig.select_effect">Select an Effect</a></dt><dt>13.6. <a href="#fig.mixer.master_strip">The Master Fader Strip in the Mixer</a></dt><dt>14.1. <a href="#fig.director">The Director</a></dt><dt>15.1. <a href="#fig.playlist_editor">The Playlist Editor with Demo Songs loaded</a></dt><dt>16.1. <a href="#midi_actions">MIDI Actions are set in MIDI System tab of the Preferences Dialog</a></dt><dt>18.1. <a href="#fig.pattern_editor.2">The Pattern Editor</a></dt><dt>18.2. <a href="#fig.insert_patterns">Inserting Patterns in the Song Sequence</a></dt><dt>18.3. <a href="#fig.mixer.2">The Mixer</a></dt><dt>44. <a href="#matryoshkaPanning">Visualization of the Interaction of the Different Pan Parameters</a></dt></dl></div><div class="list-of-tables"><p><b>List of Tables</b></p><dl><dt>4.1. <a href="#chpt.pattern_editor.midi_mapping"><abbr class="abbrev">MIDI</abbr> Mapping</a></dt><dt>17.1. <a href="#idm3932">All <abbr class="abbrev">OSC</abbr> Messages</a></dt><dt>21.1. <a href="#sect.shortcut.table">Shortcut Table</a></dt></dl></div><div class="part"><div class="titlepage"><div><div><h1 class="title"><a name="part.1"></a>Part I. Introduction</h1></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl class="toc"><dt><span class="chapter"><a href="#chpt.download">1. Download</a></span></dt><dt><span class="chapter"><a href="#chpt.compilation">2. Build</a></span></dt><dt><span class="chapter"><a href="#chpt.keyboard_and_mouse">3. Keyboard and Mouse</a></span></dt></dl></div><div class="chapter"><div class="titlepage"><div><div><h2 class="title"><a name="chpt.download"></a>Chapter 1. Download</h2></div></div></div><p>
You can download Hydrogen from
<a class="ulink" href="http://www.hydrogen-music.org" target="_top">http://www.hydrogen-music.org</a>.
On the <span class="emphasis"><em>Downloads</em></span> page you can find several binaries (installers) for MacOS and Windows.
</p><p>
Due to the variety of distributions we do not provide packages for Linux. If you do not find Hydrogen in the repository of your distribution, please ask the people behind it to include Hydrogen.
</p></div><div class="chapter"><div class="titlepage"><div><div><h2 class="title"><a name="chpt.compilation"></a>Chapter 2. Build</h2></div></div></div><p>
If you want to compile Hydrogen yourself, you can download the latest source files directly from our
<span class="command"><strong>git</strong></span> repository with
</p>
bla
blub
hermel
<pre class="screen">
<code class="prompt">$</code><span class="command"><strong> git clone git://github.com/hydrogen-music/hydrogen.git</strong></span>
</pre>
schni
<p>
A certain release can be fetched with
</p>
bla
blub
hermel
<pre class="screen">
<code class="prompt">$</code><span class="command"><strong> git checkout tags/1.0.0</strong></span>
</pre>
schni
<p>Compiling Hydrogen depends on the following libraries (among others):</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: opencircle; "><li class="listitem" style="list-style-type: circle"><p><span class="bold"><strong>Qt 5</strong></span>: at <a class="ulink" href="http://www.qt.io" target="_top">http://www.qt.io</a></p></li><li class="listitem" style="list-style-type: circle"><p><span class="bold"><strong>libsndfile</strong></span>: at <a class="ulink" href="http://www.mega-nerd.com/libsndfile/" target="_top">http://www.mega-nerd.com/libsndfile/</a></p></li><li class="listitem" style="list-style-type: circle"><p><span class="bold"><strong><abbr class="abbrev">ALSA</abbr></strong></span>: (>= 1.x) at <a class="ulink" href="http://www.alsa-project.org" target="_top">http://www.alsa-project.org</a>
(only if you wish to use <abbr class="abbrev">ALSA</abbr> as audio driver)</p></li><li class="listitem" style="list-style-type: circle"><p><span class="bold"><strong>Jack Audio Connection Kit (>= 0.80)</strong></span>: at
<a class="ulink" href="http://jackaudio.org/" target="_top">http://jackaudio.org/</a>
(only if you wish to use <abbr class="abbrev">JACK</abbr> as audio driver)</p></li><li class="listitem" style="list-style-type: circle"><p><span class="bold"><strong>PortAudio</strong></span>: at <a class="ulink" href="http://www.portaudio.com" target="_top">http://www.portaudio.com</a>
(only if you wish to use PortAudio as audio driver)</p></li><li class="listitem" style="list-style-type: circle"><p><span class="bold"><strong>PulseAudio</strong></span>: at <a class="ulink" href="http://www.pulseaudio.org" target="_top">http://www.pulseaudio.org</a>
(only if you wish to use PulseAudio as audio driver)</p></li><li class="listitem" style="list-style-type: circle"><p><span class="bold"><strong>Flac</strong></span>: at <a class="ulink" href="http://flac.sf.net" target="_top">http://flac.sf.net</a> (only if you
wish to use Flac samples)</p></li><li class="listitem" style="list-style-type: circle"><p><span class="bold"><strong>LADSPA</strong></span>: at <a class="ulink" href="http://www.ladspa.org" target="_top">http://www.ladspa.org</a> (only if you wish
to use <abbr class="abbrev">LADSPA</abbr> effects)</p></li><li class="listitem" style="list-style-type: circle"><p><span class="bold"><strong>liblrdf</strong></span>: at <a class="ulink" href="http://sf.net/projects/lrdf" target="_top">http://sf.net/projects/lrdf</a> (only if you wish to use lrdf to categorise effects)</p></li><li class="listitem" style="list-style-type: circle"><p><span class="bold"><strong><abbr class="abbrev">LASH</abbr></strong></span>: at <a class="ulink" href="http://lash.nongnu.org" target="_top">http://lash.nongnu.org</a> (only if
you wish to use <abbr class="abbrev">LASH</abbr>)</p></li><li class="listitem" style="list-style-type: circle"><p>
<span class="bold"><strong>liblo</strong></span>: at <a class="ulink" href="http://liblo.sourceforge.net/" target="_top">http://liblo.sourceforge.net/</a> for <a class="link" href="#chpt.osc" title="Chapter 17. OSC API"><abbr class="abbrev">OSC</abbr></a> and <a class="link" href="#chpt.overview.session_management.nsm" title="4.5.1. NSM"><abbr class="abbrev">NSM</abbr></a> support
</p></li></ul></div><p>Please install them with your distribution's package manager. If
you're running a Debian-based system, you can install the libraries
with:</p>
bla
blub
hermel
<pre class="screen"><code class="prompt">$</code> <span class="command"><strong>apt-get install qtbase5-dev qtbase5-dev-tools \
qttools5-dev qttools5-dev-tools libqt5xmlpatterns5-dev \
libarchive-dev libsndfile1-dev libasound2-dev liblo-dev \
libpulse-dev libcppunit-dev liblrdf-dev \
liblash-compat-dev librubberband-dev libjack-jackd2-dev</strong></span>
</pre>
schni
<p>Compiling with <span class="command"><strong>cmake</strong></span> can be done easily by using the <code class="filename">build.sh</code> script. Go to the directory where the <span class="command"><strong>git</strong></span> repository
was cloned and run the <code class="filename">build.sh</code> script without any arguments to display the help :</p>
bla
blub
hermel
<pre class="screen">
<code class="prompt">$</code> <span class="command"><strong>./build.sh</strong></span>
</pre>
schni
<p>The help is now displayed (and is self-explanatory) :
</p>
bla
blub
hermel
<pre class="screen">
<span class="command"><strong> r[m] => all built, temp and cache files</strong></span>
<span class="command"><strong> c[lean] => remove cache files</strong></span>
<span class="command"><strong> m[ake] => launch the build process</strong></span>
<span class="command"><strong> mm => launch the build process using ccache</strong></span>
<span class="command"><strong> mt => launch the build process with clang tidy checks enabled</strong></span>
<span class="command"><strong> d[oc] => build html documentation</strong></span>
<span class="command"><strong> g[raph] => draw a dependencies graph</strong></span>
<span class="command"><strong> h[elp] => show the build options</strong></span>
<span class="command"><strong> x|exec => execute hydrogen</strong></span>
<span class="command"><strong> t[ests] => execute tests</strong></span>
<span class="command"><strong> p[kg] => build source package</strong></span>
<span class="command"><strong> z => build using ccache and run from tree</strong></span>
</pre>
schni
<p>To build Hydrogen and execute the result, run the build script with the <em class="parameter"><code>m</code></em> option
</p>
bla
blub
hermel
<pre class="screen">
<code class="prompt">$</code> <span class="command"><strong>./build.sh m x</strong></span>
</pre>
schni
<p>and to install it permanently on your computer, change into the <code class="filename">build</code> folder and use the <span class="command"><strong>make</strong></span> command.
</p>
bla
blub
hermel
<pre class="screen">
<code class="prompt">$</code> <span class="command"><strong>cd build</strong></span>
<code class="prompt">$</code> <span class="command"><strong>sudo make install</strong></span>
</pre>
schni
<div class="note" style="margin-left: 5%;"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="img/admonitions/note.svg"></td><th align="left">Note</th></tr><tr><td align="left" valign="top"><p>For further details about the installation process please have a look the <code class="filename">INSTALL.txt</code> file (located in the top level directory once you downloaded the sources).</p></td></tr></table></div></div><div class="chapter"><div class="titlepage"><div><div><h2 class="title"><a name="chpt.keyboard_and_mouse"></a>Chapter 3. Keyboard and Mouse</h2></div></div></div><p>
The Hydrogen user interface is designed so that it can be
used entirely with the mouse, with the exception of text entry.
</p><p>
Most actions are performed with the left mouse button, and
implement what should be the most obvious behaviour for any
control. The right mouse button may sometimes perform an
alternate action, or bring up a context menu. Some common
controls also have alternate actions accessed by clicking
while holding a modifier key:
</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>
<span class="keycap"><strong>Ctrl</strong></span> + <span class="emphasis"><em>left click</em></span> : restore default value of knob or fader
</p></li><li class="listitem"><p>
<span class="keycap"><strong>Shift</strong></span> + <span class="emphasis"><em>left click</em></span> : bind <abbr class="abbrev">MIDI</abbr> event to <abbr class="abbrev">MIDI</abbr>-learnable widget (see <a class="xref" href="#chpt.midi.learnable" title="16.2. MIDI-learnable Widgets">Section 16.2</a>)
</p></li></ul></div><p>
Some controls will also respond to scroll wheel events for
convenience.
</p><p>
The keyboard can also be used for navigating and editing in
the <a class="link" href="#chpt.pattern_editor" title="Chapter 9. Pattern Editor">Pattern</a> and <a class="link" href="#chpt.song_editor" title="Chapter 8. Song Editor">Song Editors</a>, using a combination of
</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>
<span class="bold"><strong><span class="keycap"><strong>↑</strong></span>|<span class="keycap"><strong>↓</strong></span>|<span class="keycap"><strong>←</strong></span>|<span class="keycap"><strong>→</strong></span></strong></span> : move the
keyboard input cursor's position, or adjust values under
the cursor.
</p></li><li class="listitem"><p>
<span class="bold"><strong><span class="keycap"><strong>Shift</strong></span> + <span class="keycap"><strong>↑</strong></span>|<span class="keycap"><strong>↓</strong></span>|<span class="keycap"><strong>←</strong></span>|<span class="keycap"><strong>→</strong></span></strong></span> :
can be used to make selections of notes or pattern
groups as if the mouse had been dragged over them.
</p></li><li class="listitem"><p>
<span class="bold"><strong><span class="keycap"><strong>Enter</strong></span> and <span class="keycap"><strong>Return</strong></span></strong></span> : generally
performs the same action as a mouse click, but can also
start or end a move (or copy) of items in the same way
a mouse drag would.
</p></li><li class="listitem"><p>
<span class="bold"><strong><span class="keycap"><strong>Tab</strong></span> and <span class="keycap"><strong>Shift</strong></span> + <span class="keycap"><strong>Tab</strong></span></strong></span> : move
between the Pattern, Song and Note Property Editor.
</p></li><li class="listitem"><p>
<span class="bold"><strong><span class="keycap"><strong>Delete</strong></span></strong></span> :
delete notes or patterns.
</p></li><li class="listitem"><p>
<span class="bold"><strong><span class="keycap"><strong>Esc</strong></span></strong></span> :
cancels an ongoing selection, move or copy.
</p></li></ul></div><p>
</p><div class="note" style="margin-left: 5%;"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="img/admonitions/note.svg"></td><th align="left">Note</th></tr><tr><td align="left" valign="top"><p>
The keyboard input cursor is hidden from view until one of
the above keys is pressed. This keeps the display clear and
uncluttered when using the mouse. You can alter this default behavior in the <a class="link" href="#chpt.preferences.general_tab" title="5.1. General">General tab</a> of the Preferences.
</p></td></tr></table></div><p>
Most other keys on the keyboard can be used to play
<a class="link" href="#def.sample" title="Sample">samples</a> and enter notes in the same way a <abbr class="abbrev">MIDI</abbr> keyboard can be.
</p></div></div><div class="part"><div class="titlepage"><div><div><h1 class="title"><a name="part.using_hydrogen"></a>Part II. Using Hydrogen</h1></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl class="toc"><dt><span class="chapter"><a href="#chpt.overview">4. Overview</a></span></dt><dd><dl><dt><span class="sect1"><a href="#chpt.overview.gui">4.1. Main User Interface</a></span></dt><dt><span class="sect1"><a href="#chpt.overview.drumkits">4.2. Drumkit Concept</a></span></dt><dt><span class="sect1"><a href="#chpt.overview.midi_mapping_and_virtual_keyboard">4.3. MIDI-mapping and Virtual Keyboard</a></span></dt><dt><span class="sect1"><a href="#chpt.overview.recording">4.4. Recording in Hydrogen</a></span></dt><dt><span class="sect1"><a href="#chpt.overview.session_management">4.5. Session Management</a></span></dt><dd><dl><dt><span class="sect2"><a href="#chpt.overview.session_management.nsm">4.5.1. NSM</a></span></dt></dl></dd><dt><span class="sect1"><a href="#chpt.overview.cli">4.6. Command-line Options</a></span></dt></dl></dd><dt><span class="chapter"><a href="#chpt.preferences">5. Preferences</a></span></dt><dd><dl><dt><span class="sect1"><a href="#chpt.preferences.general_tab">5.1. General</a></span></dt><dt><span class="sect1"><a href="#chpt.preferences.audio_tab">5.2. Audio System</a></span></dt><dt><span class="sect1"><a href="#chpt.preferences.midi_tab">5.3. MIDI System</a></span></dt><dt><span class="sect1"><a href="#chpt.preferences.osc_tab">5.4. OSC</a></span></dt><dt><span class="sect1"><a href="#chpt.preferences.appearance_tab">5.5. Appearance</a></span></dt></dl></dd><dt><span class="chapter"><a href="#chpt.main_menu">6. Main Menu</a></span></dt><dd><dl><dt><span class="sect1"><a href="#sect.main_menu.projects">6.1. Project</a></span></dt><dt><span class="sect1"><a href="#sect.main_menu.undo">6.2. Undo</a></span></dt><dt><span class="sect1"><a href="#sect.main_menu.drumkits">6.3. Drumkits</a></span></dt><dt><span class="sect1"><a href="#sect.main_menu.instruments">6.4. Instruments</a></span></dt><dt><span class="sect1"><a href="#sect.main_menu.view">6.5. View</a></span></dt><dt><span class="sect1"><a href="#sect.main_menu.options">6.6. Options</a></span></dt><dt><span class="sect1"><a href="#sect.main_menu.debug">6.7. Debug</a></span></dt><dt><span class="sect1"><a href="#sect.main_menu.info">6.8. Info</a></span></dt></dl></dd><dt><span class="chapter"><a href="#chpt.main_toolbar">7. Main Toolbar</a></span></dt><dd><dl><dt><span class="sect1"><a href="#sect.main_toolbar.transport_control">7.1.
Transport Control
</a></span></dt><dt><span class="sect1"><a href="#sect.main_toolbar.tap_tempo_beat_counter">7.2. Tap Tempo and Beat Counter</a></span></dt><dd><dl><dt><span class="sect2"><a href="#sect.main_toolbar.tap_tempo_beat_counter.tap_tempo">7.2.1. Tap Tempo</a></span></dt><dt><span class="sect2"><a href="#sect.main_toolbar.tap_tempo_beat_counter.beat_counter">7.2.2. Beat Counter</a></span></dt></dl></dd><dt><span class="sect1"><a href="#sect.main_toolbar.bpm_control_and_metronome">7.3. BPM Control and Metronome</a></span></dt><dt><span class="sect1"><a href="#sect.main_toolbar.cpu_usage_midi_in">7.4. CPU Usage and MIDI in</a></span></dt><dt><span class="sect1"><a href="#sect.main_toolbar.jack_control">7.5. JACK Control</a></span></dt><dt><span class="sect1"><a href="#sect.main_toolbar.gui_state">7.6. GUI State</a></span></dt></dl></dd><dt><span class="chapter"><a href="#chpt.song_editor">8. Song Editor</a></span></dt><dd><dl><dt><span class="sect1"><a href="#chpt.song_editor.main_controls">8.1. Main Controls</a></span></dt><dt><span class="sect1"><a href="#chpt.song_editor.editor_modes">8.2. Song Editor modes</a></span></dt><dd><dl><dt><span class="sect2"><a href="#chpt.song_editor.editor_modes.select">8.2.1. Select Mode</a></span></dt><dt><span class="sect2"><a href="#chpt.song_editor.editor_modes.draw">8.2.2. Draw Mode</a></span></dt><dt><span class="sect2"><a href="#chpt.song_editor.editor_modes.song_mode">8.2.3. Song Mode</a></span></dt><dt><span class="sect2"><a href="#chpt.song_editor.editor_modes.pattern_mode">8.2.4. Pattern Mode</a></span></dt><dt><span class="sect2"><a href="#chpt.song_editor.editor_modes.stacked">8.2.5. Stacked Mode</a></span></dt></dl></dd><dt><span class="sect1"><a href="#chpt.song_editor.sidebar">8.3. Sidebar</a></span></dt><dt><span class="sect1"><a href="#chpt.song_editor.timeline">8.4. Timeline</a></span></dt><dt><span class="sect1"><a href="#chpt.song_editor.tag">8.5. Tags</a></span></dt><dt><span class="sect1"><a href="#chpt.song_editor.playbackTrack">8.6. Playback Track</a></span></dt><dt><span class="sect1"><a href="#sect.song_editor.automation_path">8.7. Automation Path</a></span></dt></dl></dd><dt><span class="chapter"><a href="#chpt.pattern_editor">9. Pattern Editor</a></span></dt><dd><dl><dt><span class="sect1"><a href="#chpt.pattern_editor.general">9.1. General</a></span></dt><dd><dl><dt><span class="sect2"><a href="#chpt.pattern_editor.controls">9.1.1. Controls</a></span></dt><dt><span class="sect2"><a href="#chpt.pattern_editor.sidebar">9.1.2. Sidebar</a></span></dt></dl></dd><dt><span class="sect1"><a href="#chpt.pattern_editor.drumkit">9.2. Drum Pattern Editor</a></span></dt><dt><span class="sect1"><a href="#chpt.pattern_editor.note_properties">9.3. Note Properties Editor</a></span></dt><dt><span class="sect1"><a href="#chpt.pattern_editor.piano_mode">9.4. Piano Roll Editor</a></span></dt></dl></dd><dt><span class="chapter"><a href="#chpt.sound_library">10. Sound Library (Drumkit/Pattern/Song Manager)</a></span></dt><dd><dl><dt><span class="sect1"><a href="#chpt.sound_library.drumkits">10.1. Drumkits</a></span></dt><dt><span class="sect1"><a href="#sect.sl.songs">10.2. Songs</a></span></dt><dt><span class="sect1"><a href="#sect.sl.patterns">10.3. Patterns</a></span></dt></dl></dd><dt><span class="chapter"><a href="#chpt.instrument_editor">11. Instrument Editor</a></span></dt><dd><dl><dt><span class="sect1"><a href="#chpt.instrument_editor.general">11.1. General</a></span></dt><dd><dl><dt><span class="sect2"><a href="#chpt.instrument_editor.envelope_parameters">11.1.1. Envelope Parameters</a></span></dt><dt><span class="sect2"><a href="#chpt.instrument_editor.gain_and_mute_group">11.1.2. Gain and Mute Group</a></span></dt><dt><span class="sect2"><a href="#chpt.instrument_editor.filter">11.1.3. Filter Parameters</a></span></dt><dt><span class="sect2"><a href="#chpt.instrument_editor.pitch_shift_parameters">11.1.4. Pitch Shift Parameters</a></span></dt><dt><span class="sect2"><a href="#chpt.instrument_editor.midi_out_settings">11.1.5. <abbr class="abbrev">MIDI</abbr> Out Settings</a></span></dt><dt><span class="sect2"><a href="#chpt.instrument_editor.HH_pressure_group">11.1.6. Hi-Hat Pressure Group</a></span></dt></dl></dd><dt><span class="sect1"><a href="#chpt.instrument_editor.layers">11.2. Layers</a></span></dt><dd><dl><dt><span class="sect2"><a href="#chpt.instrument_editor.layers.components">11.2.1. Components</a></span></dt><dt><span class="sect2"><a href="#chpt.instrument_editor.layers.layers">11.2.2. Layers</a></span></dt><dt><span class="sect2"><a href="#chpt.instrument_editor.layers.sample_selection">11.2.3. Sample Selection</a></span></dt><dt><span class="sect2"><a href="#chpt.instrument_editor.layers.controls">11.2.4. Controls</a></span></dt></dl></dd></dl></dd><dt><span class="chapter"><a href="#chpt.sample_editor">12. Sample Editor</a></span></dt><dd><dl><dt><span class="sect1"><a href="#chpt.sample_editor.wave_display">12.1. Wave Display and Region Editing</a></span></dt><dt><span class="sect1"><a href="#chpt.sample_editor.pitch">12.2. Pitch Shifting</a></span></dt><dt><span class="sect1"><a href="#chpt.sample_editor.playback_and_envelope_editor">12.3. Playback and Envelope Editor</a></span></dt></dl></dd><dt><span class="chapter"><a href="#chpt.mixer">13. Mixer</a></span></dt><dd><dl><dt><span class="sect1"><a href="#chpt.mixer.channel_strips">13.1. Instrument Channel Strips</a></span></dt><dt><span class="sect1"><a href="#chpt.mixer.component_strips">13.2. Component Channel Strips</a></span></dt><dt><span class="sect1"><a href="#sect.fx_rack_LADSPA">13.3. FX Rack and LADSPA Plugins</a></span></dt><dt><span class="sect1"><a href="#chpt.mixer.master_fader_strip">13.4. Master Fader Strip</a></span></dt><dd><dl><dt><span class="sect2"><a href="#chpt.mixer.master_fader_strip.humanization">13.4.1. Humanization</a></span></dt><dt><span class="sect2"><a href="#chpt.mixer.master_fader_strip.mixer_settings">13.4.2. Mixer Settings</a></span></dt></dl></dd></dl></dd><dt><span class="chapter"><a href="#chpt.director">14. Director</a></span></dt><dt><span class="chapter"><a href="#chpt.playlist_editor">15. Playlist Editor</a></span></dt><dd><dl><dt><span class="sect1"><a href="#chpt.playlist_editor.main_window">15.1. Main Window</a></span></dt><dd><dl><dt><span class="sect2"><a href="#chpt.playlist_editor.main_window.song_list">15.1.1. Song List</a></span></dt><dt><span class="sect2"><a href="#chpt.playlist_editor.main_window.controls">15.1.2. Controls</a></span></dt><dt><span class="sect2"><a href="#chpt.playlist_editor.main_window.scripts">15.1.3. Scripts</a></span></dt></dl></dd><dt><span class="sect1"><a href="#chpt.playlist_editor.menu">15.2. Menu</a></span></dt><dd><dl><dt><span class="sect2"><a href="#chpt.playlist_editor.menu.playlist">15.2.1. Playlist</a></span></dt><dt><span class="sect2"><a href="#chpt.playlist_editor.menu.scripts">15.2.2. Scripts</a></span></dt></dl></dd></dl></dd><dt><span class="chapter"><a href="#chpt.midi">16. MIDI API</a></span></dt><dd><dl><dt><span class="sect1"><a href="#chpt.midi.actions">16.1. MIDI Actions</a></span></dt><dd><dl><dt><span class="sect2"><a href="#chpt.midi.actions.events">16.1.1. Events</a></span></dt><dt><span class="sect2"><a href="#chpt.midi.actions.actions">16.1.2. Actions</a></span></dt></dl></dd><dt><span class="sect1"><a href="#chpt.midi.learnable">16.2. MIDI-learnable Widgets</a></span></dt></dl></dd><dt><span class="chapter"><a href="#chpt.osc">17. OSC API</a></span></dt><dd><dl><dt><span class="sect1"><a href="#chpt.osc.basics">17.1. Basics</a></span></dt><dt><span class="sect1"><a href="#chpt.osc.commands">17.2. Commands</a></span></dt><dd><dl><dt><span class="sect2"><a href="#chpt.osc.commands.syntax">17.2.1. Syntax</a></span></dt><dt><span class="sect2"><a href="#chpt.osc.commands.all_messages">17.2.2. All Commands</a></span></dt></dl></dd></dl></dd></dl></div><div class="chapter"><div class="titlepage"><div><div><h2 class="title"><a name="chpt.overview"></a>Chapter 4. Overview</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl class="toc"><dt><span class="sect1"><a href="#chpt.overview.gui">4.1. Main User Interface</a></span></dt><dt><span class="sect1"><a href="#chpt.overview.drumkits">4.2. Drumkit Concept</a></span></dt><dt><span class="sect1"><a href="#chpt.overview.midi_mapping_and_virtual_keyboard">4.3. MIDI-mapping and Virtual Keyboard</a></span></dt><dt><span class="sect1"><a href="#chpt.overview.recording">4.4. Recording in Hydrogen</a></span></dt><dt><span class="sect1"><a href="#chpt.overview.session_management">4.5. Session Management</a></span></dt><dd><dl><dt><span class="sect2"><a href="#chpt.overview.session_management.nsm">4.5.1. NSM</a></span></dt></dl></dd><dt><span class="sect1"><a href="#chpt.overview.cli">4.6. Command-line Options</a></span></dt></dl></div><div class="sect1"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="chpt.overview.gui"></a>4.1. Main User Interface</h2></div></div></div><div class="figure"><a name="fig.UI_overview"></a><p class="title"><b>Figure 4.1. The Main UI in Single Pane mode</b></p><div class="figure-contents"><div class="mediaobject"><img src="generated_en/GUI_Sections_0.9.5_v2.png" alt="The Main UI in Single Pane mode"></div></div></div><br class="figure-break"><p>The Main UI comes in 2 flavors : the (classic) Single Pane mode (ideal for
large- and medium size screens), and the Tabbed mode (optimized for netbook screen
sizes).
</p><div class="tip" style="margin-left: 5%;"><table border="0" summary="Tip"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Tip]" src="img/admonitions/tip.svg"></td><th align="left">Tip</th></tr><tr><td align="left" valign="top"><p>
You can switch between these two modes in the <a class="link" href="#chpt.preferences.appearance_tab" title="5.5. Appearance">Appearance</a> tab of the Preferences.
</p></td></tr></table></div><p>
Below you can see the main UI split up in 5 parts: the <a class="link" href="#chpt.main_menu" title="Chapter 6. Main Menu">Main Menu</a>, <a class="link" href="#chpt.main_toolbar" title="Chapter 7. Main Toolbar">Main
Toolbar</a>, <a class="link" href="#chpt.song_editor" title="Chapter 8. Song Editor">Song Editor</a>, <a class="link" href="#chpt.pattern_editor" title="Chapter 9. Pattern Editor">Pattern Editor</a> and the <a class="link" href="#chpt.instrument_editor" title="Chapter 11. Instrument Editor">Instrument</a> and <a class="link" href="#chpt.sound_library" title="Chapter 10. Sound Library (Drumkit/Pattern/Song Manager)">Sound Library Editor</a>.
These sections will be explained in detail further down in this
manual.
</p><div class="figure"><a name="fig.tabbed_UI_overview"></a><p class="title"><b>Figure 4.2. The Main UI in Tabbed mode</b></p><div class="figure-contents"><div class="mediaobject"><img src="generated_en/MainUI_tabbed.png" alt="The Main UI in Tabbed mode"></div></div></div><br class="figure-break"></div><div class="sect1"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="chpt.overview.drumkits"></a>4.2. Drumkit Concept</h2></div></div></div><p>Let's start with a little history on the concept of Drumkits within in Hydrogen. It began as a
dedicated drum machine but has evolved into a versatile <a class="link" href="#def.sample" title="Sample">sample</a>-based sound synthesizer/sequencer
that is capable of generating and manipulating all sorts of sounds. Hence the original
"Drumkit" terminology is slightly misleading. You can load any kind of sound into a
"Drumkit" and manipulate that sound just like playing a regular synthesizer. This is
also the main reason why the <a class="link" href="#chpt.pattern_editor.piano_mode" title="9.4. Piano Roll Editor">Piano Roll Editor</a> was introduced.
</p><p>
To sum it up, nowadays a Drumkit is a collection of a number
of instruments (snare, kick, sampled voice, bass sound ...), using one or more <a class="link" href="#def.component" title="Component">components</a> which each can consist of multiple
<a class="link" href="#def.layer" title="Layer">layered</a> samples.
</p><div class="tip" style="margin-left: 5%;"><table border="0" summary="Tip"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Tip]" src="img/admonitions/tip.svg"></td><th align="left">Tip</th></tr><tr><td align="left" valign="top"><p>
In case you are not familiar with the world of sound synthesis, you can check out the <a class="link" href="#glossary" title="Glossary">Glossary</a> for a number of useful definitions.
</p></td></tr></table></div></div><div class="sect1"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="chpt.overview.midi_mapping_and_virtual_keyboard"></a>4.3. MIDI-mapping and Virtual Keyboard</h2></div></div></div><p>
Instead of playing back programmed patterns Hydrogen can also be used synthesize drum sounds for incoming <abbr class="abbrev">MIDI</abbr> or keyboard events.
</p><p>
Using the <span class="bold"><strong>Input mode</strong></span> in the <a class="link" href="#sect.main_menu.options" title="6.6. Options">Options</a> tab of the Main Menu you can choose between two different ways to emulate sound. <code class="option">Drumkit</code> maps different <abbr class="abbrev">MIDI</abbr> events and keyboard inputs to different instruments of the current drumkit while <code class="option">Instrument</code> maps them to pitch-shifted samples of the instrument currently selected in the <a class="link" href="#chpt.song_editor" title="Chapter 8. Song Editor">Song Editor</a>. You can think of these modes as input versions of both the <a class="link" href="#chpt.pattern_editor.drumkit" title="9.2. Drum Pattern Editor">Drumkit Editor</a> and the <a class="link" href="#chpt.pattern_editor.piano_mode" title="9.4. Piano Roll Editor">Piano Roll Editor</a>.
</p><p>
Which <span class="bold"><strong><abbr class="abbrev">MIDI</abbr> input</strong></span> maps to which instrument is depending of the <a class="link" href="#chpt.instrument_editor.midi_out_settings" title="11.1.5. MIDI Out Settings">Note</a> parameter in the Instrument Editor set for in each particular drumkit. An example for the <span class="emphasis"><em>GMRockKit</em></span> is shown in the <a class="link" href="#chpt.pattern_editor.midi_mapping" title="Table 4.1. MIDI Mapping">table</a> below.
</p><div class="note" style="margin-left: 5%;"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="img/admonitions/note.svg"></td><th align="left">Note</th></tr><tr><td align="left" valign="top"><p>
In order to process incoming <abbr class="abbrev">MIDI</abbr> messages, you have to enable the <span class="bold"><strong>Use output note as input</strong></span> option and set up the overall <abbr class="abbrev">MIDI</abbr> support in the <a class="link" href="#chpt.preferences.midi_tab" title="5.3. MIDI System"><abbr class="abbrev">MIDI</abbr> system</a> tab of the Preferences dialog first.
</p></td></tr></table></div><p>
Alternatively you can use the <span class="bold"><strong>Virtual keyboard</strong></span> provided in Hydrogen. It maps a number of keys of your computer keyboard to incoming note and allows you to use it as a traditional <abbr class="abbrev">MIDI</abbr> keyboard. The mapping is shown in the <a class="link" href="#chpt.pattern_editor.midi_mapping" title="Table 4.1. MIDI Mapping">table</a> as well as in <a class="link" href="#fig.letters_keyboard">figure</a> below.
</p><div class="table"><a name="chpt.pattern_editor.midi_mapping"></a><p class="title"><b>Table 4.1. <abbr class="abbrev">MIDI</abbr> Mapping</b></p><div class="table-contents"><table class="table" summary="MIDI Mapping" border="1"><colgroup><col><col><col><col><col></colgroup><thead><tr><th align="left">
Instr. Pos.
</th><th align="left">
<abbr class="abbrev">MIDI</abbr> Note
</th><th align="left">
PC Keyboard Key
</th><th align="left">
Hydrogen GMRockKit
</th><th align="left">
GM Standard
</th></tr></thead><tbody><tr><td align="left"> </td><td align="left">35</td><td align="left"> </td><td align="left"> </td><td align="left">Bass Drum 2</td></tr><tr><td align="left">1</td><td align="left">36</td><td align="left">Z</td><td align="left">Kick</td><td align="left">Bass Drum 1</td></tr><tr><td align="left">2</td><td align="left">37</td><td align="left">S</td><td align="left">Stick</td><td align="left">Side Stick/Rimshot</td></tr><tr><td align="left">3</td><td align="left">38</td><td align="left">X</td><td align="left">Snare</td><td align="left">Snare Drum 1</td></tr><tr><td align="left">4</td><td align="left">39</td><td align="left">D</td><td align="left">Hand Clap</td><td align="left">Hand Clap</td></tr><tr><td align="left">5</td><td align="left">40</td><td align="left">C</td><td align="left">Snare Rimshot</td><td align="left">Snare Drum 2</td></tr><tr><td align="left">6</td><td align="left">41</td><td align="left">V</td><td align="left">Floor Tom</td><td align="left">Low Tom 2</td></tr><tr><td align="left">7</td><td align="left">42</td><td align="left">G</td><td align="left">Hat Closed</td><td align="left">Closed Hi-hat</td></tr><tr><td align="left">8</td><td align="left">43</td><td align="left">B</td><td align="left">Tom 2</td><td align="left">Low Tom 1</td></tr><tr><td align="left">9</td><td align="left">44</td><td align="left">H</td><td align="left">Hat Pedal</td><td align="left">Pedal Hi-hat</td></tr><tr><td align="left">10</td><td align="left">45</td><td align="left">N</td><td align="left">Tom 1</td><td align="left">Mid Tom 2</td></tr><tr><td align="left">11</td><td align="left">46</td><td align="left">J</td><td align="left">Hat Open</td><td align="left">Open Hi-hat</td></tr><tr><td align="left">12</td><td align="left">47</td><td align="left">M</td><td align="left">Cowbell</td><td align="left">Mid Tom 1</td></tr><tr><td align="left">13</td><td align="left">48</td><td align="left">Q</td><td align="left">Ride</td><td align="left">High Tom 2</td></tr><tr><td align="left">14</td><td align="left">49</td><td align="left">2</td><td align="left">Crash</td><td align="left">Crash Cymbal 1</td></tr><tr><td align="left">15</td><td align="left">50</td><td align="left">W</td><td align="left">Ride 2</td><td align="left">High Tom 1</td></tr><tr><td align="left">16</td><td align="left">51</td><td align="left">3</td><td align="left">Splash</td><td align="left">Ride Cymbal 1</td></tr><tr><td align="left">17</td><td align="left">52</td><td align="left">E</td><td align="left">Hat Semi-Open</td><td align="left">Chinese Cymbal</td></tr><tr><td align="left">18</td><td align="left">53</td><td align="left">R</td><td align="left">Bell</td><td align="left">Ride Bell</td></tr><tr><td align="left">19</td><td align="left">54</td><td align="left">5</td><td align="left"> </td><td align="left">Tambourine</td></tr><tr><td align="left">20</td><td align="left">55</td><td align="left">T</td><td align="left"> </td><td align="left">Splash Cymbal</td></tr><tr><td align="left">21</td><td align="left">56</td><td align="left">6</td><td align="left"> </td><td align="left">Cowbell</td></tr><tr><td align="left">22</td><td align="left">57</td><td align="left">Y</td><td align="left"> </td><td align="left">Crash Cymbal 2</td></tr><tr><td align="left">23</td><td align="left">58</td><td align="left">7</td><td align="left"> </td><td align="left">Vibra Slap</td></tr><tr><td align="left">24</td><td align="left">59</td><td align="left">U</td><td align="left"> </td><td align="left">Ride Cymbal 2</td></tr><tr><td align="left">25</td><td align="left">60</td><td align="left"> </td><td align="left"> </td><td align="left">High Bongo</td></tr><tr><td align="left">26</td><td align="left">61</td><td align="left"> </td><td align="left"> </td><td align="left">Low Bongo</td></tr><tr><td align="left">27</td><td align="left">62</td><td align="left"> </td><td align="left"> </td><td align="left">Mute High Conga</td></tr><tr><td align="left">28</td><td align="left">63</td><td align="left"> </td><td align="left"> </td><td align="left">Open High Conga</td></tr><tr><td align="left">29</td><td align="left">64</td><td align="left"> </td><td align="left"> </td><td align="left">Low Conga</td></tr><tr><td align="left">30</td><td align="left">65</td><td align="left"> </td><td align="left"> </td><td align="left">High Timbale</td></tr><tr><td align="left">31</td><td align="left">66</td><td align="left"> </td><td align="left"> </td><td align="left">Low Timbale</td></tr><tr><td align="left">32</td><td align="left">67</td><td align="left"> </td><td align="left"> </td><td align="left">High Agogô</td></tr><tr><td align="left">33</td><td align="left">68</td><td align="left"> </td><td align="left"> </td><td align="left">Low Agogô</td></tr><tr><td align="left">34</td><td align="left">69</td><td align="left"> </td><td align="left"> </td><td align="left">Cabasa</td></tr><tr><td align="left">35</td><td align="left">70</td><td align="left"> </td><td align="left"> </td><td align="left">Maracas</td></tr><tr><td align="left">36</td><td align="left">71</td><td align="left"> </td><td align="left"> </td><td align="left">Short Whistle</td></tr><tr><td align="left">37</td><td align="left">72</td><td align="left"> </td><td align="left"> </td><td align="left">Long Whistle</td></tr><tr><td align="left">38</td><td align="left">73</td><td align="left"> </td><td align="left"> </td><td align="left">Short Güiro</td></tr><tr><td align="left">39</td><td align="left">74</td><td align="left"> </td><td align="left"> </td><td align="left">Long Güiro</td></tr><tr><td align="left">40</td><td align="left">75</td><td align="left"> </td><td align="left"> </td><td align="left">Claves</td></tr><tr><td align="left">41</td><td align="left">76</td><td align="left"> </td><td align="left"> </td><td align="left">High Wood Block</td></tr><tr><td align="left">42</td><td align="left">77</td><td align="left"> </td><td align="left"> </td><td align="left">Low Wood Block</td></tr><tr><td align="left">43</td><td align="left">78</td><td align="left"> </td><td align="left"> </td><td align="left">Mute Cuíca</td></tr><tr><td align="left">44</td><td align="left">79</td><td align="left"> </td><td align="left"> </td><td align="left">Open Cuíca</td></tr><tr><td align="left">45</td><td align="left">80</td><td align="left"> </td><td align="left"> </td><td align="left">Mute Triangle</td></tr><tr><td align="left">46</td><td align="left">81</td><td align="left"> </td><td align="left"> </td><td align="left">Open Triangle</td></tr></tbody></table></div></div><br class="table-break"><div class="note" style="margin-left: 5%;"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="img/admonitions/note.svg"></td><th align="left">Note</th></tr><tr><td align="left" valign="top"><p>
The names of the instruments depend on the
drumkit that is loaded. This table below refers to the GMRockKit that is shipped with Hydrogen and loaded by default.
</p></td></tr></table></div><p>When adjusting the mapping or creating your own custom drumkit try to follow the <span class="bold"><strong>General <abbr class="abbrev">MIDI</abbr> (GM)</strong></span> standard as accurately as possible. This will ensure that switching between
drumkits goes smoothly. You are of course free to place your instruments anywhere in your drumkit, and
sometimes it isn't even possible to follow the GM standard, but it makes life a lot easier if you do.</p><div class="note" style="margin-left: 5%;"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="img/admonitions/note.svg"></td><th align="left">Note</th></tr><tr><td align="left" valign="top"><p>
Keep in mind that it is the <span class="emphasis"><em>position</em></span> of the instrument (within the loaded drumkit) that
is linked to a <abbr class="abbrev">MIDI</abbr>-note/keyboard-key and <span class="emphasis"><em>not the name</em></span> of the instrument.
</p></td></tr></table></div><p>For a better visualization you can also find the mapping notes to your PC's keyboard key in the figure below.</p><div class="informalfigure"><a name="fig.letters_keyboard"></a><div class="mediaobject"><img src="img/tastiera.png" alt="Picture illustrating the mapping of Hydrogen's virtual keyboard to the layout of the computers' keyboard."></div></div></div><div class="sect1"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="chpt.overview.recording"></a>4.4. Recording in Hydrogen</h2></div></div></div><p>
In addition to manually program pattern using mouse and keyboard you can also record one or multiple pattern. You can do so using an external <abbr class="abbrev">MIDI</abbr> device, like an e-drum, or use the <a class="link" href="#chpt.overview.midi_mapping_and_virtual_keyboard" title="4.3. MIDI-mapping and Virtual Keyboard">virtual keyboard</a> provided by Hydrogen.
</p><p>
In order to start recording, first activate the record button
<span class="inlinemediaobject"><img src="img/Rec_button.png" alt="Grey record button with a red circle in its center."></span>
in the <a class="link" href="#sect.main_toolbar.transport_control" title="7.1. Transport Control">Main Toolbar</a> and afterwards press the
<span class="inlinemediaobject"><img src="img/btn_play_off.png" alt="Grey play and pause button containing two vertical black lines (left) and a black triangle (right) pointing to the right."></span>
button located right next to it (like in a classical tape recorder).
</p><p>
Using the playback mode of the <a class="link" href="#chpt.song_editor" title="Chapter 8. Song Editor">Song Editor</a> you can choose between the following two scenarios. When in <a class="link" href="#chpt.song_editor.editor_modes.pattern_mode" title="8.2.4. Pattern Mode">Pattern mode</a> all inserted notes will be added to pattern currently selected in the <a class="link" href="#chpt.song_editor.sidebar" title="8.3. Sidebar">Sidebar</a> of the Song Editor. When, on the other hand, in <a class="link" href="#chpt.song_editor.editor_modes.song_mode" title="8.2.3. Song Mode">Song mode</a> the input notes will be added to the active pattern (the one the playhead is located in and is currently used for playback). If several patterns are selected in a single row, the input notes will only be added to the pattern at the bottom.
</p><div class="note" style="margin-left: 5%;"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="img/admonitions/note.svg"></td><th align="left">Note</th></tr><tr><td align="left" valign="top"><p>
The incoming notes will be added in a non-destructive way. This means when adding two notes at the same position, you will have two notes being played back at once (with double the volume of a single one).
</p></td></tr></table></div></div><div class="sect1"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="chpt.overview.session_management"></a>4.5. Session Management</h2></div></div></div><p>
With Session Management you can easily restore complex sessions involving numerous applications including their particular state. Hydrogen does support some Session Management systems too.
</p><div class="warning" style="margin-left: 5%;"><table border="0" summary="Warning"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Warning]" src="img/admonitions/warning.svg"></td><th align="left">Warning</th></tr><tr><td align="left" valign="top"><p>
All the supported Session Management protocols are Linux only. There is no (tested) support for MacOS and Windows yet.
</p></td></tr></table></div><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>
<span class="bold"><strong><abbr class="abbrev">NSM</abbr></strong></span>:
<a class="ulink" href="http://non.tuxfamily.org/nsm/API.html" target="_top">Non Session Manager (<abbr class="abbrev">NSM</abbr>)</a> is of 2021 the de facto standard in Session Management tools within the Linux audio community and Hydrogen does over full support and compliance to its API.
</p><div class="tip" style="margin-left: 5%;"><table border="0" summary="Tip"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Tip]" src="img/admonitions/tip.svg"></td><th align="left">Tip</th></tr><tr><td align="left" valign="top"><p>
We highly recommend using this protocol for Session Management.
</p></td></tr></table></div><p>
</p></li><li class="listitem"><p>
<span class="bold"><strong><abbr class="abbrev">LASH</abbr></strong></span>:
Hydrogen provides a basic support for <a class="ulink" href="http://lash.nongnu.org" target="_top">LASH Audio Session Handler (<abbr class="abbrev">LASH</abbr>)</a>. This covers recalling the song used within the session but, unlike the NSM support, no recalling of the <abbr class="abbrev">JACK</abbr> connections and no per-session preferences.
</p><div class="note" style="margin-left: 5%;"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="img/admonitions/note.svg"></td><th align="left">Note</th></tr><tr><td align="left" valign="top"><p>
You have to activate <abbr class="abbrev">LASH</abbr> support in the <a class="link" href="#fig.preferences.general_tab" title="Figure 5.1. The General Tab">General</a> tab of the Preference dialog in order to use it.
</p></td></tr></table></div><p>
</p></li><li class="listitem"><p>
<span class="bold"><strong><abbr class="abbrev">JACK</abbr> Session</strong></span>:
<a class="ulink" href="https://jackaudio.org" target="_top"><abbr class="abbrev">JACK</abbr> Session</a> has been marked <a class="ulink" href="https://jackaudio.org/news/2020/10/15/jack2-v1915-release-and-current-status.html" target="_top">deprecated</a> by the <abbr class="abbrev">JACK</abbr> project.
</p><div class="warning" style="margin-left: 5%;"><table border="0" summary="Warning"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Warning]" src="img/admonitions/warning.svg"></td><th align="left">Warning</th></tr><tr><td align="left" valign="top"><p>
Hydrogen versions <= 1.1 still feature this Session Management protocol. But it will be removed in future releases.
</p></td></tr></table></div><p>
</p></li></ul></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="chpt.overview.session_management.nsm"></a>4.5.1. NSM</h3></div></div></div><p>
Hydrogen will be under session management if you start it via a <abbr class="abbrev">NSM</abbr> server application, like <span class="command"><strong>Non Session Manager</strong></span> or <span class="command"><strong>RaySession</strong></span>. You can easily check whether Hydrogen is aware of the session by checking out the <code class="option">Project</code> option of the <a class="link" href="#chpt.main_menu" title="Chapter 6. Main Menu">Main Menu</a> as some action will have changed in order to comply to the <abbr class="abbrev">NSM</abbr> API.
</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>
<span class="bold"><strong>Replace With New Song</strong></span>:
instead of <a class="link" href="#sect.main_menu.projects.new">New</a>. Replaces the song associated with the session by an empty one.
</p></li><li class="listitem"><p>
<span class="bold"><strong>Import Into Session</strong></span>:
instead of <a class="link" href="#sect.main_menu.projects.open">Open</a>. Replaces the song associated with the session by a song of your choice.
</p><div class="warning" style="margin-left: 5%;"><table border="0" summary="Warning"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Warning]" src="img/admonitions/warning.svg"></td><th align="left">Warning</th></tr><tr><td align="left" valign="top"><p>
In Hydrogen version 1.1 the import into a session is not yet fully supported. While the selected file will be loaded and you can work with it, Hydrogen won't recall it after closing and opening the session. You need to copy the corresponding <a class="link" href="#chpt.file_types.h2song">.h2song</a> file manually into the session folder to make your choice permanent.
</p></td></tr></table></div><p>
</p></li><li class="listitem"><p>
<span class="bold"><strong>Import Recent Info Session</strong></span>:
instead of <a class="link" href="#sect.main_menu.projects.open_recent">Open Recent</a>. Replaces the song associated with the session by one of the recently used songs.
</p><div class="warning" style="margin-left: 5%;"><table border="0" summary="Warning"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Warning]" src="img/admonitions/warning.svg"></td><th align="left">Warning</th></tr><tr><td align="left" valign="top"><p>
In Hydrogen version 1.1 the import into a session is not yet fully supported. While the selected file will be loaded and you can work with it, Hydrogen won't recall it after closing and opening the session. You need to copy the corresponding <a class="link" href="#chpt.file_types.h2song">.h2song</a> file manually into the session folder to make your choice permanent.
</p></td></tr></table></div><p>
</p></li><li class="listitem"><p>
<span class="bold"><strong>Export From Session As</strong></span>:
instead of <a class="link" href="#sect.main_menu.projects.save_as">Save As</a>. Stores the song associated with the session at a location of your choice as <a class="link" href="#chpt.file_types.h2song">.h2song</a> file.
</p><div class="note" style="margin-left: 5%;"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="img/admonitions/note.svg"></td><th align="left">Note</th></tr><tr><td align="left" valign="top"><p>
In contrast to the <span class="emphasis"><em>Save As</em></span> command the underlying path of the current song will not be changed. All subsequent <span class="emphasis"><em>Save</em></span> actions will store the current state of the song to the file in the session folder and <span class="bold"><strong>not</strong></span> to the path of the exported file.
</p></td></tr></table></div><p>
</p></li></ul></div><div class="note" style="margin-left: 5%;"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="img/admonitions/note.svg"></td><th align="left">Note</th></tr><tr><td align="left" valign="top"><p>
The <a class="link" href="#sect.main_menu.projects.open_demo">Open Demo</a> option will be missing.
</p></td></tr></table></div><p>
Both the song and the preferences associated with the session will be stored in a session folder called <code class="filename">Hydrogen.*</code>. In addition, the drumkit (and its samples) used with the song will linked into the session folder as well. If the link is replaced by a folder containing a valid drumkit, this one will be used over the system and user drumkits.
</p><div class="tip" style="margin-left: 5%;"><table border="0" summary="Tip"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Tip]" src="img/admonitions/tip.svg"></td><th align="left">Tip</th></tr><tr><td align="left" valign="top"><p>
This allows you to create fully self sufficient backup of your Hydrogen session using <span class="command"><strong>tar -chf</strong></span>. These can be even ported and used to systems which do not have the required drumkits installed.
</p></td></tr></table></div><p>
</p></div></div><div class="sect1"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="chpt.overview.cli"></a>4.6. Command-line Options</h2></div></div></div><p>
After <a class="link" href="#chpt.download" title="Chapter 1. Download">installing</a> Hydrogen on your system you can invoke it from the command-line with a number of different options.
bla
blub
hermel
</p><pre class="screen">
<span class="command"><strong>-h, --help Displays this help.</strong></span>
<span class="command"><strong>-v, --version Displays version information.</strong></span>
<span class="command"><strong>-d, --driver <Audiodriver> Use the selected audio driver (jack, alsa, oss)</strong></span>
<span class="command"><strong>-i, --install <File> Install a drumkit (*.h2drumkit)</strong></span>
<span class="command"><strong>-n, --nosplash Hide splash screen</strong></span>
<span class="command"><strong>-p, --playlist <File> Load a playlist (*.h2playlist) at startup</strong></span>
<span class="command"><strong>-P, --data <Path> Use an alternate system data path</strong></span>
<span class="command"><strong>-s, --song <File> Load a song (*.h2song) at startup</strong></span>
<span class="command"><strong>-k, --kit <DrumkitName> Load a drumkit at startup</strong></span>
<span class="command"><strong>-V, --verbose <Level> Level, if present, may be None, Error, Warning, Info, Debug or 0xHHHH</strong></span>
</pre><p>
schni
</p></div></div><div class="chapter"><div class="titlepage"><div><div><h2 class="title"><a name="chpt.preferences"></a>Chapter 5. Preferences</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl class="toc"><dt><span class="sect1"><a href="#chpt.preferences.general_tab">5.1. General</a></span></dt><dt><span class="sect1"><a href="#chpt.preferences.audio_tab">5.2. Audio System</a></span></dt><dt><span class="sect1"><a href="#chpt.preferences.midi_tab">5.3. MIDI System</a></span></dt><dt><span class="sect1"><a href="#chpt.preferences.osc_tab">5.4. OSC</a></span></dt><dt><span class="sect1"><a href="#chpt.preferences.appearance_tab">5.5. Appearance</a></span></dt></dl></div><p>Via this window most of the configurations and customization can be altered. The Preferences Dialog can be accessed via the <em class="parameter"><code>Options</code></em> element in the <a class="link" href="#chpt.main_menu" title="Chapter 6. Main Menu">Main Menu</a>.</p><div class="note" style="margin-left: 5%;"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="img/admonitions/note.svg"></td><th align="left">Note</th></tr><tr><td align="left" valign="top"><p>
All changes done in the Preferences Dialog - if not noted otherwise via a popup - will take effect when clicking the <span class="bold"><strong>Ok</strong></span> button at the bottom of the window.
</p></td></tr></table></div><div class="sect1"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="chpt.preferences.general_tab"></a>5.1. General</h2></div></div></div><div class="figure"><a name="fig.preferences.general_tab"></a><p class="title"><b>Figure 5.1. The General Tab</b></p><div class="figure-contents"><div class="mediaobject"><img src="generated_en/PreferencesGeneral_V3.png" alt="The General Tab"></div></div></div><br class="figure-break"><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>
<span class="bold"><strong>Language</strong></span>:
chooses one of the translations Hydrogen is available in.
</p><div class="note" style="margin-left: 5%;"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="img/admonitions/note.svg"></td><th align="left">Note</th></tr><tr><td align="left" valign="top"><p>
For this setting to take effect you have to restart Hydrogen.
</p></td></tr></table></div><p>
</p><div class="tip" style="margin-left: 5%;"><table border="0" summary="Tip"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Tip]" src="img/admonitions/tip.svg"></td><th align="left">Tip</th></tr><tr><td align="left" valign="top"><p>
If your mother tongue is not available or the corresponding translation is flawed or incomplete, you would have an accessible way to contribute to Hydrogen at hand. Please see the <a class="link" href="#sect.main_menu.info" title="6.8. Info">About</a> dialog in the Info option of the Main menu for information of how to contact the Hydrogen dev team.
</p></td></tr></table></div><p>
</p></li><li class="listitem"><p>
<span class="bold"><strong>Reopen last used song</strong></span>:
determines whether Hydrogen will open the last used song during startup or an empty song instead.
</p></li><li class="listitem"><p>
<span class="bold"><strong>Reopen last used playlist</strong></span>:
determines whether the last used <a class="link" href="#chpt.playlist_editor" title="Chapter 15. Playlist Editor">Playlist</a> will be loaded during startup or none at all.
</p><div class="tip" style="margin-left: 5%;"><table border="0" summary="Tip"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Tip]" src="img/admonitions/tip.svg"></td><th align="left">Tip</th></tr><tr><td align="left" valign="top"><p>
This can come in handy when you are using Hydrogen live.
</p></td></tr></table></div><p>
</p></li><li class="listitem"><p>
<span class="bold"><strong>Use relative paths for playlist</strong></span>:
specifies whether the path names in the stored <a class="link" href="#chpt.file_types.h2playlist">.h2playlist</a> file will contain absolute paths or a path relative to the <code class="filename">playlist</code> folder in the Hydrogen data
directory (usually <code class="filename">$HOME/.hydrogen/data/</code>).
</p><div class="tip" style="margin-left: 5%;"><table border="0" summary="Tip"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Tip]" src="img/admonitions/tip.svg"></td><th align="left">Tip</th></tr><tr><td align="left" valign="top"><p>
Using relative paths might be handy when using your playlist on different computers or user profiles.
</p></td></tr></table></div><p>
</p></li><li class="listitem"><p>
<span class="bold"><strong>Hide keyboard input cursor</strong></span>:
hides the keyboard cursor until you press a key on you keyboard (see <a class="xref" href="#chpt.keyboard_and_mouse" title="Chapter 3. Keyboard and Mouse">Chapter 3</a>). By enabling this feature you can switch to the look and feel of the interaction with the <a class="link" href="#chpt.pattern_editor" title="Chapter 9. Pattern Editor">Pattern Editor</a> and <a class="link" href="#chpt.song_editor" title="Chapter 8. Song Editor">Song Editor</a> prior to Hydrogen v1.1.
</p></li><li class="listitem"><p>
<span class="bold"><strong>Use LASH</strong></span>:
enables <abbr class="abbrev">LASH</abbr> (<abbr class="abbrev">LASH</abbr> Audio Session Handler) support within Hydrogen. This allows you to recover a particular song associated with a session.
</p><div class="tip" style="margin-left: 5%;"><table border="0" summary="Tip"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Tip]" src="img/admonitions/tip.svg"></td><th align="left">Tip</th></tr><tr><td align="left" valign="top"><p>
You may consider using the more advanced <a class="link" href="#chpt.overview.session_management.nsm" title="4.5.1. NSM">NSM</a> support of Hydrogen which gives you many additional features, like restoring all <abbr class="abbrev">JACK</abbr> connections or creating a per-session configuration.
</p></td></tr></table></div><p>
</p></li><li class="listitem"><p>
<span class="bold"><strong>Beat counter drift compensation in 1/10 ms</strong></span>:
allows you to compensate for system latency. The provided number will be added to each consecutive triggering of the <a class="link" href="#sect.main_toolbar.tap_tempo_beat_counter.beat_counter" title="7.2.2. Beat Counter">Beat Counter</a>. The allowed range is from <code class="option">-200</code> to <code class="option">200</code>.
</p><div class="tip" style="margin-left: 5%;"><table border="0" summary="Tip"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Tip]" src="img/admonitions/tip.svg"></td><th align="left">Tip</th></tr><tr><td align="left" valign="top"><p>
This is quite handy if you are using different sound cards or external <abbr class="abbrev">MIDI</abbr> devices, like a keyboard or an e-drum, with mismatching clocks.
</p><p>
In order to find useful values for these, you will need to take some
time to play with it. Also, you may want different values depending on
the speed of your hardware, audio devices, drivers, etc. Using the
Beat Counter effectively requires practice.
</p></td></tr></table></div><p>
</p></li><li class="listitem"><p>
<span class="bold"><strong>Beat counter start offset in ms</strong></span>:
sets the time between the
Beat Counter's last input stroke and when the song starts playing. Its allowed range is from <code class="option">-500</code> to <code class="option">500</code>.
</p><div class="note" style="margin-left: 5%;"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="img/admonitions/note.svg"></td><th align="left">Note</th></tr><tr><td align="left" valign="top"><p>
The Beat Counter has to be set to <span class="bold"><strong>Set <abbr class="abbrev">BPM</abbr> and play</strong></span> -
<span class="inlinemediaobject"><img src="img/btn_set_play_on.png" alt='Blue button containing a "P".'></span>
should be displayed in the bottom right corner - for this setting to take effect.
</p></td></tr></table></div><p>
</p></li><li class="listitem"><p>
<span class="bold"><strong>Maximum number of bars</strong></span>:
sets the maximum number of supported bars/patterns for a single song. Its allowed range is from <code class="option">1</code> to <code class="option">800</code>.
</p></li><li class="listitem"><p>
<span class="bold"><strong>Maximum number of layers</strong></span>:
sets the maximum number of <a class="link" href="#def.layer" title="Layer">layers</a> for a single instrument. Its allowed range is from <code class="option">16</code> to <code class="option">8192</code>.
</p><div class="note" style="margin-left: 5%;"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="img/admonitions/note.svg"></td><th align="left">Note</th></tr><tr><td align="left" valign="top"><p>
For this setting to take effect you have to restart Hydrogen.
</p></td></tr></table></div><p>
</p></li><li class="listitem"><p>
<span class="bold"><strong>Path to the Rubberband command-line utility</strong></span>:
sets the absolute path to the <span class="command"><strong>rubberband</strong></span> command line interface (CLI) Hydrogen will use for stretching samples in the <a class="link" href="#chpt.sample_editor.pitch" title="12.2. Pitch Shifting">Sample Editor</a>.
</p><div class="note" style="margin-left: 5%;"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="img/admonitions/note.svg"></td><th align="left">Note</th></tr><tr><td align="left" valign="top"><p>
This option is only available if your version of Hydrogen does <span class="emphasis"><em>not</em></span> already has Rubber Band support compiled into it. If it does and the option is hot shown, everything is already configured and you don't have to worry about Rubber Band at all.
</p></td></tr></table></div><p>
</p><div class="tip" style="margin-left: 5%;"><table border="0" summary="Tip"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Tip]" src="img/admonitions/tip.svg"></td><th align="left">Tip</th></tr><tr><td align="left" valign="top"><p>
If you are using Ubuntu, you can install Rubber Band from the Software Center
via the package <code class="option">rubberband-cli</code>. For other Linux distros please check your package manager and for other platforms
please check <a class="ulink" href="http://breakfastquay.com/rubberband/" target="_top">the Rubber Band site
</a>.
</p></td></tr></table></div><p>
</p><div class="tip" style="margin-left: 5%;"><table border="0" summary="Tip"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Tip]" src="img/admonitions/tip.svg"></td><th align="left">Tip</th></tr><tr><td align="left" valign="top"><p>
If Rubber Band is installed and configured correctly, you will see an extra button
<span class="inlinemediaobject"><img src="img/rubber_off.png" alt='Grey vertical button containing the characters "R", "U", and "B" in adjacent lines.'></span>
button in the <a class="link" href="#sect.main_toolbar.bpm_control_and_metronome" title="7.3. BPM Control and Metronome">Main Toolbar</a>. You can use this behavior to verify your configuration.
</p></td></tr></table></div><p>
</p></li></ul></div></div><div class="sect1"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="chpt.preferences.audio_tab"></a>5.2. Audio System</h2></div></div></div><div class="figure"><a name="fig.preferences.audio_tab"></a><p class="title"><b>Figure 5.2. The Audio System Tab</b></p><div class="figure-contents"><div class="mediaobject"><img src="generated_en/PreferencesAudioSystem_V3.png" alt="The Audio System Tab"></div></div></div><br class="figure-break"><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>
<span class="bold"><strong>Audio System</strong></span>: let's you choose the audio driver used by Hydrogen to connect to your computer's sound card.
</p><p>
Available options:
</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: circle; "><li class="listitem"><p><code class="option">Auto</code>: Hydrogen will try a
number of different drivers in a predetermined order, choose the
first working one, and display the result.
</p><div class="tip" style="margin-left: 5%;"><table border="0" summary="Tip"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Tip]" src="img/admonitions/tip.svg"></td><th align="left">Tip</th></tr><tr><td align="left" valign="top"><p>
This option is recommended for beginners.
</p></td></tr></table></div><p>
</p></li><li class="listitem"><p><a name="sect.preferences.jack"></a><code class="option">JACK</code>: The <abbr class="abbrev">JACK</abbr> driver is a
professional audio server which permits very low lag and exchanges
with other audio software. The <abbr class="abbrev">JACK</abbr>
server will start automatically if not already running.
</p><div class="tip" style="margin-left: 5%;"><table border="0" summary="Tip"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Tip]" src="img/admonitions/tip.svg"></td><th align="left">Tip</th></tr><tr><td align="left" valign="top"><p>
We strongly recommend using
this driver to have the best out of Hydrogen.
</p></td></tr></table></div></li><li class="listitem"><p><code class="option">ALSA</code>: The widely adopted
Linux standard audio driver.</p></li><li class="listitem"><p><code class="option">OSS</code>: The <abbr class="abbrev">OSS</abbr> audio driver
uses <code class="filename">/dev/dsp</code> and it's based on the <abbr class="abbrev">OSS</abbr> interface which is supported
by the vast majority of sound cards available for Linux; this said,
the use of this audio driver blocks <code class="filename">/dev/dsp</code> until Hydrogen is
closed i.e. unusable by any other software. Use it as last
resort.
</p></li><li class="listitem"><p><code class="option">PortAudio</code>: An open-source
multi platform audio driver.</p></li><li class="listitem"><p><code class="option">CoreAudio</code>: A driver for MacOS.</p></li><li class="listitem"><p><code class="option">PulseAudio</code>: A driver for the cross platform
PulseAudio sound server.</p></li></ul></div></li><li class="listitem"><p>
<span class="bold"><strong>Device</strong></span>:
specifies the particular sound card the audio driver will use.
</p></li><li class="listitem"><p>
<span class="bold"><strong>Buffer size</strong></span>:
specifies the size of the batch of time Hydrogen will process in one run. Supported values are from <code class="option">100</code> to <code class="option">5000</code>.
</p></li><li class="listitem"><p>
<span class="bold"><strong>Sample rate</strong></span>:
specifies the number of data points the audio signal will contain within one second.
</p><div class="note" style="margin-left: 5%;"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="img/admonitions/note.svg"></td><th align="left">Note</th></tr><tr><td align="left" valign="top"><p>
If you are using the <abbr class="abbrev">JACK</abbr> audio driver, the sample rate can not be altered from within Hydrogen and the audio driver
configuration should happen before starting the <abbr class="abbrev">JACK</abbr> server.
</p></td></tr></table></div><p>
</p></li><li class="listitem"><p><a name="sect.preferences.jack.track_output"></a><span class="bold"><strong>Track output</strong></span>: determines which audio settings will be applied to the outgoing
audio of the per-instrument <abbr class="abbrev">JACK</abbr> output ports.</p><p><code class="option">Post-Fader</code>:</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: circle; "><li class="listitem"><p>note <a class="link" href="#chpt.pattern_editor.note_properties.velocity">velocity</a> and <a class="link" href="#chpt.pattern_editor.note_properties.pan">pan</a></p></li><li class="listitem"><p><a class="link" href="#chpt.instrument_editor.layers.controls.layer_gain">layer gain</a></p></li><li class="listitem"><p>component <a class="link" href="#chpt.instrument_editor.layers.controls.component_volume">gain</a> and <a class="link" href="#chpt.mixer.component_strips.fader_and_lcd">volume</a></p></li><li class="listitem"><p>instrument <a class="link" href="#chpt.instrument_editor.gain_and_mute_group" title="11.1.2. Gain and Mute Group">gain</a>, <a class="link" href="#chpt.mixer.channel_strips.pan">pan</a>, and <a class="link" href="#chpt.mixer.channel_strips.fader_and_lcd">volume</a></p></li></ul></div><p><code class="option">Pre-Fader</code>:</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: circle; "><li class="listitem"><p>note <a class="link" href="#chpt.pattern_editor.note_properties.velocity">velocity</a></p></li><li class="listitem"><p><a class="link" href="#chpt.instrument_editor.layers.controls.layer_gain">layer gain</a></p></li></ul></div><div class="note" style="margin-left: 5%;"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="img/admonitions/note.svg"></td><th align="left">Note</th></tr><tr><td align="left" valign="top"><p>
This option is only available if the <abbr class="abbrev">JACK</abbr> audio driver was selected and it will only take effect if the <span class="bold"><strong>Connect to default <abbr class="abbrev">JACK</abbr> output ports</strong></span> option is checked.
</p></td></tr></table></div></li><li class="listitem"><p><a name="sect.preferences.jack.bbt"></a><span class="bold"><strong>BBT sync method</strong></span>: if
Hydrogen uses <abbr class="abbrev">JACK</abbr> transport in the presence of an external <abbr class="abbrev">JACK</abbr>
Timebase master (TBM), it will use the provided measure and
tempo information instead of the local one of either the <a class="link" href="#sect.main_toolbar.bpm_control_and_metronome" title="7.3. BPM Control and Metronome">song's
tempo</a> or the Tempo Markers
added to the <a class="link" href="#chpt.song_editor.timeline" title="8.4. Timeline">Timeline</a>. But due to
limitations in the current implementation, Hydrogen can not set
both measure and speed provided by <abbr class="abbrev">JACK</abbr> for arbitrary pattern
combinations. You have two options here. Either drop all measure
changes in the TBM and work with tempo changes only to support
arbitrary patterns (using option <code class="option">constant
measure</code>) or to keep the length of each pattern
consistent with the corresponding measure in the TBM and to use
both tempo and measure provided by <abbr class="abbrev">JACK</abbr> (option
<code class="option">matching bars</code>).</p><div class="note" style="margin-left: 5%;"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="img/admonitions/note.svg"></td><th align="left">Note</th></tr><tr><td align="left" valign="top"><p>
This option is only available if the <abbr class="abbrev">JACK</abbr> audio driver was selected.
</p><p>
For this option to take effect the
<span class="inlinemediaobject"><img src="img/btn_jack_transport_off.png" alt='Grey button containing the text "J.TRANS".'></span>
button has to be activated and the
<span class="inlinemediaobject"><img src="img/btn_jack_master_off.png" alt='Grey button containing the text "J.MASTER".'></span>
button deactivated in the <a class="link" href="#sect.main_toolbar.jack_control" title="7.5. JACK Control">Main Toolbar</a> (next to
having a <abbr class="abbrev">JACK</abbr> TBM application).</p></td></tr></table></div><div class="tip" style="margin-left: 5%;"><table border="0" summary="Tip"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Tip]" src="img/admonitions/tip.svg"></td><th align="left">Tip</th></tr><tr><td align="left" valign="top"><p>
Hydrogen can be registered as <abbr class="abbrev">JACK</abbr> Timebase Master via the <a class="link" href="#sect.main_toolbar.jack_control" title="7.5. JACK Control">Main Toolbar</a>.
</p></td></tr></table></div></li><li class="listitem"><p><span class="bold"><strong>Connect to default <abbr class="abbrev">JACK</abbr> output
ports</strong></span>: connects the main stereo <abbr class="abbrev">JACK</abbr> output ports of the <a class="link" href="#chpt.mixer.master_fader_strip" title="13.4. Master Fader Strip">Master Fader Strip</a> to
the default <abbr class="abbrev">JACK</abbr> input ports of your system
(<span class="emphasis"><em>system:playback_1</em></span> and
<span class="emphasis"><em>system:playback_2</em></span>). This will be done every time Hydrogen
starts up or the <abbr class="abbrev">JACK</abbr> audio driver is restarted.</p><div class="note" style="margin-left: 5%;"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="img/admonitions/note.svg"></td><th align="left">Note</th></tr><tr><td align="left" valign="top"><p>
This option is only available if the <abbr class="abbrev">JACK</abbr> audio driver was selected.
</p></td></tr></table></div></li><li class="listitem"><p><a name="sect.preferences.jack.per_instrument_outs"></a><span class="bold"><strong>Create per-instrument
<abbr class="abbrev">JACK</abbr> output ports</strong></span>: in addition to the main stereo output
Hydrogen will register <abbr class="abbrev">JACK</abbr> output ports for every single
instrument.
</p><div class="tip" style="margin-left: 5%;"><table border="0" summary="Tip"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Tip]" src="img/admonitions/tip.svg"></td><th align="left">Tip</th></tr><tr><td align="left" valign="top"><p>
This can be useful if you want to add effects to a
single instrument with jack-rack for example.
</p></td></tr></table></div><div class="note" style="margin-left: 5%;"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="img/admonitions/note.svg"></td><th align="left">Note</th></tr><tr><td align="left" valign="top"><p>
This option is only available if the <abbr class="abbrev">JACK</abbr> audio driver was selected.
</p></td></tr></table></div><div class="warning" style="margin-left: 5%;"><table border="0" summary="Warning"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Warning]" src="img/admonitions/warning.svg"></td><th align="left">Warning</th></tr><tr><td align="left" valign="top"><p>
There are no <abbr class="abbrev">JACK</abbr> output ports for the <a class="link" href="#sect.main_toolbar.bpm_control_and_metronome" title="7.3. BPM Control and Metronome">Metronome</a> and the <a class="link" href="#chpt.song_editor.playbackTrack" title="8.6. Playback Track">Playback Track</a>. Their audio is only available via the main stereo output ports of Hydrogen.
</p></td></tr></table></div></li><li class="listitem"><p>
<span class="bold"><strong>Enable <abbr class="abbrev">JACK</abbr> timebase master support</strong></span>:
whether Hydrogen will respond to or ignore the incoming BBT (tempo and measure) information sent by the <abbr class="abbrev">JACK</abbr> server.
</p><div class="tip" style="margin-left: 5%;"><table border="0" summary="Tip"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Tip]" src="img/admonitions/tip.svg"></td><th align="left">Tip</th></tr><tr><td align="left" valign="top"><p>
Some <abbr class="abbrev">JACK</abbr> clients are not well written or have fallen into despair. As a result Hydrogen could receive nuisance signals messing up its playback. If you encounter weird jumps in the transport position and/or Hydrogen is out of sync after relocating the transport position, you might try to uncheck this option.
</p></td></tr></table></div><p>
</p><div class="note" style="margin-left: 5%;"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="img/admonitions/note.svg"></td><th align="left">Note</th></tr><tr><td align="left" valign="top"><p>
This option is only available if the <abbr class="abbrev">JACK</abbr> audio driver was selected.
</p></td></tr></table></div><p>
</p></li><li class="listitem"><p>
<span class="bold"><strong>Apply and restart output</strong></span>:
restarts the audio driver and makes all settings specified above take effect without closing and reopening the entire Preferences dialog.
</p></li><li class="listitem"><p>
<span class="bold"><strong>Polyphony</strong></span>:
specifies the maximum number of notes played simultaneously. Supported values are from <code class="option">1</code> to <code class="option">512</code>.
</p><div class="tip" style="margin-left: 5%;"><table border="0" summary="Tip"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Tip]" src="img/admonitions/tip.svg"></td><th align="left">Tip</th></tr><tr><td align="left" valign="top"><p>
Depending on your CPU Hydrogen might be overrunning your audio driver due to this parameter.
</p></td></tr></table></div><p>
</p></li><li class="listitem"><p>
<span class="bold"><strong>Metronome volume</strong></span>:
sets the volume of the <a class="link" href="#sect.main_toolbar.bpm_control_and_metronome" title="7.3. BPM Control and Metronome">Metronome</a>. Supported values are from <code class="option">1</code> to <code class="option">100</code>.
</p></li><li class="listitem"><p>
<span class="bold"><strong>Interpolate resampling</strong></span>:
specifies the type of resampling applied if a <a class="link" href="#def.sample" title="Sample">sample</a> does not use the same Sample Rate as Hydrogen.
</p></li></ul></div></div><div class="sect1"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="chpt.preferences.midi_tab"></a>5.3. MIDI System</h2></div></div></div><div class="figure"><a name="fig.preferences.midi_tab"></a><p class="title"><b>Figure 5.3. The MIDI System Tab</b></p><div class="figure-contents"><div class="mediaobject"><img src="generated_en/MidiSystem_V2.png" alt="The MIDI System Tab"></div></div></div><br class="figure-break"><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>
<span class="bold"><strong><abbr class="abbrev">MIDI</abbr> driver</strong></span>:
selects the <abbr class="abbrev">MIDI</abbr> driver Hydrogen will use to send <abbr class="abbrev">MIDI</abbr> messages.
</p></li><li class="listitem"><p>
<span class="bold"><strong>Input</strong></span>:
selects the device Hydrogen will expect <abbr class="abbrev">MIDI</abbr> messages to receive from.
</p></li><li class="listitem"><p>
<span class="bold"><strong>Output</strong></span>:
selects the device Hydrogen will send <abbr class="abbrev">MIDI</abbr> messages to.
</p></li><li class="listitem"><p>
<span class="bold"><strong>Channel</strong></span>:
specifies whether Hydrogen should listen to <abbr class="abbrev">MIDI</abbr> messages on one particular of the 16 available channels or on all of them.
</p></li><li class="listitem"><p>
<span class="bold"><strong>Ignore note-off</strong></span>:
specifies whether Hydrogen will respond to the <span class="emphasis"><em>note-off</em></span> <abbr class="abbrev">MIDI</abbr> message.
</p><div class="note" style="margin-left: 5%;"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="img/admonitions/note.svg"></td><th align="left">Note</th></tr><tr><td align="left" valign="top"><p>
This makes better use of the drumkit samples used in Hydrogen when working with certain external <abbr class="abbrev">MIDI</abbr> devices. But it may also discard <span class="emphasis"><em>Cymbal choke</em></span> messages in some e-drums.
</p></td></tr></table></div><p>
</p></li><li class="listitem"><p>
<span class="bold"><strong>Enable <abbr class="abbrev">MIDI</abbr> feedback</strong></span>:
specifies whether Hydrogen will send a message about updated values every time a certain parameter is changed. These parameters are
</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: circle; "><li class="listitem"><p>
the <a class="link" href="#chpt.mixer.master_fader_strip" title="13.4. Master Fader Strip">Master Fader Strip</a> volume and mute state
</p></li><li class="listitem"><p>
an Instrument Strip <a class="link" href="#chpt.mixer.channel_strips.pan">pan</a>, <a class="link" href="#chpt.mixer.channel_strips.fader_and_lcd">volume</a>, <a class="link" href="#chpt.mixer.channel_strips.mute">mute</a> and <a class="link" href="#chpt.mixer.channel_strips.solo">solo</a> state
</p></li><li class="listitem"><p>
whether the <a class="link" href="#sect.main_toolbar.bpm_control_and_metronome" title="7.3. BPM Control and Metronome">Metronome</a> is activated
</p></li></ul></div><p>
</p></li><li class="listitem"><p>
<span class="bold"><strong>Discard <abbr class="abbrev">MIDI</abbr> messages after action has been triggered</strong></span>:
specifies whether a <abbr class="abbrev">MIDI</abbr> note - after performing the <abbr class="abbrev">MIDI</abbr> action associated with it - should be played back or be discard.
</p></li><li class="listitem"><p>
<span class="bold"><strong>Use output note as input note</strong></span>:
specifies whether the output <abbr class="abbrev">MIDI</abbr> note of an instrument specified in the <a class="link" href="#chpt.instrument_editor.midi_out_settings" title="11.1.5. MIDI Out Settings"><abbr class="abbrev">MIDI</abbr> Out Settings</a> of the Instrument Editor should be used to map the input as well.
</p><div class="note" style="margin-left: 5%;"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="img/admonitions/note.svg"></td><th align="left">Note</th></tr><tr><td align="left" valign="top"><p>
If this option is unchecked, only the currently selected instrument will used to play back the received <abbr class="abbrev">MIDI</abbr> notes.
</p></td></tr></table></div><p>
</p></li></ul></div><p>
Using the table in the lower part of the tab you can associate <a class="link" href="#chpt.midi.actions" title="16.1. MIDI Actions"><abbr class="abbrev">MIDI</abbr> actions</a> provided by Hydrogen with incoming <abbr class="abbrev">MIDI</abbr> messages. How this is done will be explained in the <a class="xref" href="#chpt.midi.actions" title="16.1. MIDI Actions">Section 16.1</a>.
</p></div><div class="sect1"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="chpt.preferences.osc_tab"></a>5.4. OSC</h2></div></div></div><div class="figure"><a name="fig.preferences.osc_tab"></a><p class="title"><b>Figure 5.4. The OSC Tab</b></p><div class="figure-contents"><div class="mediaobject"><img src="generated_en/PreferencesOSC.png" alt="The OSC Tab"></div></div></div><br class="figure-break"><p>The <abbr class="abbrev">OSC</abbr> tab (<a class="xref" href="#fig.preferences.osc_tab" title="Figure 5.4. The OSC Tab">Figure 5.4</a>) let's
you modify all options associated with <abbr class="abbrev">OSC</abbr> (Open Sound Control) (see
chapter <a class="link" href="#chpt.osc" title="Chapter 17. OSC API">OSC API</a> for details).
</p><div class="note" style="margin-left: 5%;"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="img/admonitions/note.svg"></td><th align="left">Note</th></tr><tr><td align="left" valign="top"><p>
In order to see and access the <span class="bold"><strong>Enable OSC feedback</strong></span> and <span class="bold"><strong>Import port</strong></span> option, <span class="bold"><strong>Enable OSC support</strong></span> has to be checked first.
</p></td></tr></table></div><p>
</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p><span class="bold"><strong>Enable OSC support</strong></span>: Allows
Hydrogen to receive <abbr class="abbrev">OSC</abbr> commands send by external programs.</p></li><li class="listitem"><p><span class="bold"><strong>Enable OSC feedback</strong></span>: Hydrogen
will broadcast <abbr class="abbrev">OSC</abbr> messages to all registered clients each time does
change. A client can register to receive <abbr class="abbrev">OSC</abbr> messages by sending
a message to Hydrogen previously. The <span class="bold"><strong>state broadcast as feedback</strong></span> is
composed of the following <abbr class="abbrev">OSC</abbr> paths:
</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: circle; "><li class="listitem"><p><a class="link" href="#chpt.osc.command.master_volume_absolute">/Hydrogen/<span class="bold"><strong>MASTER_VOLUME_ABSOLUTE</strong></span></a></p></li><li class="listitem"><p><a class="link" href="#chpt.osc.command.toggle_metronome">/Hydrogen/<span class="bold"><strong>TOGGLE_METRONOME</strong></span></a></p></li><li class="listitem"><p><a class="link" href="#chpt.osc.command.mute_toggle">/Hydrogen/<span class="bold"><strong>MUTE_TOGGLE</strong></span></a></p></li><li class="listitem"><p><a class="link" href="#chpt.osc.command.strip_volume_absolute">/Hydrogen/<span class="bold"><strong>STRIP_VOLUME_ABSOLUTE/X</strong></span></a></p></li><li class="listitem"><p><a class="link" href="#chpt.osc.command.strip_volume_relative">/Hydrogen/<span class="bold"><strong>STRIP_VOLUME_RELATIVE/X</strong></span></a></p></li><li class="listitem"><p><a class="link" href="#chpt.osc.command.pan_absolute">/Hydrogen/<span class="bold"><strong>PAN_ABSOLUTE/X</strong></span></a></p></li><li class="listitem"><p><a class="link" href="#chpt.osc.command.strip_mute_toggle">/Hydrogen/<span class="bold"><strong>STRIP_MUTE_TOGGLE/X</strong></span></a></p></li><li class="listitem"><p><a class="link" href="#chpt.osc.command.strip_solo_toggle">/Hydrogen/<span class="bold"><strong>STRIP_SOLO_TOGGLE/X</strong></span></a></p></li></ul></div><p>
</p></li><li class="listitem"><p><span class="bold"><strong>Incoming port</strong></span>: Specifies the
<abbr class="abbrev">OSC</abbr> port Hydrogen will be register to. Values up to <code class="option">20000</code> are supported.</p></li></ul></div><p>
</p><div class="note" style="margin-left: 5%;"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="img/admonitions/note.svg"></td><th align="left">Note</th></tr><tr><td align="left" valign="top"><p>If the chosen <abbr class="abbrev">OSC</abbr> port is already occupied, Hydrogen will pick
an alternative one on startup and displays it via a popup as well as
in the <abbr class="abbrev">OSC</abbr> tab of the Preferences.
</p></td></tr></table></div></div><div class="sect1"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="chpt.preferences.appearance_tab"></a>5.5. Appearance</h2></div></div></div><div class="figure"><a name="fig.preferences.appearance_tab"></a><p class="title"><b>Figure 5.5. The Appearance Tab</b></p><div class="figure-contents"><div class="mediaobject"><img src="generated_en/PreferencesAppearance_V2.png" alt="The Appearance Tab"></div></div></div><br class="figure-break"><p>The Appearance tab let's you modify Hydrogen's look
and feel.
</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>
<span class="bold"><strong>Application font</strong></span>:
specifies both the font family and point size of the application font used for the grid in <a class="link" href="#chpt.pattern_editor" title="Chapter 9. Pattern Editor">Pattern Editor</a> and <a class="link" href="#chpt.song_editor" title="Chapter 8. Song Editor">Song Editor</a> as well as for the pattern names in the <a class="link" href="#chpt.song_editor.sidebar" title="8.3. Sidebar">Sidebar</a> of the Song Editor.
</p><div class="note" style="margin-left: 5%;"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="img/admonitions/note.svg"></td><th align="left">Note</th></tr><tr><td align="left" valign="top"><p>
In order for this setting to take effect, Hydrogen has to be restarted.
</p></td></tr></table></div><p>
</p></li><li class="listitem"><p>
<span class="bold"><strong>Style</strong></span>:
specifies a certain look of GUI elements like menus, scrollbars, and dialog windows.
</p><div class="tip" style="margin-left: 5%;"><table border="0" summary="Tip"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Tip]" src="img/admonitions/tip.svg"></td><th align="left">Tip</th></tr><tr><td align="left" valign="top"><p>
Using this option you might can make Hydrogen integrate with you operating system better.
</p></td></tr></table></div><p>
</p></li><li class="listitem"><p>
<span class="bold"><strong>Mixer font</strong></span>:
specifies both the font family and point size of the mixer font used for the instrument names in the <a class="link" href="#chpt.mixer.channel_strips" title="13.1. Instrument Channel Strips">Instrument Channel Strips</a> and the component names in the <a class="link" href="#chpt.mixer.component_strips" title="13.2. Component Channel Strips">Component Channel Strips</a>.
</p><div class="note" style="margin-left: 5%;"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="img/admonitions/note.svg"></td><th align="left">Note</th></tr><tr><td align="left" valign="top"><p>
In order for this setting to take effect, Hydrogen has to be restarted.
</p></td></tr></table></div><p>
</p></li><li class="listitem"><p>
<span class="bold"><strong>Meters falloff speed</strong></span>:
specifies for how fast the update of the maximum value of the audio signal will be shown in the LCD displays of the <a class="link" href="#chpt.mixer.channel_strips" title="13.1. Instrument Channel Strips">Instrument Channel Strips</a>, <a class="link" href="#chpt.mixer.component_strips" title="13.2. Component Channel Strips">Component Channel Strips</a>, and the <a class="link" href="#chpt.mixer.master_fader_strip" title="13.4. Master Fader Strip">Master Fader Strip</a> before its replacement with a more recent value will take place.
</p></li><li class="listitem"><p>
<span class="bold"><strong>Default interface layout</strong></span>:
specifies whether the GUI of Hydrogen will be arranged in Single Pane mode or Tabbed mode (see <a class="link" href="#chpt.overview.gui" title="4.1. Main User Interface">Main User Interface</a> for details).
</p><div class="note" style="margin-left: 5%;"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="img/admonitions/note.svg"></td><th align="left">Note</th></tr><tr><td align="left" valign="top"><p>
In order for this setting to take effect, Hydrogen has to be restarted.
</p></td></tr></table></div><p>
</p></li><li class="listitem"><p>
<span class="bold"><strong>High-resolution display scaling</strong></span>:
specifies whether the underlying bitmap graphics of the GUI should be scaled to larger sizes by Qt in order for Hydrogen to look nice with your system's resolution settings.
</p></li><li class="listitem"><p>
<span class="bold"><strong>Coloring method for Song Editor elements</strong></span>:
determines the coloring of the boxes indicating the presence of a pattern in the <a class="link" href="#chpt.song_editor" title="Chapter 8. Song Editor">Song editor</a>. The available options are:
</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: circle; "><li class="listitem"><p>
<code class="option">Automatic</code>:
Uses as much colors as there are patterns in the song.
</p></li><li class="listitem"><p>
<code class="option">Steps</code>:
Uses a certain number <em class="parameter"><code>n</code></em> of colors you have to enter via a second input widget. After coloring the first <em class="parameter"><code>n</code></em> patterns with different colors the same set of colors will be used for the next <em class="parameter"><code>n</code></em> patterns and so on.
</p></li><li class="listitem"><p>
<code class="option">Fixed</code>:
Colors all patterns using a single color determined via its hue in a separate input widget.
</p></li></ul></div><p>
</p></li></ul></div></div></div><div class="chapter"><div class="titlepage"><div><div><h2 class="title"><a name="chpt.main_menu"></a>Chapter 6. Main Menu</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl class="toc"><dt><span class="sect1"><a href="#sect.main_menu.projects">6.1. Project</a></span></dt><dt><span class="sect1"><a href="#sect.main_menu.undo">6.2. Undo</a></span></dt><dt><span class="sect1"><a href="#sect.main_menu.drumkits">6.3. Drumkits</a></span></dt><dt><span class="sect1"><a href="#sect.main_menu.instruments">6.4. Instruments</a></span></dt><dt><span class="sect1"><a href="#sect.main_menu.view">6.5. View</a></span></dt><dt><span class="sect1"><a href="#sect.main_menu.options">6.6. Options</a></span></dt><dt><span class="sect1"><a href="#sect.main_menu.debug">6.7. Debug</a></span></dt><dt><span class="sect1"><a href="#sect.main_menu.info">6.8. Info</a></span></dt></dl></div><div class="figure"><a name="fig.main_menu"></a><p class="title"><b>Figure 6.1. The Main Menu</b></p><div class="figure-contents"><div class="mediaobject"><img src="img/MainMenu.png" alt="The Main Menu"></div></div></div><br class="figure-break"><div class="sect1"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="sect.main_menu.projects"></a>6.1. Project</h2></div></div></div><p>This menu offers file
related functions.</p><div class="note" style="margin-left: 5%;"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="img/admonitions/note.svg"></td><th align="left">Note</th></tr><tr><td align="left" valign="top"><p>
If you are using Hydrogen within a <abbr class="abbrev">NSM</abbr> session, some of the options below will be called and behave differently (see <a class="xref" href="#chpt.overview.session_management.nsm" title="4.5.1. NSM">Section 4.5.1</a> for details).
</p></td></tr></table></div><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p><a name="sect.main_menu.projects.new"></a><span class="bold"><strong>New</strong></span>: creates a new and empty song.</p></li><li class="listitem"><p><span class="bold"><strong>Show Info</strong></span>: sets general properties of the
song such as name, author, license, and generic notes.</p></li><li class="listitem"><p><a name="sect.main_menu.projects.open"></a><span class="bold"><strong>Open</strong></span>: opens an existing song (a <a class="link" href="#chpt.file_types.h2song">.h2song</a> file).</p></li><li class="listitem"><p><a name="sect.main_menu.projects.open_demo"></a><span class="bold"><strong>Open Demo</strong></span>: opens one of the demo song shipped with Hydrogen.
</p><div class="note" style="margin-left: 5%;"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="img/admonitions/note.svg"></td><th align="left">Note</th></tr><tr><td align="left" valign="top"><p>
The demo songs are stored in <code class="filename">$INSTALL_PATH/share/hydrogen/data/demo_songs</code>).
</p></td></tr></table></div><p>
</p></li><li class="listitem"><p><a name="sect.main_menu.projects.open_recent"></a><span class="bold"><strong>Open recent</strong></span>: opens a menu showing the last used songs (ordered from most recent to least recent).</p></li><li class="listitem"><p><span class="bold"><strong>Save</strong></span>: saves changes to current song.</p></li><li class="listitem"><p><a name="sect.main_menu.projects.save_as"></a><span class="bold"><strong>Save as</strong></span>: saves current song as <a class="link" href="#chpt.file_types.h2song">.h2song</a> file to a path of your choice.
</p><div class="tip" style="margin-left: 5%;"><table border="0" summary="Tip"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Tip]" src="img/admonitions/tip.svg"></td><th align="left">Tip</th></tr><tr><td align="left" valign="top"><p>
In order for Hydrogen to automatically list it in the <a class="link" href="#sect.sl.songs" title="10.2. Songs">Songs section of the Sound Library</a>, you have to store it in
<code class="filename">$HOME/.hydrogen/data/songs/</code>.
</p></td></tr></table></div><p>
</p></li><li class="listitem"><p><span class="bold"><strong>Open pattern</strong></span>: opens a pattern (a <a class="link" href="#chpt.file_types.h2pattern">.h2pattern</a> file)
belonging to the current drumkit.</p></li><li class="listitem"><p><a name="sect.main_menu.projects.export_pattern_as"></a><span class="bold"><strong>Export Pattern As</strong></span>: saves a
pattern as a <a class="link" href="#chpt.file_types.h2pattern">.h2pattern</a> file.
</p><div class="tip" style="margin-left: 5%;"><table border="0" summary="Tip"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Tip]" src="img/admonitions/tip.svg"></td><th align="left">Tip</th></tr><tr><td align="left" valign="top"><p>
In order for Hydrogen to automatically list it in the <a class="link" href="#sect.sl.patterns" title="10.3. Patterns">Patterns section of the Sound Library</a>, you have to store it in
<code class="filename">$HOME/.hydrogen/data/patterns/drumkit_name/</code>.
</p></td></tr></table></div><p>
</p></li><li class="listitem"><p><span class="bold"><strong>Export MIDI file</strong></span>: exports the current song in
<abbr class="abbrev">MIDI</abbr> format.</p></li><li class="listitem"><p><a name="sect.main_form.export_song"></a><span class="bold"><strong>Export song</strong></span>: exports the current song into an audio file.</p><p>The <span class="bold"><strong>Export mode</strong></span> option <code class="option">Export to a single track</code> will export one stereo downmix of your song - the master output. <code class="option">Export to separate tracks</code> will create files for each
instrument/track. <code class="option">Both</code> will create a stereo downmix + audio files for all individual
instruments.
</p></li><li class="listitem"><p><span class="bold"><strong>Export Lilypond file</strong></span>: exports the current song to LilyPond.</p><div class="warning" style="margin-left: 5%;"><table border="0" summary="Warning"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Warning]" src="img/admonitions/warning.svg"></td><th align="left">Warning</th></tr><tr><td align="left" valign="top"><p>
It has the following limitations: Only the <span class="emphasis"><em>GMRockKit</em></span> and no triplets are supported.</p></td></tr></table></div></li><li class="listitem"><p><span class="bold"><strong>Quit</strong></span>: exists Hydrogen.</p></li></ul></div></div><div class="sect1"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="sect.main_menu.undo"></a>6.2. Undo</h2></div></div></div><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p><span class="bold"><strong>Undo</strong></span>: lets you undo your last action.</p></li><li class="listitem"><p><span class="bold"><strong>Redo</strong></span>: lets you redo the last undone action.</p></li><li class="listitem"><p><span class="bold"><strong>Undo History</strong></span>: gives you an overview of your previous
actions.</p></li></ul></div></div><div class="sect1"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="sect.main_menu.drumkits"></a>6.3. Drumkits</h2></div></div></div><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p><a name="sect.main_menu.drumkits.new"></a><span class="bold"><strong>New</strong></span>: creates a new and empty <a class="link" href="#chpt.overview.drumkits" title="4.2. Drumkit Concept">drumkit</a> by clearing all the instruments of the current one.
</p></li><li class="listitem"><p><a name="sect.main_menu.drumkits.open"></a>
<span class="bold"><strong>Open</strong></span>:
opens one of the registered drumkits and replaces the currently loaded one.
</p><div class="note" style="margin-left: 5%;"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="img/admonitions/note.svg"></td><th align="left">Note</th></tr><tr><td align="left" valign="top"><p>
Via this option you can only load drumkits that have been already imported into Hydrogen. If you just received a new one from an external source, be sure to use the <a class="link" href="#sect.main_form.import_drumkit">Import</a> option described below.
</p></td></tr></table></div><p>
</p></li><li class="listitem"><p>
<span class="bold"><strong>Properties</strong></span>:
sets general properties of the drumkit such as its name, author, license, general information, image, and image license.
</p></li><li class="listitem"><p><span class="bold"><strong>Save</strong></span>: saves all settings of the current drumkit (including those of their instruments and sound samples).
</p></li><li class="listitem"><p><a name="sect.main_menu.drumkits.save_as"></a><span class="bold"><strong>Save As</strong></span>: saves all settings of the current drumkit (including those of their instruments and sound samples) as new drumkit.
</p><div class="note" style="margin-left: 5%;"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="img/admonitions/note.svg"></td><th align="left">Note</th></tr><tr><td align="left" valign="top"><p>
The new drumkit will be a physical copy of the old one and is stored into the <code class="filename">$HOME/.hydrogen/data/drumkits/</code> folder.
</p></td></tr></table></div><p>
</p></li><li class="listitem"><p><a name="sect.main_form.export_drumkit"></a><span class="bold"><strong>Export</strong></span>: compress and stores all instruments samples and settings of any drumkit (not just the current one) into a folder of your choice as <a class="link" href="#chpt.file_types.h2drumkit">.h2drumkit</a> file.
</p><div class="note" style="margin-left: 5%;"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="img/admonitions/note.svg"></td><th align="left">Note</th></tr><tr><td align="left" valign="top"><p>
For compatibility reasons you can also export your drumkit in a format used in older versions ( <= 0.9.6 ) of Hydrogen. By doing so you need to select a single <a class="link" href="#def.component" title="Component">component</a> to export since this functionality was not supported back than.
</p></td></tr></table></div><p>
</p></li><li class="listitem"><p><a name="sect.main_form.import_drumkit"></a><span class="bold"><strong>Import</strong></span>: imports a drumkit (a <a class="link" href="#chpt.file_types.h2drumkit">.h2drumkit</a> file) from the local filesystem.
</p></li><li class="listitem"><p><a name="sect.main_form.online_import_drumkit"></a><span class="bold"><strong>Online Import</strong></span>: imports another drumkit from a remote location
through a <abbr class="abbrev">XML</abbr> feed. The <abbr class="abbrev">XML</abbr> file that should be provided is <span class="bold"><strong>NOT</strong></span> <abbr class="abbrev">RSS</abbr> compliant (see <a class="ulink" href="http://www.hydrogen-music.org/feeds/drumkit_list.php" target="_top">Hydrogen
website</a> for an example).
</p><p>
</p><div class="figure"><a name="fig.import_drumkit"></a><p class="title"><b>Figure 6.2. Import Drumkit</b></p><div class="figure-contents"><div class="mediaobject"><img src="generated_en/Sound_Library_import.png" alt="Import Drumkit"></div></div></div><p><br class="figure-break">
The Import window will pop up with the Internet tab selected.
By default the link to the drumkit list (on hydrogen-music.org) will be filled in,
and after pressing the <span class="bold"><strong>Update list</strong></span> button you will get a complete list of all
drumkits that are available for download. In the status column you can see
if a kit is installed or not.
</p><p>
If you select one of the drumkits you will see info about this kit in the right
pane of the Import window: name, description, author and also the
license type.
</p><p>
You can install a drumkit by selecting it and clicking <span class="bold"><strong>Download and Install</strong></span>.
</p><div class="informalfigure"><a name="fig.downloading_soundlibrary"></a><div class="mediaobject"><img src="img/Downloading_SoundLibrary.png" alt="Widget with progress bar popping up during the download of a drumit."></div></div><p>
Once the kit has been downloaded it will be available in the <a class="link" href="#chpt.sound_library.drumkits" title="10.1. Drumkits">Sound Library</a> under <span class="emphasis"><em>User drumkits</em></span>.
</p></li></ul></div></div><div class="sect1"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="sect.main_menu.instruments"></a>6.4. Instruments</h2></div></div></div><p>This menu offers
instruments functions.</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p><span class="bold"><strong>Add Instrument</strong></span>: adds a new instrument to the current drumkit.</p></li><li class="listitem"><p><span class="bold"><strong>Clear All</strong></span>: deletes all instruments from the current drumkit.</p></li><li class="listitem"><p><span class="bold"><strong>Add Component</strong></span>: adds a <a class="link" href="#def.component" title="Component">component</a> to the current drumkit.</p></li></ul></div></div><div class="sect1"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="sect.main_menu.view"></a>6.5. View</h2></div></div></div><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p><span class="bold"><strong>Playlist Editor</strong></span>: opens the <a class="link" href="#chpt.playlist_editor" title="Chapter 15. Playlist Editor">Playlist Editor</a> window.</p></li><li class="listitem"><p><span class="bold"><strong>Director</strong></span>: opens the <a class="link" href="#chpt.director" title="Chapter 14. Director">Director</a> window.</p></li><li class="listitem"><p><span class="bold"><strong>Mixer</strong></span>: opens the <a class="link" href="#chpt.mixer" title="Chapter 13. Mixer">Mixer</a> window.</p></li><li class="listitem"><p><span class="bold"><strong>Instrument Rack</strong></span>: shows or hides the widget of the main window containing both the <a class="link" href="#chpt.instrument_editor" title="Chapter 11. Instrument Editor">Instrument Editor</a> and the <a class="link" href="#chpt.sound_library" title="Chapter 10. Sound Library (Drumkit/Pattern/Song Manager)">Sound Library</a>.</p></li><li class="listitem"><p><span class="bold"><strong>Automation Path</strong></span>: shows or hides the <a class="link" href="#sect.song_editor.automation_path" title="8.7. Automation Path">Automation Path</a>
panel.</p></li><li class="listitem"><p><span class="bold"><strong>Timeline</strong></span>: shows or hides the <a class="link" href="#chpt.song_editor.timeline" title="8.4. Timeline">Timeline</a> panel.</p></li><li class="listitem"><p><span class="bold"><strong>Playback Track</strong></span>: shows or hides the <a class="link" href="#chpt.song_editor.playbackTrack" title="8.6. Playback Track">Playback Track</a> panel.</p></li><li class="listitem"><p><span class="bold"><strong>Full screen</strong></span>: maximises the window size to the whole screen area.</p></li></ul></div></div><div class="sect1"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="sect.main_menu.options"></a>6.6. Options</h2></div></div></div><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p><a name="sect.main_menu.options.input_mode"></a><span class="bold"><strong>Input mode</strong></span>: when set to <code class="option">Drumkit</code> the keys on your <abbr class="abbrev">MIDI</abbr> keyboard will map to the instruments
in your drumkit. If you set it to <code class="option">Instrument</code> the keys of your <abbr class="abbrev">MIDI</abbr>
keyboard will trigger the instrument that is currently selected.
The pitch of the instrument will follow the key you press on your keyboard.
This feature is mainly used for non-drum instruments (see <a class="xref" href="#chpt.overview.midi_mapping_and_virtual_keyboard" title="4.3. MIDI-mapping and Virtual Keyboard">Section 4.3</a> for details).
An example: if you use a sample of a piano for one of your instruments, you will be able to 'play'
that piano instrument using your keyboard just like you are playing a piano synth.</p></li><li class="listitem"><p><span class="bold"><strong>Preferences</strong></span>: opens the main preferences
window (see <a class="xref" href="#chpt.preferences" title="Chapter 5. Preferences">Preferences</a> for details).</p></li></ul></div></div><div class="sect1"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="sect.main_menu.debug"></a>6.7. Debug</h2></div></div></div><p>Tools mainly for debugging
and monitoring Hydrogen.</p><div class="note" style="margin-left: 5%;"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="img/admonitions/note.svg"></td><th align="left">Note</th></tr><tr><td align="left" valign="top"><p>
The Debug option is only available if Hydrogen was compiled with
debug support.
</p></td></tr></table></div><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p><a name="chpt.preferences.audio_engine_tab"></a><span class="bold"><strong>Show Audio Engine Info</strong></span>: opens a window that shows
various stats about Hydrogen and the audio driver.
</p><div class="figure"><a name="fig.preferences.audio_engine_tab"></a><p class="title"><b>Figure 6.3. The Audio Engine View</b></p><div class="figure-contents"><div class="mediaobject"><img src="generated_en/AudioEngineInfoDialog.png" alt="The Audio Engine View"></div></div></div><p><br class="figure-break">
</p><div class="note" style="margin-left: 5%;"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="img/admonitions/note.svg"></td><th align="left">Note</th></tr><tr><td align="left" valign="top"><p>
In case <abbr class="abbrev">JACK</abbr> is used,
buffer and sampling rate should be set in the configuration of the <abbr class="abbrev">JACK</abbr>
server before starting Hydrogen (<abbr class="abbrev">JACK</abbr> automatically starts when an
application tries to connect).
</p></td></tr></table></div><p>
</p></li><li class="listitem"><p><a name="chpt.main_menu.debug.show_filesystem_info"></a><span class="bold"><strong>Show Filesystem Info</strong></span>:
opens a window that shows you the paths to the user and system data directory as well as to the folder used to create temporary files.
</p></li><li class="listitem"><p>
<span class="bold"><strong>Log Level</strong></span>:
specifies which log messages will be written into the log file.
</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: circle; "><li class="listitem"><p>
<code class="option">None</code>: No messages will be written at all.
</p></li><li class="listitem"><p>
<code class="option">Error</code>: Only messages concerning critical errors will be written out.
</p></li><li class="listitem"><p>
<code class="option">Warning</code>: Like <code class="option">Error</code> but in addition also general warnings about potential bugs or inconsistencies will be written out.
</p></li><li class="listitem"><p>
<code class="option">Info</code>: Like <code class="option">Warning</code> but also all info messages indicating the correct behavior of Hydrogen will be written out.
</p></li><li class="listitem"><p>
<code class="option">Debug</code>: Like <code class="option">Info</code> but also internal help messages used for developing will be written out.
</p></li></ul></div><p>
</p></li><li class="listitem"><p><span class="bold"><strong>Open Log File</strong></span>:
opens Hydrogen's log in either the terminal the application was started in or in a new terminal instance.</p></li></ul></div></div><div class="sect1"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="sect.main_menu.info"></a>6.8. Info</h2></div></div></div><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p><span class="bold"><strong>User Manual</strong></span>: opens a window with a version of this manual installed on your local computer.</p></li><li class="listitem"><p><span class="bold"><strong>About</strong></span>: the usual window with license
information, acknowledgments, etc.</p></li><li class="listitem"><p><span class="bold"><strong>Report Bug</strong></span>: opens the <a class="ulink" href="https://github.com/hydrogen-music/hydrogen/issues" target="_top">Hydrogen issue page at github.com</a> in your default Internet browser.
You can open a new issue to communicate a bug here (first search if there exists already an issue about it).</p></li><li class="listitem"><p><span class="bold"><strong>Donate</strong></span>: make a donation to developers/maintainers.</p></li></ul></div></div></div><div class="chapter"><div class="titlepage"><div><div><h2 class="title"><a name="chpt.main_toolbar"></a>Chapter 7. Main Toolbar</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl class="toc"><dt><span class="sect1"><a href="#sect.main_toolbar.transport_control">7.1.
Transport Control
</a></span></dt><dt><span class="sect1"><a href="#sect.main_toolbar.tap_tempo_beat_counter">7.2. Tap Tempo and Beat Counter</a></span></dt><dd><dl><dt><span class="sect2"><a href="#sect.main_toolbar.tap_tempo_beat_counter.tap_tempo">7.2.1. Tap Tempo</a></span></dt><dt><span class="sect2"><a href="#sect.main_toolbar.tap_tempo_beat_counter.beat_counter">7.2.2. Beat Counter</a></span></dt></dl></dd><dt><span class="sect1"><a href="#sect.main_toolbar.bpm_control_and_metronome">7.3. BPM Control and Metronome</a></span></dt><dt><span class="sect1"><a href="#sect.main_toolbar.cpu_usage_midi_in">7.4. CPU Usage and MIDI in</a></span></dt><dt><span class="sect1"><a href="#sect.main_toolbar.jack_control">7.5. JACK Control</a></span></dt><dt><span class="sect1"><a href="#sect.main_toolbar.gui_state">7.6. GUI State</a></span></dt></dl></div><div class="figure"><a name="fig.main_toolbar"></a><p class="title"><b>Figure 7.1. The Main Toolbar</b></p><div class="figure-contents"><div class="mediaobject"><img src="generated_en/MainToolbar_V2.png" alt="The Main Toolbar"></div></div></div><br class="figure-break"><p>Before analyzing the two main frames of Hydrogen, let's take a quick
look at the main toolbar and its components.</p><div class="sect1"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="sect.main_toolbar.transport_control"></a>7.1.
Transport Control
</h2></div></div></div><div class="informalfigure"><a name="fig.main_toolbar.transport_control"></a><div class="mediaobject"><img src="generated_en/background_Control_V2.png" alt="Part of the Main Toolbar responsible for the transport control. From left to right: rewind, record, pause and play, stop, fast forward, and loop button."></div></div><p>Using these buttons you can <span class="bold"><strong>start</strong></span> (also bound to <span class="keycap"><strong>Space</strong></span>, see <a class="xref" href="#chap.shortcuts" title="Chapter 21. Shortcut Lists">Chapter 21</a> for further related shortcuts) and <span class="bold"><strong>stop</strong></span> the playback, <span class="bold"><strong>record</strong></span> new patterns (see <a class="xref" href="#chpt.overview.recording" title="4.4. Recording in Hydrogen">Section 4.4</a> for details), <span class="bold"><strong>fast forward</strong></span> and <span class="bold"><strong>rewind</strong></span> the transport position, and <span class="bold"><strong>loop</strong></span> playback.</p><p>In addition, you can switch between <a class="link" href="#chpt.song_editor.editor_modes.song_mode" title="8.2.3. Song Mode">Song mode</a> and <a class="link" href="#chpt.song_editor.editor_modes.pattern_mode" title="8.2.4. Pattern Mode">Pattern mode</a>.</p><div class="tip" style="margin-left: 5%;"><table border="0" summary="Tip"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Tip]" src="img/admonitions/tip.svg"></td><th align="left">Tip</th></tr><tr><td align="left" valign="top"><p>
When using the <a class="link" href="#chpt.keyboard_and_mouse" title="Chapter 3. Keyboard and Mouse">Keyboard</a> to navigate in the <a class="link" href="#chpt.song_editor" title="Chapter 8. Song Editor">Song Editor</a> and <a class="link" href="#chpt.pattern_editor" title="Chapter 9. Pattern Editor">Pattern Editor</a> the shortcut <span class="keycap"><strong>Ctrl</strong></span> + <span class="keycap"><strong>Space</strong></span> (or <span class="keycap"><strong>Alt</strong></span> + <span class="keycap"><strong>Space</strong></span> on MacOS) will change the mode to the one corresponding to the editor. In addition, it will move the current transport position to either the note (Pattern Editor) or the pattern (Song Editor) focused by the cursor and starts the playback.
</p></td></tr></table></div></div><div class="sect1"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="sect.main_toolbar.tap_tempo_beat_counter"></a>7.2. Tap Tempo and Beat Counter</h2></div></div></div><div class="informalfigure"><a name="fig.main_toolbar.beat_counter"></a><div class="mediaobject"><img src="generated_en/MeasureSettings.png" alt="Part of the Main Toolbar responsible for the tempo settings using the Beat Counter. In the center there is a LCD displaying to the left the beat type and to the right on top the current mode of the Beat Counter and the value of the Countdown Counter below. To the left and right of the LCD there are buttons to decrease or increase the beat type (left) and Countdown Counter value (right)."></div></div><p>This section covers how to interactively change tempo using the <span class="emphasis"><em>Beat Counter</em></span>. Due to conceptional similarities the <span class="emphasis"><em>Tap Tempo</em></span> will be covered as well which itself is not related to the widget displayed above.</p><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="sect.main_toolbar.tap_tempo_beat_counter.tap_tempo"></a>7.2.1. Tap Tempo</h3></div></div></div><p>The Tap Tempo allows you to change the tempo at any time - with playback rolling or stopped - within Hydrogen. To change the tempo, hit the
<span class="keycap"><strong>\</strong></span> key in the tempo you want.
</p><p>
After two keystrokes the tempo will be first changed according to the time difference between the two taps. With each addition keystroke the tempo will be changed again to the rolling average value of the last up top eight hits of the <span class="keycap"><strong>\</strong></span> button. If you tap
accidentally, or if you wait too long between taps, the Tap Tempo
counter will start over.</p><div class="note" style="margin-left: 5%;"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="img/admonitions/note.svg"></td><th align="left">Note</th></tr><tr><td align="left" valign="top"><p>
The widget shown above is the one of the Beat Counter. The Tap Tempo itself does neither have a dedicated widget nor any option to be set by the user.
</p></td></tr></table></div></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="sect.main_toolbar.tap_tempo_beat_counter.beat_counter"></a>7.2.2. Beat Counter</h3></div></div></div><p>The Beat Counter is essentially a Tap Tempo on steroids. By default the Beat Counter widget is not
visible. To see the Beat Counter widget click the
<span class="inlinemediaobject"><img src="generated_en/btn_bc_off.png" alt='Grey vertical button containing the characters "B" and "C" in adjacent rows.'></span>
button or simply press <span class="keycap"><strong>,</strong></span>.</p><p>The tempo that you tap will be considered to correspond to even beats of the song's
beat type. The beat type can be set to 1/8 (for eight-note beats), 1/4 (for
quarter-note beats), 1/2 (for half-note beats), and 1/1 (for whole-note
beats). To change the beat type use the left <span class="keycap"><strong>+</strong></span> / <span class="keycap"><strong>-</strong></span> buttons. To change
the Countdown Counter value, use the right <span class="keycap"><strong>+</strong></span> / <span class="keycap"><strong>-</strong></span> buttons. The Countdown
Counter value can be set between 2 and 16 beats. (I.e. if you set the beat to 6, you will
have to tap 6 times before the new tempo is computed and set.) When the
display shows an <em class="parameter"><code>R</code></em>, it means that the Beat Counter
is ready to start from 0. When you tap <span class="keycap"><strong>,</strong></span>, the <em class="parameter"><code>R</code></em> will change to
1, and will increment with every keystroke until it reaches the Countdown
Counter value (shown just below the <em class="parameter"><code>R</code></em>).</p><p>The button in the bottom right-hand controls the auto-start
feature, and it toggles between
<span class="inlinemediaobject"><img src="img/btn_set_play_off.png" alt='Grey button containing a "S".'></span>
and
<span class="inlinemediaobject"><img src="img/btn_set_play_on.png" alt='Blue button containing a "P".'></span>
. When it shows the latter (for <span class="emphasis"><em>Play</em></span>), the song will set the new tempo and
automatically start to play after you tap the right number of beats (if
it's not already playing, of course). This way, if you have the
Beat Counter set up for 4/4, you can tap 1-2-3-4, and start playing on
the next beat. When it shows
<span class="inlinemediaobject"><img src="img/btn_set_play_off.png" alt='Grey button containing a "S".'></span>
(for <span class="emphasis"><em>Set BPM</em></span>), the auto-start is disabled.</p><p>For example: Suppose you have a live band, Hydrogen, and a
softsynth that is controlled by <span class="command"><strong>Seq24</strong></span>)... and you want them all to start
at the same time. Set the beat type to 1/4 and the number of beats to
4. Enable auto-start (button shows
<span class="inlinemediaobject"><img src="img/btn_set_play_on.png" alt='Blue button containing a "P".'></span>
). Count off
the band 1-2-3-4 (while tapping the <span class="keycap"><strong>,</strong></span> key) and everyone
starts on 1.</p><p>Another example: Same situation, but the song doesn't require
Hydrogen or synths until some point later. During that time, a human
(e.g. guitar player) will be setting the tempo. On the measure before
Hydrogen is supposed to play, tap the comma key 1-2-3-4 with the
beat... and you're in on the next beat (at the right tempo).</p><div class="tip" style="margin-left: 5%;"><table border="0" summary="Tip"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Tip]" src="img/admonitions/tip.svg"></td><th align="left">Tip</th></tr><tr><td align="left" valign="top"><p>An temporal offset when starting the playback after setting the tempo and a latency compensation for the Beat Counter can be configured in the <a class="link" href="#chpt.preferences.general_tab" title="5.1. General">General tab</a> of the Preferences Dialog.
</p></td></tr></table></div><div class="note" style="margin-left: 5%;"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="img/admonitions/note.svg"></td><th align="left">Note</th></tr><tr><td align="left" valign="top"><p>
If you are using <abbr class="abbrev">JACK</abbr> transport in the presence of an external <a class="link" href="#sect.preferences.jack.bbt"><abbr class="abbrev">JACK</abbr> Timebase Master</a>, Hydrogen is supposed to be a <span class="emphasis"><em>slave</em></span> and both Tap Tempo and Beat Counter will be disabled. If Hydrogen itself is the <abbr class="abbrev">JACK</abbr> Transport Master, tempo changes from
Hydrogen will be broadcasted to other <abbr class="abbrev">JACK</abbr> clients.
</p></td></tr></table></div></div></div><div class="sect1"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="sect.main_toolbar.bpm_control_and_metronome"></a>7.3. BPM Control and Metronome</h2></div></div></div><div class="informalfigure"><a name="fig.main_toolbar.bpm_control_and_metronome"></a><div class="mediaobject"><img src="generated_en/background_BPM.png" alt="Part of the Main Toolbar responsible for the tempo settings. To the left there are on top two buttons for decreasing and increasing the tempo and below one to activate the metronome. To the right and covering most of the area is a LCD showing the current BPM. At the far right there is a tall button activating the recalculation of samples processed by Rubber Band at tempo changes."></div></div><p>Set the speed of the song in the range from <code class="option">10</code> to <code class="option">400</code> bpm (beats per minute).
</p><div class="tip" style="margin-left: 5%;"><table border="0" summary="Tip"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Tip]" src="img/admonitions/tip.svg"></td><th align="left">Tip</th></tr><tr><td align="left" valign="top"><p>
You can use the <span class="emphasis"><em>mouse wheel</em></span> to decrease and increase the value of this widget.
</p></td></tr></table></div><p>In addition you can use
<span class="inlinemediaobject"><img src="img/btn_metronome_off.png" alt='Grey button for toggling the metronome. It contains a non-filled black triangle pointing to the left (left), a black dot (middle), and a black closing bracket ")" (right).'></span>
to toggle the metronome.</p><div class="tip" style="margin-left: 5%;"><table border="0" summary="Tip"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Tip]" src="img/admonitions/tip.svg"></td><th align="left">Tip</th></tr><tr><td align="left" valign="top"><p>
The volume of the metronome can be adjusted in the <a class="link" href="#chpt.preferences.audio_tab" title="5.2. Audio System">Audio tab</a> of the Preferences.
</p></td></tr></table></div><p>
If either Rubber Band support is compiled into your current version of Hydrogen or correctly configured in the <a class="link" href="#chpt.preferences.general_tab" title="5.1. General">General tab</a> of the Preferences, you will also find the
<span class="inlinemediaobject"><img src="img/rubber_off.png" alt='Grey vertical button containing the characters "R", "U", and "B" in adjacent lines.'></span>
button next to the BPM widget. Activating it will enable recalculation of all sample pitches using Rubber Band whenever the tempo of the song will be changed (see <a class="xref" href="#chpt.sample_editor.pitch" title="12.2. Pitch Shifting">Section 12.2</a> for details.
</p></div><div class="sect1"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="sect.main_toolbar.cpu_usage_midi_in"></a>7.4. CPU Usage and MIDI in</h2></div></div></div><div class="informalfigure"><a name="fig.main_toolbar.cpu_usage_midi_in"></a><div class="mediaobject"><img src="generated_en/MidiIN_CPU.png" alt='A block horizontal line in the upper part will contain a meter showing the load of the CPU. Below a small LED-like symbol next to the text "MIDI-IN" will indicated when there is MIDI input.'></div></div><p>The CPU bargraph gives you an indication of the CPU load. The <abbr class="abbrev">MIDI</abbr> led lights up every time Hydrogen receives a <abbr class="abbrev">MIDI</abbr> message.</p><div class="tip" style="margin-left: 5%;"><table border="0" summary="Tip"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Tip]" src="img/admonitions/tip.svg"></td><th align="left">Tip</th></tr><tr><td align="left" valign="top"><p>
The <abbr class="abbrev">MIDI</abbr> settings can be adjusted in the <a class="link" href="#chpt.preferences.midi_tab" title="5.3. MIDI System">MIDI tab</a> of the Preferences.
</p></td></tr></table></div></div><div class="sect1"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="sect.main_toolbar.jack_control"></a>7.5. JACK Control</h2></div></div></div><div class="informalfigure"><a name="fig..main_toolbar.jack_control"></a><div class="mediaobject"><img src="generated_en/JackTrans_Master.png" alt='Part of the Main Toolbar responsible for the JACK configuration. The left button is titled "J.TRANS" and the right one "J.MASTER".'></div></div><p>Clicking
<span class="inlinemediaobject"><img src="img/btn_jack_transport_off.png" alt='Grey button containing the text "J.TRANS".'></span>
will enable <abbr class="abbrev">JACK</abbr> transport. If disabled, Hydrogen will still use the <abbr class="abbrev">JACK</abbr> driver and registered audio ports. But it decouples its own transport state from the one of the JACK server and will not be in sync with other clients anymore.
</p><p>
Using
<span class="inlinemediaobject"><img src="img/btn_jack_master_off.png" alt='Grey button containing the text "J.MASTER".'></span>
Hydrogen can be registered as <abbr class="abbrev">JACK</abbr> Timebase Master and will send additional information, like the current speed, to other <abbr class="abbrev">JACK</abbr>
clients. Else it will either act as <span class="emphasis"><em>slave</em></span> in the presence of another
Timebase Master, like <span class="command"><strong>Ardour</strong></span>, or as a stand-alone client in the
absence of a Master.
</p><div class="tip" style="margin-left: 5%;"><table border="0" summary="Tip"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Tip]" src="img/admonitions/tip.svg"></td><th align="left">Tip</th></tr><tr><td align="left" valign="top"><p>
You can check whether Hydrogen is in <span class="emphasis"><em>slave</em></span> mode by hovering over the disabled <a class="link" href="#sect.main_toolbar.tap_tempo_beat_counter.beat_counter" title="7.2.2. Beat Counter">Beat Counter</a> or <a class="link" href="#chpt.song_editor.timeline" title="8.4. Timeline">Timeline</a>.
</p></td></tr></table></div><div class="note" style="margin-left: 5%;"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="img/admonitions/note.svg"></td><th align="left">Note</th></tr><tr><td align="left" valign="top"><p>
The support of <abbr class="abbrev">JACK</abbr> Timebase can disabled in the <a class="link" href="#chpt.preferences.audio_tab" title="5.2. Audio System">Audio tab</a> of the Preferences. This can be useful in the presence of a fault Master broadcasting nuisance information.
</p></td></tr></table></div></div><div class="sect1"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="sect.main_toolbar.gui_state"></a>7.6. GUI State</h2></div></div></div><div class="informalfigure"><a name="fig.main_toolbar.gui_state"></a><div class="mediaobject"><img src="generated_en/mixer-instrrack_btn.png" alt='In the upper part there are two buttons. The smaller one to the left is titled "Mixer" and the larger one "Instrument rack". Below there is a large blue LCD showing the default message of Hydrogen after startup "Hydrogen Ready.".'></div></div><p>
Toggles the <a class="link" href="#chpt.mixer" title="Chapter 13. Mixer">Mixer</a> window and the Instrument Rack (containing both the <a class="link" href="#chpt.instrument_editor" title="Chapter 11. Instrument Editor">Instrument Editor</a> and the <a class="link" href="#chpt.sound_library" title="Chapter 10. Sound Library (Drumkit/Pattern/Song Manager)">Sound Library</a>).
</p><p>
The LCD screen below displays what Hydrogen is up to and gives an optical feedback of the parameters set in the <a class="link" href="#chpt.mixer" title="Chapter 13. Mixer">Mixer</a>.
</p></div></div><div class="chapter"><div class="titlepage"><div><div><h2 class="title"><a name="chpt.song_editor"></a>Chapter 8. Song Editor</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl class="toc"><dt><span class="sect1"><a href="#chpt.song_editor.main_controls">8.1. Main Controls</a></span></dt><dt><span class="sect1"><a href="#chpt.song_editor.editor_modes">8.2. Song Editor modes</a></span></dt><dd><dl><dt><span class="sect2"><a href="#chpt.song_editor.editor_modes.select">8.2.1. Select Mode</a></span></dt><dt><span class="sect2"><a href="#chpt.song_editor.editor_modes.draw">8.2.2. Draw Mode</a></span></dt><dt><span class="sect2"><a href="#chpt.song_editor.editor_modes.song_mode">8.2.3. Song Mode</a></span></dt><dt><span class="sect2"><a href="#chpt.song_editor.editor_modes.pattern_mode">8.2.4. Pattern Mode</a></span></dt><dt><span class="sect2"><a href="#chpt.song_editor.editor_modes.stacked">8.2.5. Stacked Mode</a></span></dt></dl></dd><dt><span class="sect1"><a href="#chpt.song_editor.sidebar">8.3. Sidebar</a></span></dt><dt><span class="sect1"><a href="#chpt.song_editor.timeline">8.4. Timeline</a></span></dt><dt><span class="sect1"><a href="#chpt.song_editor.tag">8.5. Tags</a></span></dt><dt><span class="sect1"><a href="#chpt.song_editor.playbackTrack">8.6. Playback Track</a></span></dt><dt><span class="sect1"><a href="#sect.song_editor.automation_path">8.7. Automation Path</a></span></dt></dl></div><p>
</p><div class="figure"><a name="fig.song_editor"></a><p class="title"><b>Figure 8.1. The Song Editor</b></p><div class="figure-contents"><div class="mediaobject"><img src="generated_en/EnablePlaybackTrack.png" alt="The Song Editor"></div></div></div><p><br class="figure-break">
</p><p>
The Song Editor gives an overview of the whole song
(e.g. intro, verse, bridge, chorus and so on). Each blue
colored square on this panel represents a playing pattern.
It gives you complete freedom to add/remove
patterns to the song and to move or copy any part of your
song.
</p><p>
Columns represent time periods within the song. While they're
shown as the same width in the Song Editor, the length of time
taken to play through a column is set by the length of the
pattern or patterns which are active and playing during that
time slot.
</p><p>
Multiple patterns can be active at the same time in a
column, and they will play simultaneously. This allows
instrument parts to be separated out into different patterns,
or to add ornamentation or fills on top of basic patterns
without duplicating the basics into both patterns.
</p><p>
In the case of multiple patterns of different lengths in one
column only the largest one(s) will be represented by a
square. The shorter patterns are indicated by rectangles whose
width indicate their length relative to the longest one.
</p><div class="tip" style="margin-left: 5%;"><table border="0" summary="Tip"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Tip]" src="img/admonitions/tip.svg"></td><th align="left">Tip</th></tr><tr><td align="left" valign="top"><p>
Instead of having the same color for all patterns you can set different colors schemes in the <a class="link" href="#chpt.preferences.appearance_tab" title="5.5. Appearance">Appearance tab</a> in the Preferences.
</p></td></tr></table></div><div class="informalfigure"><a name="fig.song_editor.song_ruler"></a><div class="mediaobject"><img src="img/SongRuler.png" alt='Picture of a part of the Song Ruler used for naviagation. It indicates the position of certains bars by their number - "1", "5", "9", "13", "17". All remaining bars are indicated with a vertical line - "|". In addition, light-blue colored "T"s indicate the presence of a Tag.'></div></div><p>
In addition to the transport control provided in the <a class="link" href="#sect.main_toolbar.transport_control" title="7.1. Transport Control">Main Toolbar</a> you can use the song ruler for navigation. This the area above the grid and right of the Main Controls. The position clicked will be rounded to the nearest pattern beginning and transport will be relocated there.
</p><div class="note" style="margin-left: 5%;"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="img/admonitions/note.svg"></td><th align="left">Note</th></tr><tr><td align="left" valign="top"><p>
Navigation in Hydrogen is always quantized. It is only possible to move forward / backwards or locate to whole patterns.
</p></td></tr></table></div><p>
</p><div class="tip" style="margin-left: 5%;"><table border="0" summary="Tip"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Tip]" src="img/admonitions/tip.svg"></td><th align="left">Tip</th></tr><tr><td align="left" valign="top"><p>
You can also locate the keyboard cursor (see <a class="xref" href="#chpt.keyboard_and_mouse" title="Chapter 3. Keyboard and Mouse">Chapter 3</a>) to a desired pattern and press <a class="link" href="#chap.shortcuts.ctrl_space"><span class="keycap"><strong>Ctrl</strong></span> + <span class="keycap"><strong>Space</strong></span></a> to relocate to this position.
</p></td></tr></table></div><p>
</p><div class="sect1"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="chpt.song_editor.main_controls"></a>8.1. Main Controls</h2></div></div></div><div class="informalfigure"><a name="fig.song_editor.main_controls"></a><div class="mediaobject"><img src="generated_en/bg_topPanel.png" alt='Main Controls for the Song Editor. From left to right: larger button bearing the text "CLEAR" for deleting all patterns, new pattern button, two buttons to move the selected pattern down and up, two buttons to activate the Draw and the Select mode, and the button to switch between Single Pattern and Stacked mode.'></div></div><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p><span class="inlinemediaobject"><img src="generated_en/btn_clear_off.png" alt='Grey button containing the text "CLEAR".'></span> : deletes all patterns
(asks for confirmation!).
</p></li><li class="listitem"><p><span class="inlinemediaobject"><img src="generated_en/btn_new_on.png" alt="Grey button containing a plus sign."></span> : creates a new pattern (and asks for a name).
</p></li><li class="listitem"><p><span class="inlinemediaobject"><img src="generated_en/btn_updown.png" alt="Two grey button horizontally aligned. The left contains a black arrow tip pointing downwards and the right one one pointing upwards."></span> : moves currently selected pattern
up or down.
</p><div class="tip" style="margin-left: 5%;"><table border="0" summary="Tip"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Tip]" src="img/admonitions/tip.svg"></td><th align="left">Tip</th></tr><tr><td align="left" valign="top"><p>
You can also <span class="emphasis"><em>drag-and-drop</em></span> a pattern up/down in
the pattern list.
</p></td></tr></table></div></li><li class="listitem"><p><span class="inlinemediaobject"><img src="generated_en/btn_draw.png" alt="Grey button containing a black brush."></span> : enables Select mode (<a class="xref" href="#chpt.song_editor.editor_modes.select" title="8.2.1. Select Mode">Section 8.2.1</a>).
</p></li><li class="listitem"><p><span class="inlinemediaobject"><img src="generated_en/btn_select.png" alt="Blue button containing four black horizontal dots in the lower part joined by three black vertical dots at the right bottom corner."></span> : enables Draw mode (<a class="xref" href="#chpt.song_editor.editor_modes.select" title="8.2.1. Select Mode">Section 8.2.1</a>).</p></li><li class="listitem"><p><a name="chpt.song_editor.main_controls.single_vs_stacked"></a><span class="inlinemediaobject"><img src="generated_en/btn_pattern_mode.png" alt="Grey button with a horizontal black line."></span> : sets Hydrogen to <span class="emphasis"><em>Single Pattern mode</em></span>
<span class="inlinemediaobject"><img src="generated_en/btn_stacked_mode.png" alt="Grey button with three horizontal black lines stacked vertically."></span>
or to <span class="emphasis"><em>Stacked mode</em></span> (<a class="xref" href="#chpt.song_editor.editor_modes.stacked" title="8.2.5. Stacked Mode">Section 8.2.5</a>).</p></li></ul></div></div><div class="sect1"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="chpt.song_editor.editor_modes"></a>8.2. Song Editor modes</h2></div></div></div><p>
The Song Editor has two different <span class="emphasis"><em>interaction modes</em></span>. The
default <a class="link" href="#chpt.song_editor.editor_modes.select" title="8.2.1. Select Mode"><span class="bold"><strong>Select mode</strong></span></a> allows
pattern blocks to be set, cleared, selected, moved and
copied. The <a class="link" href="#chpt.song_editor.editor_modes.draw" title="8.2.2. Draw Mode"><span class="bold"><strong>Draw mode</strong></span></a>
instead allows pattern sequences to be drawn freehand.
</p><p>
In both modes, you can perform basic editing: clicking an
empty square activates the pattern in that time slot, and
clicking again will deactivate it.
</p><p>
They keyboard can also be used for editing. The arrow keys
<span class="keycap"><strong>↑</strong></span>|<span class="keycap"><strong>↓</strong></span>|<span class="keycap"><strong>←</strong></span>|<span class="keycap"><strong>→</strong></span>
will move the keyboard input cursor, and pressing
<span class="keycap"><strong>Return</strong></span> will activate or deactivate the
pattern in the current column.
</p><p>
In addition, there are two major <span class="emphasis"><em>playback modes</em></span>, <a class="link" href="#chpt.song_editor.editor_modes.song_mode" title="8.2.3. Song Mode"><span class="bold"><strong>Song mode</strong></span></a> and <a class="link" href="#chpt.song_editor.editor_modes.pattern_mode" title="8.2.4. Pattern Mode"><span class="bold"><strong>Pattern mode</strong></span></a>, with two minor submodes, <span class="bold"><strong>Single Pattern mode</strong></span> (covered in the <a class="link" href="#chpt.song_editor.editor_modes.pattern_mode" title="8.2.4. Pattern Mode">Pattern mode</a> section), and <a class="link" href="#chpt.song_editor.editor_modes.stacked" title="8.2.5. Stacked Mode"><span class="bold"><strong>Stacked mode</strong></span></a>. These will determine which parts of the song you will listen too during playback.
</p><div class="note" style="margin-left: 5%;"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="img/admonitions/note.svg"></td><th align="left">Note</th></tr><tr><td align="left" valign="top"><p>
While Select mode, Draw mode, Single Pattern mode, and Stacked mode are activated via the <a class="link" href="#chpt.song_editor.main_controls" title="8.1. Main Controls">Main Controls</a> of the Song Editor, Song mode and Pattern mode are activated via the <a class="link" href="#sect.main_toolbar.transport_control" title="7.1. Transport Control">Transport Control</a> section of the Main Toolbar.
</p></td></tr></table></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="chpt.song_editor.editor_modes.select"></a>8.2.1. Select Mode</h3></div></div></div><p>
This mode allows
you to select multiple patterns in the Song Editor and
delete/move/copy them.
</p><p>
Once you have selected a part of your song you can
<span class="bold"><strong>delete</strong></span> it by pressing
<span class="keycap"><strong>Delete</strong></span>. You can <span class="bold"><strong>move</strong></span> it by simply <span class="emphasis"><em>dragging</em></span> your
selection to another location with your mouse, or by
cutting (<span class="keycap"><strong>Ctrl</strong></span> + <span class="keycap"><strong>x</strong></span>) and
pasting (<span class="keycap"><strong>Ctrl</strong></span> + <span class="keycap"><strong>v</strong></span>) using
your keyboard. You can also <span class="bold"><strong>copy</strong></span> your selection by either
holding <span class="keycap"><strong>Ctrl</strong></span> while <span class="emphasis"><em>dragging</em></span> it to a new
location, or by copying (<span class="keycap"><strong>Ctrl</strong></span> +
<span class="keycap"><strong>c</strong></span>) and pasting (<span class="keycap"><strong>Ctrl</strong></span> +
<span class="keycap"><strong>v</strong></span>) using your keyboard.
</p><p>
Selections can be modified by holding <span class="keycap"><strong>Ctrl</strong></span> while clicking to select
additional blocks, or to remove selected blocks from the
selection.
</p><p>
The arrow keys on the keyboard can also be used, along
with <span class="keycap"><strong>Return</strong></span>, to <span class="bold"><strong>select</strong></span>, <span class="bold"><strong>move</strong></span> and <span class="bold"><strong>copy</strong></span> parts of the
song:
</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p><span class="keycap"><strong>Shift</strong></span> +
<span class="keycap"><strong>↑</strong></span>|<span class="keycap"><strong>↓</strong></span>|<span class="keycap"><strong>←</strong></span>|<span class="keycap"><strong>→</strong></span>
can be used to make selections using the keyboard</p></li><li class="listitem"><p><span class="keycap"><strong>Return</strong></span> over a selected block
will begin a move or copy</p></li><li class="listitem"><p><span class="keycap"><strong>↑</strong></span>|<span class="keycap"><strong>↓</strong></span>|<span class="keycap"><strong>←</strong></span>|<span class="keycap"><strong>→</strong></span> to
move the selected cells into position</p></li><li class="listitem"><p><span class="keycap"><strong>Return</strong></span> to move the selected
blocks into place</p></li><li class="listitem"><p><span class="keycap"><strong>Ctrl</strong></span> + <span class="keycap"><strong>Return</strong></span> to
<span class="bold"><strong>copy</strong></span> the selected
blocks into place</p></li></ul></div><p>
</p><p>
Pressing <span class="keycap"><strong>Esc</strong></span> will cancel an editing operation that's in
progress, or clear any selection.
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="chpt.song_editor.editor_modes.draw"></a>8.2.2. Draw Mode</h3></div></div></div><p>
This mode allows you to insert patterns by drawing -
holding the left button while moving the mouse - blocks on
the song canvas.
</p><p>
Clicking a square on the song canvas will add a pattern
(the square will turn blue) and clicking it again will
remove it. Holding the mouse button down will continue
either adding or removing patterns from under the mouse
cursor.
</p><p>
Using the arrow keys on the keyboard, and the <span class="keycap"><strong>Return</strong></span>,
will also add and remove patterns from the song.
</p><div class="note" style="margin-left: 5%;"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="img/admonitions/note.svg"></td><th align="left">Note</th></tr><tr><td align="left" valign="top"><p>
The keyboard input cursor is usually hidden unless you press one
of the keys listed in <a class="xref" href="#chpt.keyboard_and_mouse" title="Chapter 3. Keyboard and Mouse">Chapter 3</a>.
You can alter this default behavior in the <a class="link" href="#chpt.preferences.general_tab" title="5.1. General">General tab</a> of the
Preferences.
</p></td></tr></table></div></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="chpt.song_editor.editor_modes.song_mode"></a>8.2.3. Song Mode</h3></div></div></div><p>
When <span class="emphasis"><em>Song mode</em></span> is selected Hydrogen will play the sequence of patterns you have created in the Song Editor from left to right until it reaches the end of the song.
</p><div class="tip" style="margin-left: 5%;"><table border="0" summary="Tip"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Tip]" src="img/admonitions/tip.svg"></td><th align="left">Tip</th></tr><tr><td align="left" valign="top"><p>
By enabling <a class="link" href="#sect.main_toolbar.transport_control" title="7.1. Transport Control">Loop mode</a> in the transport control, the playback will move seamlessly to the beginning again after reaching the end of the song.
</p></td></tr></table></div></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="chpt.song_editor.editor_modes.pattern_mode"></a>8.2.4. Pattern Mode</h3></div></div></div><p>
When <span class="emphasis"><em>Pattern mode</em></span> is selected
Hydrogen will play the pattern that is currently selected in the Song Editor and displayed
in the <a class="link" href="#chpt.pattern_editor" title="Chapter 9. Pattern Editor">Pattern Editor</a>. This usual behavior is also called <span class="emphasis"><em>Single Pattern mode</em></span>.
</p><div class="tip" style="margin-left: 5%;"><table border="0" summary="Tip"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Tip]" src="img/admonitions/tip.svg"></td><th align="left">Tip</th></tr><tr><td align="left" valign="top"><p>
By enabling <a class="link" href="#sect.main_toolbar.transport_control" title="7.1. Transport Control">Loop mode</a> in the transport control, the playback will move seamlessly to the beginning again after reaching the end of the pattern.
</p></td></tr></table></div></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="chpt.song_editor.editor_modes.stacked"></a>8.2.5. Stacked Mode</h3></div></div></div><p>
Normally when composing a pattern and editing it, you'll
listen to that single pattern looping over and over again
while working on it. Sometimes, however, it's useful to
hear that pattern in the context of other patterns (for
example, other instrument parts) while working on it.
</p><p>
Stacked mode will play multiple patterns simultaneously,
on a loop. You can select which patterns play using
<span class="keycap"><strong>Ctrl</strong></span> + <span class="emphasis"><em>left click</em></span> on the
pattern's name. Selected patterns are all marked with a
triangle.
</p><div class="note" style="margin-left: 5%;"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="img/admonitions/note.svg"></td><th align="left">Note</th></tr><tr><td align="left" valign="top"><p>
Hydrogen's playback mode must be set to <span class="bold"><strong>Pattern</strong></span> rather than
<span class="bold"><strong>Song</strong></span> for Stacked mode to take effect.
</p></td></tr></table></div></div></div><div class="sect1"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="chpt.song_editor.sidebar"></a>8.3. Sidebar</h2></div></div></div><p>
The Sidebar of the Song Editor allows you to interact with and arrange the patterns of your song.
</p><p><span class="emphasis"><em>Left-clicking</em></span> selects a pattern, <span class="emphasis"><em>double-clicking</em></span> allows you to rename a pattern, <span class="emphasis"><em>drag-and-dropping</em></span> allows you to rearrange the patterns, and <span class="emphasis"><em>right-clicking</em></span> will show you a menu
where you can change a number of things:</p><div class="figure"><a name="fig.song_editor.virtualPattern.selectedMenu"></a><p class="title"><b>Figure 8.2. The Pattern Options menu</b></p><div class="figure-contents"><div class="mediaobject"><img src="generated_en/Virtual_patterns_menu.png" alt="The Pattern Options menu"></div></div></div><br class="figure-break"><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: opencircle; "><li class="listitem" style="list-style-type: circle"><p><span class="bold"><strong>Duplicate</strong></span>: will copy the selected pattern to a new pattern in your song.
</p><div class="note" style="margin-left: 5%;"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="img/admonitions/note.svg"></td><th align="left">Note</th></tr><tr><td align="left" valign="top"><p>
Note that patterns with the same name are not allowed.
</p></td></tr></table></div></li><li class="listitem" style="list-style-type: circle"><p><span class="bold"><strong>Delete</strong></span>: will completely remove the selected pattern from the song.
</p></li><li class="listitem" style="list-style-type: circle"><p><span class="bold"><strong>Fill/Clear</strong></span>: will open a window that allows you to fill/clear a
part of the song with the selected pattern by entering the start- and end bar.
</p><div class="informalfigure"><a name="fig.fill_clear_pattern"></a><div class="mediaobject"><img src="generated_en/fill_clear_pattern.png" alt='Dialog appearing when filling or clearing a pattern. To the left either "Fill" or "Clear" (below) can be checked and to the right the numerical text input form "From" and "To" (below) indicate the range of the operation. At the bottom there are "Cancel" (left) and "OK" (right) buttons.'></div></div><p>
</p></li><li class="listitem" style="list-style-type: circle"><p><a name="chpt.song_editor.sidebar.properties"></a><span class="bold"><strong>Properties</strong></span>: will open a window where you can change
the name of the pattern and also assign it to a certain category. Using the latter you can group pattern in in the <a class="link" href="#sect.sl.patterns" title="10.3. Patterns">Sound Library</a>.
</p><div class="figure"><a name="fig.pattern_properties"></a><p class="title"><b>Figure 8.3. The Dialog to Change the Pattern Properties</b></p><div class="figure-contents"><div class="mediaobject"><img src="generated_en/pattern_properties.png" alt='Dialog appearing when changing the properties of a pattern. At the top text input one specifies the "New Pattern Name". In the larger one below the "Pattern description". Underneath one can select the "Pattern category". At the bottom there are "Cancel" (left) and "OK" (right) buttons.'></div></div></div><br class="figure-break"><div class="note" style="margin-left: 5%;"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="img/admonitions/note.svg"></td><th align="left">Note</th></tr><tr><td align="left" valign="top"><p>
Note that you can choose one of the existing categories from the dropdown list,
but you can also enter a new category name in the Pattern Category
box.
</p></td></tr></table></div></li><li class="listitem" style="list-style-type: circle"><p><span class="bold"><strong>Load Pattern</strong></span>: will
load a pattern from a saved pattern file.
</p></li><li class="listitem" style="list-style-type: circle"><p><a name="chpt.song_editor.sidebar.save_pattern"></a><span class="bold"><strong>Save Pattern</strong></span>: stores the
pattern in the <code class="filename">patterns</code> folder