~mixxxdevelopers/mixxx/manual

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
1001
1002
.. _interface-overview:

An Overview of the Mixxx Interface
**********************************

Welcome to the Mixxx interface. This is where the magic happens.
You are going to want to get very familiar with this interface because it is
the main way to use Mixxx. In this chapter, we present the default interface of
Mixxx and describe its elements, knobs and faders.

.. figure:: ../_static/Mixxx-111-Deere-1440x900.png
   :align: center
   :width: 100%
   :figwidth: 100%
   :alt: The Mixxx interface - Deere skin
   :figclass: pretty-figures

   The Mixxx interface - Deere skin

This is the Deere skin. It is the default skin supplied with Mixxx. There are a
variety of others skins included with Mixxx. You should explore them all to
figure out which one you prefer. This section will focus on Deere only.

.. _interface-decks:

The Deck Sections
=================

.. sectionauthor::
   RJ Ryan <rryan@mixxx.org>
   S.Brandt <s.brandt@mixxx.org>

.. figure:: ../_static/Mixxx-111-Deere-Deck.png
   :align: center
   :width: 60%
   :figwidth: 100%
   :alt: A deck
   :figclass: pretty-figures

   A deck with a track loaded

The deck section allows you to control everything relating to a virtual
turntable :term:`deck`. We are going to break this down into sections.

.. _interface-track-info:

Track Information Display
-------------------------

.. figure:: ../_static/Mixxx-111-Deere-Deck-Track-Info.png
   :align: center
   :width: 60%
   :figwidth: 100%
   :alt: The track information section of the deck
   :figclass: pretty-figures

   The track information section of the deck

**Track Title**
  The title of the track that was loaded into a deck is displayed on top. This
  is the same as the title listed under the :guilabel:`Title` column heading in
  the Mixxx library. This information is initially loaded from the tracks
  :term:`metadata`.

**Track Artist**
  The title of the track is listed below. It is the same as listed under the
  :guilabel:`Artist` column heading in the Mixxx library.

**BPM (Tempo)**
  The number at the top right is the effective :term:`BPM` of the track. This is
  the detected :term:`BPM` of the track, adjusted for the playback rate of the
  track. For example, if the track is normally 100 BPM, and it is playing at
  +5%, then the effective BPM will read 105 BPM.

  .. hint:: Click directly on the BPM display and tap with the beat to set the
            BPM to the speed you are tapping. You can also use a keyboard
            shortcut, go to :ref:`control-keyboard` for more information.

**Time Elapsed/Remaining**
  By default it displays the total elapsed time in the track up to the
  millisecond. Clicking on the display switches to the *Time Remaining* view,
  which indicates how much time is left before the track reaches the end.
  You can change the default in :menuselection:`Preferences --> Interface -->
  Position Display`.


.. _interface-waveform:

Waveform Displays
-----------------

.. sectionauthor::
   RJ Ryan <rryan@mixxx.org>
   S.Brandt <s.brandt@mixxx.org>

.. figure:: ../_static/Mixxx-111-Deere-Deck-Waveform.png
   :align: center
   :width: 60%
   :figwidth: 100%
   :alt: The deck waveform summary and waveform overview
   :figclass: pretty-figures

   The waveform summary and waveform overview of the deck

The waveform section of a deck allows you to visualize the audio changes that
occur throughout the track, you can basically “see” your music.

**Waveform summary**
  The big waveform summary shows the waveform envelope of the track near the
  current playback position and is updated in realtime. The mouse can be used on
  the waveform to pause, scratch, spin-back or throw the tracks. Right-clicking
  on the waveforms allows you to drag with the mouse to make temporary pitch
  adjustments.

  .. hint :: You can select from different types of displays for the waveform,
             which differ primarily in the level of detail shown in the
             waveform, in :menuselection:`Preferences --> Interface -->
             Waveform Display --> Display type`.

**Waveform overview**
  The smaller, zoomed-out version of the waveform shows the various markers
  within the track as well as the waveform envelope of the entire track. This is
  useful because they allow DJs to see breakdowns far in advance. Clicking
  somewhere on the waveform allows you to jump to an arbitrary position in the
  track.

