Skip to content

Commit 5ff5793

Browse files
daschuerdaschuer
authored
Merge pull request #858 from JoergAtGithub/backport_markdown_support_to_2.6
Backport markdown support to 2.6
2 parents 6de43c6 + a29eaff commit 5ff5793

4 files changed

Lines changed: 173 additions & 248 deletions

File tree

‎requirements.txt‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,7 @@ sphinx-intl
44
sphinx-notfound-page
55
graphviz
66
markupsafe
7+
myst-parser
78
transifex-client
89
sphinxcontrib-svg2pdfconverter
910
sphinx-rtd-theme

‎source/chapters/example_setups.md‎

Lines changed: 164 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,164 @@
1+
# Example Setups
2+
3+
This chapter presents some example hardware setups with instructions for how to configure Mixxx to work with them.
4+
5+
:::{seealso}
6+
* {ref}`hardware`: background information about different types of equipment.
7+
* {ref}`getting-started-sound-io`: details about each available input and output option.
8+
* {ref}`microphones`: details for configuring Mixxx to work with microphones.
9+
* [DJ Hardware Guide](https://github.com/mixxxdj/mixxx/wiki/Hardware-Compatibility) lists specific devices with information about their prices, features, and compatibility with Mixxx.
10+
:::
11+
12+
## Computer Only
13+
14+
The built-in audio interface on most computers comes with a single stereo line-out and a microphone input. This can be set up with Mixxx in two ways:
15+
16+
### Practicing Mixing / Broadcasting
17+
18+
This setup can be used with a single audio output for speakers or headphones to practice DJing without investing in any equipment other than a computer and a set of speakers or headphones. With this configuration, use the {ref}`Pre/Main Knob <interface-head-main>` to switch back and forth between the main mix and {term}`PFL` signal. This setup cannot be used to play for a live audience because the main mix is not sent to an audio interface output. However, it can be used by radio DJs who only need to send the main mix to a broadcast audience.
19+
20+
1. Open {menuselection}`Preferences --> Sound Hardware`
21+
2. Select the {guilabel}`Output` tab
22+
3. From the {guilabel}`Headphones` drop-down menu, select your built-in audio interface, then {guilabel}`Channels 1-2`. Although this is labeled {guilabel}`Headphones`, you can also plug speakers into the output jack of your computer.
23+
4. Depending on your audio interface, you can specify a [microphone](microphones.rst)
24+
25+
{style=lower-alpha}
26+
1. Use your built-in microphone or connect a microphone to your computer
27+
2. Check that your microphone is detected by your {term}`OS <operating system>`
28+
3. Open the {guilabel}`Input` tab
29+
4. From the {guilabel}`Microphone` drop-down menu, select the input your microphone is connected to
30+
31+
5. Click {guilabel}`Apply` to save the changes.
32+
33+
### Playing for an Audience
34+
35+
This setup allows for playing to an audience without headphone {term}`cueing`.
36+
37+
```{figure-md}
38+
:align: center
39+
40+
<img src="../_static/Mixxx-111-Preferences-Soundhardware.png" alt="Using Mixxx with your built-in sound card" class="pretty-figures" width="75%">
41+
42+
Using Mixxx with your built-in sound card
43+
```
44+
45+
1. Open {menuselection}`Preferences --> Sound Hardware`
46+
2. Select the {guilabel}`Output` tab
47+
3. From the {guilabel}`Main` drop-down menu, select your built-in audio interface, then {guilabel}`Channels 1-2`
48+
4. Depending on your audio interface, you can specify a {ref}`microphone <microphones>`
49+
50+
{style=lower-alpha}
51+
1. Use your built-in microphone or connect a microphone to your computer
52+
2. Check that your microphone is detected by your {term}`OS <operating system>`
53+
3. Open the {guilabel}`Input` tab
54+
4. From the {guilabel}`Microphone` drop-down menu, select the input your microphone is connected to
55+
5. Click {guilabel}`Apply` to save the changes.
56+
57+
(setup-laptop-with-splitter)=
58+
## Laptop and Splitter Cable
59+
60+
The cheapest way to DJ and {term}`cue` with headphones uses a stereo-to-mono DJ splitter cable (also known as a “Y cable”) plugged into the headphone jack of a laptop or other computer. This cable divides the stereo output from a single jack into two separate mono signals.
61+
62+
This setup allows you to start DJing without having to invest in expensive equipment. However, because the signals are in mono, you and your audience will not be able to enjoy music producers' positioning of sound in space (although many club PA systems are wired in mono anyway). Furthermore, audio interfaces built into computers are usually low quality and often pick up interference from other components of the computer.
63+
64+
**Using a built-in audio interface and a stereo-to-mono splitter**
65+
66+
1. Open {menuselection}`Preferences --> Sound Hardware`
67+
2. Select the {guilabel}`Output` tab
68+
3. Check that your headphones are plugged into the side of the cable with a headphones symbol and that the speakers are plugged into the side of the cable with a speaker symbol.
69+
4. From the {guilabel}`Main` drop-down menu, select your built-in audio interface, then {guilabel}`Channel 1`
70+
5. From the {guilabel}`Headphones` drop-down menu, select your built-in audio interface, then {guilabel}`Channel 2`
71+
6. Click {guilabel}`Apply` to save the changes.
72+
73+
:::{warning}
74+
Most splitter cables, particularly those marketed as headphone splitter cables, output the same stereo signal to two headphone jacks and will not work for this DJ setup. Also, if you use a generic stereo-to-mono splitter adapter, you may only be able to hear out of one side of your speakers and headphones. DJ splitter cables allow you to hear the same mono signal on both sides of your headphones and speakers.
75+
:::
76+
77+
(setup-laptop-and-external-card)=
78+
## Laptop and External USB Audio Interface
79+
80+
```{figure-md}
81+
:align: center
82+
83+
<img src="../_static/mixxx_setup_ext_audio_interface.png" alt="Using Mixxx together with an external audio interface" class="pretty-figures" width="75%">
84+
85+
Using Mixxx together with an external audio interface
86+
```
87+
88+
**Using two audio interfaces (built-in + external)**
89+
90+
1. Open {menuselection}`Preferences --> Sound Hardware`
91+
2. Select the {guilabel}`Output` tab
92+
3. From the {guilabel}`Main` drop-down menu, select the external audio interface, then {guilabel}`Channels 1-2`
93+
4. From the {guilabel}`Headphones` drop-down menu, select the built-in audio interface, then {guilabel}`Channels 1-2`
94+
95+
**Using an external multi-channel audio interface**
96+
97+
1. Open {menuselection}`Preferences --> Sound Hardware`
98+
2. Select the {guilabel}`Output` tab
99+
3. From the {guilabel}`Main` drop-down menu, select the external audio interface, then {guilabel}`Channels 1-2`
100+
4. From the {guilabel}`Headphones` drop-down menu, select the external audio interface, then {guilabel}`Channels 3-4`
101+
5. Click {guilabel}`Apply` to save the changes.
102+
103+
## Laptop and MIDI or HID Controller
104+
105+
:::{seealso}
106+
The {ref}`hardware-controllers` section of the {ref}`hardware` chapter has background information about controllers
107+
:::
108+
109+
### Controllers with an integrated audio interface
110+
111+
Many DJ controllers include an integrated *multi-channel* audio interface. A setup with this kind of controller may look like the diagram below:
112+
113+
```{figure-md}
114+
:align: center
115+
116+
<img src="../_static/mixxx_setup_midi_integrated_audio_interface.png" alt="Using Mixxx together with a DJ controller and integrated audio interface" class="pretty-figures" width="75%">
117+
118+
Using Mixxx together with a DJ controller and integrated audio interface
119+
```
120+
121+
**Using a controller with an integrated multi-channel audio interface**
122+
123+
1. Open {menuselection}`Preferences --> Sound Hardware`
124+
2. Select the {guilabel}`Output` tab
125+
3. From the {guilabel}`Main` drop-down menu, select your controller's audio interface, then {guilabel}`Channels 1-2`
126+
4. From the {guilabel}`Headphones` drop-down menu, select your controller's audio interface, then {guilabel}`Channels 3-4`
127+
5. Click {guilabel}`Apply` to save the changes.
128+
129+
(setup-controller-and-external-card)=
130+
### Controllers without an integrated audio interface
131+
132+
Controllers without an integrated audio interface can be used together with a USB audio interface as depicted in the diagram below:
133+
134+
```{figure-md}
135+
:align: center
136+
137+
<img src="../_static/mixxx_setup_midi_with_ext_audio_interface.png" alt="Using Mixxx together with a DJ controller and external audio interface" class="pretty-figures" width="75%">
138+
139+
Using Mixxx together with a DJ controller and external audio interface
140+
```
141+
142+
**Using a controller without an integrated audio interface**
143+
144+
1. Open {menuselection}`Preferences --> Sound Hardware`
145+
2. Select the {guilabel}`Output` tab
146+
3. From the {guilabel}`Main` drop-down menu, select the external audio interface, then {guilabel}`Channels 1-2`
147+
4. From the {guilabel}`Headphones` drop-down menu, select the built-in audio interface, then {guilabel}`Channels 1-2`
148+
5. Click {guilabel}`Apply` to save the changes.
149+
150+
## Laptop, External Hardware Mixer and Vinyl Control
151+
152+
```{figure-md}
153+
:align: center
154+
155+
<img src="../_static/mixxx_setup_timecode_vc.png" alt="Using Mixxx together with turntables and external mixer" class="pretty-figures" width="75%">
156+
157+
Using Mixxx together with turntables and external mixer
158+
```
159+
160+
This setup allows DJs to use the techniques of DJing with vinyl record turntables combined with the portability and flexibility of a laptop computer. Instead of carrying crates of records or CDs, DJs can carry their entire music collection on their laptop. In addition to a laptop and headphones, this setup requires an audio interface with at least two pairs of stereo inputs and outputs as well as a pair of {term}`timecode` records.
161+
162+
:::{seealso}
163+
Go to the chapter {ref}`vinyl-control` for detailed information.
164+
:::

0 commit comments

Comments
 (0)