]> git.sesse.net Git - nageru-docs/blob - audio.rst
Start the audio node.
[nageru-docs] / audio.rst
1 Audio
2 =====
3
4 Audio is the most important part of video. It is also the most
5 neglected part in most amateur productions; it is easy to care
6 about full-HD productions but never remember to give the speaker
7 a microphone. Your stream can live with blurry or murky pictures,
8 but it cannot live with people not hearing what's being said.
9
10 Nageru aims to give the operator meaningful, useful controls for
11 processing and mixing audio, with a focus on voice. There are two
12 modes for audio processing, namely *simple* and *multichannel*;
13 they are selectable from the audio menu.
14
15 Be aware that a mix that sounds good on a PA system will not
16 necessarily sound good on a stream; PA systems often have rather
17 different audio characteristics than a set of home speakers or
18 headphones, and there will also frequently be other sounds in the
19 room that remove some of the typical “dryness”. However, for simple
20 use, reusing such a mix isn't the worst choice you can make.
21
22
23 Simple mode
24 -----------
25
26 **Simple** audio mode is the default, and was the only mode available
27 up until Nageru 1.4.0. Despite its name, it contains a powerful
28 audio processing chain; however, in many cases, you won't need to
29 understand or twiddle any of the knobs availale.
30
31 Simple mode allows input from only a single source, and that source
32 has to be one of the capture cards. (You choose which one by right-clicking
33 on its channel and selecting it as audio source.) The two typical
34 cases where this is useful are:
35
36   * When you simply take in audio from one of the cameras,
37     possibly by way of external microphone, or
38   * When you have an external mixer and can embed its output
39     in one of the video inputs.
40
41 If you want more than one audio source at a time, or if you want
42 to use ALSA inputs, you will need to use multichannel mode; it is
43 more complicated, but it is a strict superset of what the simple mode
44 can do. (In fact, simple mode constructs a multichannel setup
45 behind-the-scenes and then runs the multichannel audio code.)
46
47
48 The audio strip
49 ---------------
50
51 .. image:: images/basic-ui.png
52
53 The audio strip contains the processing chain for the audio from
54 start to end. Note that by default, everything is enabled;
55 if you have a premade audio mix that you are confident that you
56 want 1:1 into the stream, you can start Nageru with the “--flat-audio”
57 flag, that instead starts with everything disabled.
58
59 The first step in the pipeline is a **lo-cut** (or equivalently,
60 highpass) filter. The exact cutoff frequency is a bit a matter
61 of taste (and also depends on the speaker), but the main point
62 is that it gets rid of low-frequency hum and a lot of the background
63 noise that is not related to the speaker's voice. (If you were
64 producing music, you'd probably want it there to make room for
65 music *under* it, but the you'd want it higher than the default 120 Hz.)
66
67 (TODO: write more)
68
69
70 Audio meters
71 ------------
72
73
74 Multichannel mode
75 -----------------
76
77
78 MIDI control
79 ------------