**Vinyl Widget**
  The line on the vinyl widget rotates if the track moves. It is similar to the
  position marker found on scratch records. Use the mouse on the vinyl widget to
  pause, scratch, spin-back or throw tracks - just like a real record.
  When performing :ref:`Loop rolls <interface-looping>` or right-clicking on the
  vinyl during playback, a “ghost” marker hints where the playback will continue.
  The Vinyl Widget is hidden by default and can be enabled in the
  :ref:`interface-button-grid`.

  If :term:`Vinyl control` is enabled, it can optionally display the time-coded
  vinyl signal quality. Activate the option in :menuselection:`Preferences -->
  Vinyl Control --> Show Signal Quality in Skin`.

**Waveform Zoom**
  Using the mouse-wheel everywhere in the waveform summary will zoom the
  waveform in or out. You can choose whether or not to synchronize the zoom
  level between the decks in :menuselection:`Preferences --> Interface -->
  Waveform Display --> Synchronize`.

**Waveform Marker**
  While mixing, various additional markers can appear on the waveforms:

* **Position marker**: The static vertical line in the center of the waveform
  summary indicates the playback point of the deck.
* **Beat marker**: The regular white lines on the waveform summary indicate the
  locations of beats in the audio, also called the :term:`beatgrid`.
* **Cue marker**: Indicates the position of the :term:`cue point <cue>`.
* **Hotcue marker**: Indicate the position and number of a :term:`hotcue`
  point if set.
* **Loop-in/Out marker**: Indicate the beginning and the end of a loop.
* **Loop overlay**: Is drawn between the Loop-in/Out markers and changes color
  depending on whether a loop is activated or not.
* **Track ending notification**: If the waveform overview flashes red, only 30
  seconds are left before the track reaches the end.

.. seealso:: To learn how to get most out of the waveforms while mixing, go to
             the chapter :ref:`waveform-displays`.

.. warning :: If you have a slower computer and notice performance issues with
              Mixxx, try to lower the frame rate or change the level of detail
              shown in the waveform in in :menuselection:`Preferences -->
              Interface --> Waveform Display`.

.. _interface-button-grid:

Deck Options Button Grid
------------------------

.. sectionauthor::
   RJ Ryan <rryan@mixxx.org>
   S.Brandt <s.brandt@mixxx.org>

.. figure:: ../_static/Mixxx-111-Deere-Deck-Button-Grid.png
   :align: center
   :width: 90px
   :figwidth: 100%
   :alt: The Options Button Grid of the deck
   :figclass: pretty-figures

   The Options Button Grid of the deck

The six buttons at the bottom right below the waveform allow you to configure
the deck. Starting from the top-left and moving counterclockwise the buttons
are as follows:

**Show/Hide Vinyl Widget**
  Toggles the visibility of the Vinyl Widget in the :ref:`interface-waveform`.

**Repeat Mode Toggle**
  If enabled, the repeat mode will jump back to the beginning and continue
  playing when the track finishes.

**Eject Track Button**
  Clicking this button ejects the track from the deck. Alternatively you can use
  a keyboard shortcut, go to the chapter :ref:`control-keyboard` for more
  information.

**Beat-grid Adjust Button**
  Clicking this button adjusts the track beat-grid so that the current position
  is marked as a beat. This is useful if Mixxx was able to accurately detect the
  track's :term:`BPM` but failed to align the beat markers on the beats. For
  more information, go to the chapter :ref:`djing-bpm-detection`.

**Quantize Mode Toggle**
  If enabled, all cues, hotcues, loops, and beatloops will be automatically
  :term:`quantized <quantization>` so that they begin on a beat.

**Keylock Toggle**
  :term:`Keylock <key lock>` locks the track's pitch so that adjustments to its
  tempo via the rate slider do not affect its pitch. This is useful if you would
  like to speed up or slow down a track and avoid the “chipmunk” effect that
  speeding up vocals has.

.. _interface-vc-mode:

Vinyl Control Mode and Cueing controls
--------------------------------------

.. sectionauthor::
   S.Brandt <s.brandt@mixxx.org>

.. figure:: ../_static/Mixxx-111-Deere-Deck-Vinyl-Mode.png
   :align: center
   :width: 70%
   :figwidth: 100%
   :alt: The Vinyl Control Mode and Cueing controls of a deck
   :figclass: pretty-figures

   The Vinyl Control Mode and Cueing controls of a deck

