added content

SUMMARY.md

@@ -2,9 +2,9 @@
 
 * [Introduction](README.md)
 * [1. Which audio setup do I use?](setup/README.md)
-  * [Acoustic/mic-captured performance](setup/acoustic.md)
-  * [DAW without external audio interface](setup/acoustic.md)
-  * [DAW with an external audio interface](setup/acoustic.md)
+  * [Acoustic/mic-captured performance](setup/dawless.md)
+  * [DAW without external audio interface](setup/daw.md)
+  * [DAW with an external audio interface](setup/dawinterface.md)
 * [2. A super fast introduction to OBS](obs.md)
 * [3. Video configuration](video.md)
 * [4. Audio configuration](audio/README.md)

obs.md

@@ -1 +1,27 @@
 # A super fast introduction to OBS
+
+
+1.  Start by downloading OBS Studio from [here](https://obsproject.com/download), then install it.
+
+2.  Launch the application. The first time, it will prompt an automatic configuration wizard. **Skip it**. A first scene with the name "Scene" should already be created.
+
+3. You should then see the main OBS interface:
+
+![OBS Studio default user interface](img/obs.png)
+
+As meant by its own name, OBS is an open broadcasting software. OBS works with **Scenes**, each scene being a patchwork of a variety of **Sources** arranged as you want. Sources can be pieces of hardware (a camera, a microphone...), files from your computer (images, video files...), virtual devices (like internal audio input/outputs) or even external live streams!
+
+You can stream one scene at a time, and switch between scenes simply by clicking on it in the Scenes window. Several scenes can share the same audio/video sources. So you can for example have two scenes each showing a different camera, but both using the same audio source. This way you can switch from a camera to another one simply by selecting another scene.
+
+In this guide we will only cover the simplest possible setup, including only one scene with only one video source and one audio source.
+
+Look at the OBS interface screenshot above. In this guide we will mostly use the four yellow circled buttons:
+
+1. The `Settings` button allows you to open the Settings panel. You can also access it through the menu bar, at `OBS > Preferences` in macOS, or `File > Settings` in Windows
+2.  The ➕ button at the bottom of the Sources window allow you to create a new source.
+3.  The gear icon ⚙️ nearby each source in the Audio Mixer allow you to access the source's **Properties**, the **Filters** applied to it, and the global **Advanced Audio Properties** panel allowing you some advanced tasks such as monitoring your sources.
+4.  The `Start Streamingk` button, quite self-explanatory.
+
+Notice that here we have two audio sources in the Audio Mixer ("Desktop Audio" and "Mic/Aux"). These sources does not appear in the Sources window because they are like special sources automatically created by OBS. They however act as any other audio source. You can by the way create additional similar audio sources by clicking the ➕ in the Sources window and select `Audio input capture` or `Audio output capture`. The first one acts like the "Desktop Audio" source while the latter acts like a "Mic/Aux" source.
+
+In the next steps of this guide, you will see how to use theses features to set up a simple yet working stream for your musical performance.

setup/README.md

@@ -1,6 +1,7 @@
 # Which audio setup do I use?
 
-First you need to determine the kind of audio setup you are using. This will lead you to the appropriate instructions to prepare your live stream.
+First you need to determine the kind of audio setup you are using. This will lead you to the appropriate instructions to prepare your live stream:
 
-I identified three kinds of setup:
-- [My performance is purely acoustic and/or I just need one mic to capture it](acoustic.md)
+- [My performance is purely acoustic and/or I just need one mic to capture it](dawless.md)
+- [My performance requires an audio software but no external sound card](daw.md)
+- [My performance requires an audio software and an external sound card](dawinterface.md)

setup/daw.md

@@ -0,0 +1,14 @@
+# My performance requires an audio software but no external sound card
+
+You will need [**OBS**](https://obsproject.com/download), and its configuration is quite straightforward in most cases:
+
+-   macOS user: refer to **Case 6: OBS + BlackHole (macOS only)** in part 2 / Using a computer (OBS) / Audio setup
+
+-   Windows user:
+
+    -   If you use default MME/DirectX drivers, refer to **Case 2: OBS + Desktop Audio source**
+
+    -   If you use ASIO drivers (such as [ASIO4ALL](http://www.asio4all.org/), [FL Studio ASIO](https://www.image-line.com/support/flstudio_online_manual/html/envsettings_audio.htm#FLStudioASIO) installed along with [FL Studio](https://www.image-line.com/downloads/flstudiodownload.html) but compatible with any audio software, or [ReaRoute](https://www.soundonsound.com/techniques/route-master) with [Reaper](https://www.reaper.fm/)), you have two solutions:
+
+        -   The ReaStream VST plugin solution might be the simplest one as you keep your audio software configured as usual with your favorite ASIO drivers. Refer to **Case 3: OBS + ReaStream VST (Windows only)** in part 2 / Using a computer (OBS) / Audio setup
+        -   You can also choose to keep your audio in an ASIO context using an additional ASIO mixer such as [VoiceMeeter Banana](https://www.vb-audio.com/Voicemeeter/banana.htm), [Asio Link Pro](https://discuss.cakewalk.com/index.php?/topic/3519-odeus-asio-link-now-available-free/) or [Jack Audio](https://jackaudio.org/downloads/) (all free). This is the most tricky way to go and can be hard to configure properly to get less latency than with MME/DirectX drivers or ReaStream. Because latency is why you use ASIO drivers I guess. You can refer to **Case 5: OBS + OBS-ASIO + ASIO mixer** in part 2 / Using a computer (OBS) / Audio setup if you want to give it a try, and go back to **Case 3** (ReaStream) if you are unsuccessful.

setup/dawinterface.md

@@ -0,0 +1,40 @@
+# My performance requires an audio software and an external sound card
+
+This might be the case for most of you. The idea is quite simple: we want to turn your main audio software output into an audio input in OBS. You can do that virtually, using your external sound card software (only for compatible models/drivers) or a 3^rd^ party virtual audio device, or you can do it physically, by wiring one of your external sound card's output to a physical audio input. Here are some details for all of these ways, each leading you to the **appropriate case shown in part 2 / Using a computer (OBS) / Audio setup**.
+
+A virtual loopback might be preferred as it does not need extra piece of hardware, but depending on your case a hard-wired loopback can eventually be easier to achieve. Choose the option you feel the most comfortable with.
+
+
+## Virtual loopback
+
+-   Your sound card supports multi-initialization from multiple applications, and has a built-in **loopback feature**. It is the case of all 3^rd^ gen Focusrite Scarlett, 1^st^ gen 8i6 Focusrite Scarlett, most RME interfaces (using TotalMix), some Motu interfaces (using CueMix), the Roland Quad Capture, the Behringuer XR18, and some other devices I'm not aware of. This should be the best way to go as it is quite simple to configure and should add little to no additional latency. The loopback feature (generally accessible from your external sound card's mixer software) will allow you to route your audio output back into one of its (either virtual or physical) audio inputs. You can then easily select this input in OBS. First refer to your external sound cards owner manual to see how to use the loopack feature. Then, depending on your OS:
+
+    -   macOS user: refer to **Case 1: OBS + Mic/Aux source**
+    -   Windows: refer to **Case 4: OBS + OBS-ASIO** if your external sound card uses ASIO drivers, or **Case 1: OBS + Mic/Aux source** otherwise.
+
+-   Whichever the external sound card you use, you can still create a virtual loopback using additional softwares (but it can increase your audio latency):
+
+    -   macOS users: refer to **Case 6: OBS + BlackHole (macOS only)**
+
+    -   Windows users:
+
+        -   The ReaStream VST plugin solution might be the simplest one as it should work for any case and it allow you to keep your audio software configured as usual with your favorite sound card drivers (ASIO or other). Refer to **Case 3: OBS + ReaStream VST (Windows only)**
+        -   If your external sound card uses MME/Direct drivers, you should be able to catch its output directly by selecting it as a "Desktop Audio" source in OBS. Refer to **Case 2: OBS + Desktop Audio source**
+        -   If your external sound card uses ASIO drivers, you can try to use an additional ASIO mixer such as [VoiceMeeter Banana](https://www.vb-audio.com/Voicemeeter/banana.htm), [Asio Link Pro](https://discuss.cakewalk.com/index.php?/topic/3519-odeus-asio-link-now-available-free/) or [Jack Audio](https://jackaudio.org/downloads/) (all free). This is the most tricky way to go and can be hard to configure properly to get less latency than with MME/DirectX drivers or ReaStream. Complexity goes even higher if you need your external sound card to output/input audio to/from external audio effects, synths, mics involved in your performance... You can refer to **Case 5: OBS + OBS-ASIO + ASIO mixer** if you want to give it a try, and go back to **Case 3** (ReaStream) if you are unsuccessful.
+
+
+## Physical (hard-wired) loopback
+
+-   Your sound card does not provide a built-in loopback feature, but you have **two unused audio outputs** (or one stereo output) and possibly two unused audio inputs on your audio interface (can be an SPDIF in and out -- SPDIF is better for quality as the signal stays digital -- or two balanced jack/XLR outputs and two line inputs). If so, you can "manually" create a loopback with real cables from real life, by plugging your available output into your available input. The input can either be one of your external sound cards inputs, your computer built-in line mini-jack input (although not advised for quality reasons) or even a secondary external sound card (see next point). Notice that using an input from your only external sound card should only work if this sound card supports multiple initialization from multiple applications. As this feature is very rarely made explicit by sound card manufacturers, just try and see if it works. To proceed, in your audio software, find a way to double the output of your master (using a bus or return track, or an "External audio effect" in Ableton Live) so it can be sent to both your usual master/monitoring audio output, and the extra audio output available on your sound card. Then wire the selected secondary output back into an available input. Then:
+
+    -   For macOS users, refer to **Case 1: OBS + Mic/Aux source**
+
+    -   For Windows users:
+
+        -   If you loop your audio back into your computer built-in line-input, refer to **Case 1: OBS + Mic/Aux source**
+        -   If you use an available input on your external sound card, refer to **Case 4: OBS + OBS-ASIO** if your external sound card uses ASIO drivers, or **Case 1: OBS + Mic/Aux source** otherwise
+
+-   You have **two external sound cards**, so you can use one with your audio software and the other one as an input for OBS. Your case is then similar to the previous one. You need to wire one of your main sound card output to the secondary audio interface input, then select this input in OBS. To do so:
+
+    -   For macOS users, refer to **Case 1: OBS + Mic/Aux source**
+    -   For Windows users: refer to **Case 4: OBS + OBS-ASIO** if your secondary external sound card uses ASIO drivers, or **Case 1: OBS + Mic/Aux source** otherwise

video.md

@@ -1 +1,18 @@
 # Video configuration
+
+1. Once you opened OBS for the first time, you should see a scene called `Scene` in the Scenes window. You can see it is empty as it has no source attached to it.
+
+3.  Now we need to add a video source in our scene. You can use both a webcam or a smartphone as a camera.
+
+    -   Using your webcam:
+        -   Click the ➕ in the Sources window, and choose `Video capture device`
+        -   Select `Create new`, set whatever name you want and click OK. The properties window of the video capture device appears. Your webcam should then appear in the devices list. If not, refer to your webcam's manual.
+        -   Depending on your webcam you should have several settings. Let's stay with defaults and click OK. If you need to re-open the properties windows, just double-click the created video capture device in the Sources window.
+
+    -   Using a smartphone's camera.
+        -   You have several solutions to use your phone's camera as a webcam in OBS, such as [EpocCam](http://www.kinoni.com/epoccam_support.html) (for iOS and Android, free version with low quality, paid version for full quality), [DroidCam](https://play.google.com/store/apps/details?id=com.dreamdroid.livedroid) (Android only, free) or [NDI HX Camera](https://apps.apple.com/us/app/ndi-hx-camera/id1477266080?ls=1​) (iOS only, free, you will also need the [OBS-NDI](https://github.com/Palakis/obs-ndi/releases) plugin to make it work)). The steps to get these apps working in OBS are quite simple and can be easily found on developers websites or on youtube. Notice that most of these apps require your phone to be Wifi connected to your home network, so you cannot use it as a 4G internet hotspot at the same time.
+        -   Once you added your phone as a video source in OBS, you might see it also appear as an audio source in the OBS audio mixer with the "video capture device" name you set earlier. You most like want to disable this audio source as you will get your sound from a proper mic or your audio software as we will see.
+
+4.  Once you created your video source, make sure it fill the whole area of your scene by stretching it to the correct dimension. To stretch it, select the source in the Sources window, then a red frame should appear around your view. Click a corner and stretch.
+
+5.  Good, you can now go to the next part to [configure your audio](audio/README.md).