The control above the waveforms relate to the :term:`vinyl control` feature in
Mixxx and is **hidden** in the default
:ref:`Mixxx user interface <interface-overview>`. Click the
:ref:`VINYL section expansion button <interface-expansion-buttons>` in the mixer
section, or use the specific :ref:`appendix-shortcuts` to show or hide the
section.

**Abs/Rel/Const button**

* **Absolute mode**: The track position equals needle position and speed.
* **Relative mode**: The track speed equals needle speed regardless of needle
  position.
* **Constant mode**: The track speed equals last known-steady speed regardless
  of needle input.

**Off/One/Hot button**

This button determines how :term:`cue points <cue>` are treated in vinyl
control relative mode:

* **Off**: Cue points are ignored.
* **One Cue**: If the needle is dropped after the cue point, the track will seek
  to that cue point.
* **Hot Cue**: The track will seek to nearest previous :term:`hotcue` point.

.. seealso :: For more information on how to use Vinyl control in your setup, go
              to the chapter :ref:`vinyl-control`.

.. _interface-rate:

Sync and Rate Controls
----------------------

.. sectionauthor::
   RJ Ryan <rryan@mixxx.org>
   S.Brandt <s.brandt@mixxx.org>

.. figure:: ../_static/Mixxx-111-Deere-Deck-Rate-Control.png
   :align: right
   :width: 64px
   :figwidth: 100px
   :alt: The rate control section of the deck
   :figclass: pretty-figures

   Rate controls

The rate controls allow you to change the rate at which tracks are played. This
is very useful for :term:`beatmatching` two tracks together in a mix. You can
control rate changes also from your computer's keyboard, see the chapter
:ref:`control-keyboard` for more information.

**SYNC button**

* **Left-Click**: Changes the :term:`rate` of the track so that the :term:`BPM`
  and :term:`phase` of the track matches the other deck.
* **Right-Click**: Only changes the :term:`rate` of the track to match the other
  deck but does not adjusts the :term:`phase`.

.. versionchanged:: 1.11 Changed Sync mode (Ghetto Sync™)

Decks and samplers now pick which sync target to sync to on the fly. Decks
can't sync to samplers and samplers can only sync to decks. The sync target is:

* The first (in numerical order) deck that is playing (rate > 0) a track that
  has a detected beatgrid.
* The first (in numerical order) deck that has a track loaded with a detected
  beatgrid (could be stopped).

  So basically, if you sync a sampler and both deck 1 and deck 2 are playing a
  track with a beatgrid then deck 1 will win since numerically it is first. This
  will change again in the future once Mixxx gets a proper master sync feature.

**Pitch/Rate slider**
  The slider allows you to change the speed of the song, by default up to 10%
  from the tracks original tempos. The speed will increase as you move the
  slider up, opposite to the behavior found on DJ turntables and :term:`CDJ`.
  Right-clicking on the slider will reset the tempo to its original value.

**Pitch Rate Display**
  The percent that the track's rate is sped up or slowed down is noted here. Is
  the Pitch/Rate slider positioned at the center, the pitch rate display is at
  +0.0%, which indicates no change.

**Pitch/Rate buttons**
  The plus and minus buttons increase or decrease the tempo in steps at which a
  song is played, same as pulling the pitch slider slightly. By right-clicking
  the buttons you get even finer adjustments.

**Temporary Pitch/Rate buttons (Nudge)**
  Pushing the the left and right arrow buttons is like nudging the metal edge of
  a turntable, or the outer edge of a CD player. It will give the track a push
  or pull forwards or backwards. If the buttons are released the previous tempo
  is restored. The buttons can act as either a fixed :term:`pitch bend` or a
  :term:`ramping pitch bend`.

.. seealso:: To customize the amount by which the buttons alter the pitch of
             the track, the slider range as well as the direction, go to
             :menuselection:`Preferences --> Interface`.

.. hint:: If the tempo of a track changes, you'll notice that the tone changes
          based on the pitch used (e.g. playing at faster pitch gives a chipmunk
          sound). You can enable the :ref:`Keylock <interface-button-grid>`
          feature to maintain a constant tone.

.. _interface-transport:

Transport Controls
------------------

.. sectionauthor::
   RJ Ryan <rryan@mixxx.org>
   S.Brandt <s.brandt@mixxx.org>

.. figure:: ../_static/Mixxx-111-Deere-Deck-Transport.png
   :align: center
   :width: 66px
   :figwidth: 100%
   :alt: The transport controls of the deck
   :figclass: pretty-figures

   The transport controls of the deck

**Fast-Rewind button**
  As long as the button is pressed, the track will play in reverse with
  increased speed. Right-clicking on the button will seek the play position to
  the beginning of the track.

**Fast-Forward button**
  As long as the button is pressed, the track will play with increased speed.
  Right-clicking on the button will seek the play position to the end of the
  track.

**Reverse button**
  As the name suggests, this button plays a track backwards.

.. _interface-looping:

Loop Controls
-------------

.. sectionauthor::
   RJ Ryan <rryan@mixxx.org>
   S.Brandt <s.brandt@mixxx.org>

.. figure:: ../_static/Mixxx-111-Deere-Deck-Loops.png
   :align: center
   :width: 236px
   :figwidth: 100%
   :alt: The beatloop and looping controls of the deck
   :figclass: pretty-figures

   The beatloop and looping controls of the deck

In this section of the Mixxx interface you can control (beat-)loops and set the
loop points of a track.

**Beatlooping Buttons**

* **Instant loop**: The numbered buttons represents a different :term:`bar`
  length. Clicking on any of that buttons will set a loop of the defined
  number of beats from the beat immediately following the current playback
  position. If a loop is set, a loop overlay will be drawn on the
  :ref:`waveforms <interface-waveform>`.
* **Loop roll**:

  .. versionadded:: 1.11

  Right-click on any of the numbered loop buttons to temporarily setup a rolling
  loop over the defined number of beats. Playback will resume where the track
  would have been if it had not entered the loop.
* **Double loop**: Clicking on the plus button will double the current loop's
  length up to 64 bars. The length of the loop overlay in the waveform will
  increase accordingly.
* **Halve loop**: Clicking on the minus button will halve the current loop's
  length down to 1/32 bars. The length of the loop overlay in the waveform will
  decrease accordingly.

**Loop Buttons**

* **Loop-In**: This button allow you to manually set the start point of a loop.
  A loop-in marker is placed on the waveform indicating the position.
  If clicked when a loop was already set, it moves the start point of a loop
  to a new position.
* **Loop-Out**: This button allow you to manually set the end point of a loop.
  A loop-out marker is placed on the waveform indicating the position. If clicked when
  a loop was already set, it moves the end point of a loop to a new position.
* **Loop**: Also dubbed Reloop, this button toggles whether the loop is active
  or not. This works for manually placed loops as well as automatic loops set by
  the beatlooping buttons. Depending on the current status of the loop, the
  loop overlay on the waveforms changes color.

.. hint:: If you are playing inside a loop and want to move the end point
          beyond its current position in the track, click on the *Loop* button
          first and when the play position reaches the desired position, click on the
          Loop-Out button.

.. seealso:: If the :term:`Quantize <quantization>` mode is enabled, the loops
             will automatically snap to the nearest beat. This is disabled by
             default, click on the :ref:`Quantize Mode Toggle
             <interface-button-grid>` to enable it.

.. _interface-hotcues:

Hotcue Controls
---------------

.. sectionauthor::
   RJ Ryan <rryan@mixxx.org>
   S.Brandt <s.brandt@mixxx.org>

.. figure:: ../_static/Mixxx-111-Deere-Deck-Hotcues.png
   :align: center
   :width: 65px
   :figwidth: 100%
   :alt: The hotcue controls of the deck
   :figclass: pretty-figures

   The hotcue controls of the deck

To jump in between different parts of a track, you can use these numbered
buttons. You can also use keyboard shortcuts, go to :ref:`control-keyboard` for
more information.

Setting Hotcues
^^^^^^^^^^^^^^^

Clicking on a numbered button will set a :term:`hotcue` at the current play
position on the track. A marker with the corresponding number will appear in the
waveform and the button will lit up to indicate that the hotcue is set.

Playing Hotcues
^^^^^^^^^^^^^^^

* **While playing**: Tap a hotcue button to cause the track to instantly jump to
  the location of the hotcue and continue playing. If you are playing inside a
  loop and tap a hotcue whose position is outside of the loop, then the track
  still instantly jumps to the hotcue but the loop will be deactivated.

* **While stopped**: Tap a hotcue button to cause the track to instantly jump to
  the location of the hotcue and start playing as long as the button is pressed.
  Press the :ref:`Play <control-keyboard>` keyboard shortcut while the hotcue
  button is pressed to continue playback, then release the hotcue button.

Deleting Hotcues
^^^^^^^^^^^^^^^^

To delete a hotcue, right-click on the numbered button. The marker in the
waveform will be deleted as well.

.. note:: Mixxx supports up to 36 hotcues per deck. By default, only some of
          them are visible in the user interface. You can customize your
          :ref:`keyboard <advanced-keyboard>` or :ref:`controller
          <advanced-controller>` mappings to use all of them.

.. seealso:: Just as with the loops (see above), if the
             :term:`quantize <quantization>` mode is enabled, the hotcues will
             automatically snap to the nearest beat. This is disabled by
             default, click on the :ref:`Quantize Mode Toggle
             <interface-button-grid>` to enable it.

.. _interface-mixer:

The Mixer Section
=================

.. sectionauthor::
   RJ Ryan <rryan@mixxx.org>
   S.Brandt <s.brandt@mixxx.org>

.. figure:: ../_static/Mixxx-111-Deere-Mixer.png
   :align: center
   :width: 321px
   :figwidth: 100%
   :alt: The mixer section
   :figclass: pretty-figures

   The mixer section

The mixer section of the :ref:`Mixxx user interface <interface-overview>` allows
you to control how the different decks and samplers are mixed together.

.. _interface-vu-meter:

Channel Faders and VU Meters
----------------------------

**VU meters**
  In the center of the mixer section are 4 :term:`VU meters <vu meter>`. The
  two outer-most VU meters are for each deck, while the 2 inner-most VU meters
  are the left and right VU meters for the master output.

  The light at the top of the VU meter indicates when the audio in the selected
  channel is clipping. If this light goes on, reduce the gain or EQs for this
  deck to eliminate distortion.

**Line faders**
  The two large faders on either side of the VU meters are the deck volume
  faders, also known as Channel- or Line-faders. Adjusting these controls the
  volume of each deck.

  .. hint:: Some DJ's prefer to use the line faders over the crossfader for
            fading between tracks. Try it, you may like it.

.. _interface-expansion-buttons:

Section Expansion Buttons
-------------------------

.. figure:: ../_static/Mixxx-111-Deere-Mixer-Expansion-Buttons.png
   :align: center
   :width: 154px
   :figwidth: 100%
   :alt: The section expansion buttons
   :figclass: pretty-figures

   The section expansion buttons

Above the VU meters in the mixer are the optional section expansion buttons.

If you click on either :guilabel:`MIC`, :guilabel:`SAMPLER`, or
:guilabel:`VINYL` then you will enable control sections for interacting with:

* :ref:`interface-mic`
* :ref:`interface-sampler`
* :ref:`interface-vc-mode`

.. versionadded:: 1.11
   You can also use the specific :ref:`appendix-shortcuts`.

.. _interface-head-master:

Headphone and Master Mix Controls
---------------------------------

.. figure:: ../_static/Mixxx-111-Deere-Mixer-Master.png
   :align: center
   :width: 321px
   :figwidth: 100%
   :alt: The headphone and master mix knobs
   :figclass: pretty-figures

   The headphone and master mix knobs

**Head-Mix Knob**
  Allows you to customize how much of the master output you hear in your
  headphones. It works like a crossfader between the stereo Master and stereo
  Cueing signal. If the knob is set to the left, you only hear the cueing signal
  which can be useful for prelistening tracks.

  .. note:: Don't forget to activate the :guilabel:`PFL` button on the deck you
            want to listen to in your headphones.

**Head volume Knob**
  This button adjusts your headphone volume. You can adjust the volume of a
  single deck's signal you are listening to in the headphones with the
  :ref:`Gain <interface-eq-gain>` knob.

**Balance Knob**
  This knob allows you to adjust the :term:`balance` (left/right orientation) of
  the master output.

**Volume Knob**
  The Volume Knob controls the overall volume of of the master output. Adjust
  this knob so that the :ref:`Master VU meters <interface-vu-meter>` are just
  at the peak.

  .. hint:: If the Peak indicator on top of the Master VU meter flashes, the
            master output signal is clipping (too loud). Lower the volume with
            using the volume knob.

.. _interface-pfl:

PFL/Headphone Button
--------------------

.. figure:: ../_static/Mixxx-111-Deere-Mixer-PFL.png
   :align: center
   :width: 321px
   :figwidth: 100%
   :alt: The headphone buttons of both decks in the mixer
   :figclass: pretty-figures

   The headphone buttons of both decks in the mixer

The headphone button is also known as the :term:`pre-fader listen or PFL <PFL>`
button. Pressing this button allows you to listen and synchronize the track you
will play next in your headphones before your audience hears the track
(headphone cueing). You can select more than one PFL button simultaneously.

.. seealso:: Headphone cueing is only available if you have configured a
             Headphone Output in :menuselection:`Preferences --> Sound Hardware`.

.. _interface-eq-gain:

Equalizers and Gain Knobs
-------------------------

.. figure:: ../_static/Mixxx-111-Deere-Mixer-EQ.png
   :align: right
   :width: 81px
   :figwidth: 100px
   :alt: The EQ Controls of a deck in the mixer
   :figclass: pretty-figures

   EQ Controls

.. versionadded:: 1.11 Latch mode for Kill Switches

**Gain Knob**
  Above these knobs, the gain knob allows you to adjust the gain of the deck. In
  general, you should adjust this knob so that at full-volume the deck's audio is
  just at the peak of the center VU meters. This is so you can achieve the widest
  dynamic range for your track.

**EQ Knobs**
  The low, mid, and high knobs allow you to change the filters of the audio.
  This allows you to selectively reduce or boost certain frequency ranges of
  the audio.

**Kill Switches**
  The small boxes next to each EQ knob are called :term:`kills <kill switch>`.
  Hold these buttons to fully remove that frequency range. Short click on the
  buttons for latching. When in Latch mode, click again to restore the frequency
  range. If the Kill switches do not work as expected, check the high/low shelf
  EQ settings in the preferences.

.. seealso:: You can customize the EQ settings in :menuselection:`Preferences
             --> Equalizer`.

.. _interface-crossfader:

Crossfader
----------

.. figure:: ../_static/Mixxx-111-Deere-Mixer-Crossfader.png
   :align: center
   :width: 449px
   :figwidth: 100%
   :alt: The crossfader section of the mixer with Play/Pause and Cue buttons
   :figclass: pretty-figures

   The crossfader section of the mixer with Play/Pause and Cue buttons

.. versionadded:: 1.11
   Reverse crossfader (Hamster style)

The :term:`crossfader` determines the actual volume of each deck when moving
the slider from left to right. If both decks are playing and the crossfader is
in its default center position, then you will hear both decks. Right-clicking on
the crossfader will reset the slider to its default position.

You can reverse the configuration of the crossfader, so that the right deck is
on the left end of the crossfader and vice versa. This is also known as
*Hamster Style*. To adjust the crossfader to your style of mixing, go to
:menuselection:`Preferences --> Crossfader`.

.. hint :: Using the :ref:`AutoDJ <djing-auto-dj>` feature in Mixxx, you can
           automate the crossfade between the decks.

.. _interface-play-pause:

Play/Pause Button
-----------------
Clicking the Play/Pause button starts and pauses the playback. A right-click on
the button during playback places a :term:`Cue point <cue>` on the track, see
:ref:`interface-cue`.

.. hint :: To return to the beginning of the track, right-click on the deck's
           :ref:`Fast-Rewind Button <interface-transport>`.

.. _interface-cue:

Cue Button
----------
If the button is pressed, the play position jumps to an existing
:term:`Cue point <cue>` on the track or sets a new one, depending on whether a
track is playing or not. If you have not set any custom cues yet, the default
point is at the track's beginning.

Setting Cue points
^^^^^^^^^^^^^^^^^^

* **While playing**: The Cue point is set via :ref:`interface-play-pause`.
  A right-click on the button places a Cue point at the current play position on
  the track, and a :ref:`Cue marker <interface-waveform>` appears on the
  waveforms.

* **While stopped**: Clicking on the Cue button places a Cue point at the
  current play position on the track, and a Cue marker appears on the waveforms.
  The existing cue point will be replaced.

Every track has a Cue point, by default on its beginning. Unlike with
:ref:`Hotcues <interface-hotcues>`, you can't delete, but only move Cue points.

Using Cue Modes
^^^^^^^^^^^^^^^

You can switch between the CUE modes in :menuselection:`Preferences -->
Interface`.

**CDJ cue mode (default)**

* **While playing**: Tapping the Cue button causes the track to instantly
  jump to the location of the cue point where it stops the playback.
* **While stopped**: Holding down the Cue button jumps to the cue point and
  starts playback as long as the button is pressed. If the button is released,
  the play position marker jumps to the cue point and the playback is paused.
  Clicking the Play button while the Cue button is down continues the playback.

**Simple mode**

* **While playing**: Similar to the :ref:`Hotcues <interface-hotcues>`,
  clicking the Cue button jumps to the cue point and continues playback.
* **While stopped**: No action is performed.

.. hint:: Use the :ref:`interface-hotcues` to place more reference points on a
          track.

.. seealso:: You can also use keyboard shortcuts for Cueing. Go to
             :ref:`control-keyboard` for more information.

.. _interface-fx:

Effects Controls
----------------

.. figure:: ../_static/Mixxx-111-Deere-Mixer-FX.png
   :align: center
   :width: 321px
   :figwidth: 100%
   :alt: The effect control section of the mixer
   :figclass: pretty-figures

   The effect control section of the mixer

Currently, the only available internal effect in Mixxx is a :term:`flanger`.
This effect applies a “sweeping” sound to the channel and can add extra depth
to a mix when used tactfully.

**FX Button**
  The FX (“Effects”) button enables a built-in flanger effect on the selected
  channel.

**Delay/Depth/LFO Knobs**
  Adjusts the phase delay, intensity and the the wavelength of the flange effect.

.. hint :: For the most noticeable effect, enable the FX button and turn the
           Depth knob completely to the right.

.. seealso :: As an advanced user, you can route your audio signal to external
              software and then apply additional effects. Go to
              :ref:`advanced-external-fx` for more information.

.. _interface-sampler:

The Sampler Section
===================

.. figure:: ../_static/Mixxx-111-Deere-Sampler-Deck.png
   :align: center
   :width: 304px
   :figwidth: 100%
   :alt: A sample deck
   :figclass: pretty-figures

   A sample deck

Samplers are miniature decks. They allow you to play short samples and jingles
but also additional tracks in your mix. They come with a small overview waveform
and a limited number of controls. All controls work just like on the regular
decks, see :ref:`interface-decks`.

The Sampler section is **hidden** in the default
:ref:`Mixxx user interface <interface-overview>`. Click the
:ref:`SAMPLER <interface-expansion-buttons>` button in the mixer section, or use
the specific :ref:`appendix-shortcuts` to show or hide the section.

Waveform Display
----------------

**Waveform overview**
  The waveform shows the various markers within the track as well as the
  waveform envelope of the entire track. Clicking somewhere on the waveform
  allows you to jump to an arbitrary position in the track.

**Waveform Marker**
  While mixing, some additional markers can appear on the waveforms:

* **Position marker**: A vertical line indicates the playback point of the
  sample deck.
* **Hotcue marker**: Indicate the position and number of a :term:`hotcue`
  point if set.

Track Information Display
-------------------------

**Track Artist/Title**
  The artist and title of the track that was loaded into a sampler deck is
  displayed here.

**BPM (Tempo)**
  The number at the top right is the effective :term:`BPM` of the track. Tap the
  BPM to set the BPM to the speed you are tapping.

Deck Options Button Grid
------------------------
The buttons grid next to the waveform overview allow you to configure the
sampler deck. Starting from the top-left and moving counterclockwise the buttons
are as follows:

**Repeat Mode Toggle**
  If enabled, the repeat mode will jump back to the beginning and continue
  playing when the track finishes.

**Eject Track Button**
  Clicking this button ejects the track from the deck.

**Mix Orientation Toggle**
  This control determines the microphone input's mix orientation.

**Keylock Toggle**
  :term:`Keylock <key lock>` locks the track's pitch so that adjustments to its
  tempo via the rate slider do not affect its pitch.

Sample Deck Controls
--------------------

.. versionadded:: 1.11
   Samplers can sync to decks.

**Play/Pause button**
  Clicking the button starts and stops playback. Right-clicking on the button
  will seek the play position to the beginning of the sample.

**Sync Button**
  Syncs the Sampler deck to a regular deck, as described in :ref:`interface-rate`.

* **Left-Click**: Changes the :term:`rate` of the track so that the :term:`BPM`
  and :term:`phase` of the track matches the sync target.
* **Right-Click**: Only changes the :term:`rate` of the track to match the sync
  target but does not adjusts the :term:`phase`.

**Hotcue Controls**
  To jump in between different parts of a sample, you can use these numbered
  hotcue buttons.

**PFL/Headphone Button**
  If active, the :term:`pre-fader listen or PFL <PFL>` button allows you to
  listen to the track in your headphones.

**Gain Knob**
  Allows you to adjust the volume of the track.

**VU Meter**
  Shows the level of the signal and can be adjusted with the Gain knob.

**Pitch/Rate slider**
  The slider allows you to change the speed of the sample. Right-clicking on the
  slider will reset the tempo to its original value.

.. _interface-mic:

The Microphone Section
======================

.. sectionauthor::
   S.Brandt <s.brandt@mixxx.org>

.. figure:: ../_static/Mixxx-111-Deere-Microphone.png
   :align: center
   :width: 286px
   :figwidth: 100%
   :alt: The Microphone section
   :figclass: pretty-figures

   The Microphone section

The microphone section is **hidden** in the default
:ref:`Mixxx user interface <interface-overview>`. Click the
:ref:`MIC <interface-expansion-buttons>` button in the mixer section, or use the
specific :ref:`appendix-shortcuts` to show or hide the section.

**Setup the microphone**

* Most computers have built-in microphones, while some are connected through USB.
  These work adequately, but don't expect them to be high-quality.
* The best solution is to connect a good external microphone to the “Mic” or “Line” input on
  your audio device. If available, use the “Gain” knob on the device to adjust
  the input signal.
* Select the microphone input in
  :menuselection:`Preference --> Sound Hardware --> Input --> Microphone` and
  click :guilabel:`Apply`.

Microphone Controls
-------------------

**Talk Button**

  .. versionchanged:: 1.11 Latch mode added.

  Hold this button and talk to mix the microphone input into the Mixxx master
  output. Short click on the button for latching. This is handy for talking for
  an extended period, for example when :ref:`streaming <live-broadcasting>` a
  radio show. When in Latch mode, click again to mute the microphone input.

**Mix Orientation Toggle**
  This control determines the microphone input's mix orientation. Either to the
  left side of crossfader, to the right side or to the center (default).
  Clicking cycles through all the options.

**Microphone Volume Meter**
  This displays the microphone volume input signal strength.

**Microphone Gain Knob**
  Use this knob to adjust the gain of the microphone output. Try to keep the
  volume at a reasonable level to avoid signal clipping.

.. _interface-preview-deck:

Preview Deck Section
====================

.. sectionauthor::
   S.Brandt <s.brandt@mixxx.org>

.. figure:: ../_static/Mixxx-111-Deere-Preview-Deck.png
   :align: center
   :width: 30%
   :figwidth: 100%
   :alt: The Preview Deck with a track loaded
   :figclass: pretty-figures

   The Preview Deck with a track loaded

.. versionadded:: 1.11

The Preview Deck is a special deck that allows you to pre-listen to tracks in the
headphones before using them in your mix. Pre-listening a track does not change
the tracks's :guilabel:`Played` state as well as the play counter and is not
logged in the :ref:`History <library-history>`. Press :kbd:`CTRL` + :kbd:`4`
(Windows/Linux) or :kbd:`CMD` + :kbd:`4` (Mac) to display the Preview Deck.

The features in detail:

* **Track Artist/Title**:
  The artist and title of the track is displayed here. This is the same
  listed under the :guilabel:`Track` and :guilabel:`Title` column in the Mixxx
  library. This information is initially loaded from the track's :term:`metadata`.

* **Eject Track**:
  Clicking this button ejects the track from the deck.

* **Waveform overview**:
  Shows the various markers (Cues, Hotcues) within the track as well as the
  waveform envelope of the entire track. Clicking somewhere on the waveform
  allows you to jump to an arbitrary position in the track.

* **Gain**:
  Move the slider to adjust the gain of the track.

* **VU-Meter**:
  Shows the current volume of the track. If it's too loud and distorted, a
  peak indicator flashes red.

.. seealso:: For more information, go to the chapter
             :ref:`djing-previewing-tracks`.