Add more detail for the Windows build process

.github/ISSUE_TEMPLATE/newsounddevice.md

@@ -0,0 +1,21 @@
+---
+name: New Sound device
+about: Add a new device which you tested to the knowledge base
+title: "[KB New Device]"
+labels: kb
+assignees: ''
+---
+## Name of the device I want to add
+
+## Device type (Audio interface, Recorder) + connection type (USB, FireWire)
+
+## URL to manufacturer (if exists)
+
+## Tested operating systems
+Add comments if you tested your device on this operating system and if you need to notice specific things (e.g. you need a special ASIO driver on Windows):
+
+**Windows:** 
+**macOS:** 
+**Linux:**
+
+## Additional information

_posts/2021-01-05-Jamulus-Sound-Devices.md

@@ -0,0 +1,319 @@
+---
+layout: post
+title: "Audio devices for Jamulus"
+lang: "en"
+heading: "Sound devices"
+lang: "en"
+---
+
+Thanks to Jamulus users, this page lists audio devices known to work (or not) with Jamulus.
+<!--more-->
+
+_**Note**: If they work or not can depend on your operating system (Linux, MacOS, Windows, etc.)_.
+
+## Updating this page
+
+You can update this page with the information you have. **Please indicate the platform(s) you are using!**. Just [open an issue with the sound device topic on the Jamulus documentation repo](https://github.com/jamulussoftware/jamuluswebsite/issues/new?template=newsounddevice.md) and fill the form.
+
+## Audio devices known to work with Jamulus
+
+### USB/USB-C devices
+
+#### Microphones / DI Boxes
+
+**[Blue Yeti](https://www.bluemic.com/en-us/products/yeti/)**, USB Microphone
+
+**Windows**: Works well *with ASIO4All*; a bit more latency than under macOS. You can disable local monitoring by going deep into the settings.
+
+**macOS**: Works well. (There is a check option to disable local monitoring).
+
+**Linux**: Latency is good. You can't disable local monitoring (or we haven't found out how to do it, feel free to add this information if you know how to do it).
+
+***
+
+**[Shure X2u](https://www.shure.com/en-GB/products/accessories/x2u-xlr-usb-interface)**, USB to XLR audio interface with headphone jack connector that converts a wired microphone to a USB microphone.
+
+**Windows**: Set the PC/Mix dialog box to 100% PC to listen to Jamulus' mix on the headphone output.
+
+**macOS**: not yet tested.
+
+**Linux**: Tested with a Raspberry Pi 4 under *Raspberry Pi OS Buster*, kernel version 4.19.
+
+***
+
+**[Behringer UGC102](https://www.behringer.com/behringer/product?modelCode=P0198)**, Guitar-to-USB Interface  (guitar and bass)
+
+**Windows**: not yet tested.
+
+**macOS**: This device appears as "USB Audio Codec". When selected for input and output in Jamulus, the **UGC102** headphone jack is the output (and cannot be used for input).
+
+**Linux**: not yet tested.
+
+
+
+#### Audio interfaces / digital mixing consoles
+
+**[Solid State Logic SSL2+](https://www.solidstatelogic.com/products/ssl2-plus)**, USB-C/USB digital audio/MIDI interface 2 in/4 out
+
+**Windows**: Works great with the [native ASIO driver](http://eu1.download.solidstatelogic.com/SSL%202/SolidStateLogic_UsbAudio_v4.67.0_2019-10-21_setup%20(3).exe).  
+
+**macOS**: Works great (not tested on Big Sur).
+
+**Linux**: Works great (Tested on Ubuntu 20.04 and Raspberry Pi OS (Buster))
+
+The monitoring of the Jamulus mix is done by moving the "MONITOR MIX" completely to the right to "USB". See the [official manual](http://eu1.download.solidstatelogic.com/2%20Plus%20/SSL%202%20Plus%20User%20Guide_ENGLISH.pdf).
+
+***
+
+**[Ammoon AGM02](https://www.ammoon.com/p-i3974.html)** and **[Ammoon AGM04](https://www.ammoon.com/p-i4049.html)**, low-cost USB 2-channel and 4-channel compact mixing consoles
+
+**Windows**: Works. Tested *AGM02*. On Windows 10, with ASIO4ALL, the **AGM02** can be used as an input, and the onboard audio as the output. There is no way to monitor only the USB return signal on the **AGM02**.
+
+**macOS**: Both tested on **macOS Catalina**.
+
+**Linux**: Not yet tested.
+
+_**Note:** The Ammoon AGM04 appears to be a re-branded [ART USBMix4](https://artproaudio.com/product/usbmix4-four-channel-mixer-usb-audio-interface/)._
+
+**ART USBMix4**, USB 4-channel compact mixing console (_see above_)
+
+***
+
+**[Audient EVO 4](https://evo.audio/products/evo-4/overview/)**, USB digital audio interface 2-in/2-out
+
+**Windows**: Should work
+
+**macOS**: Should work
+
+**Linux**: Not yet tested.
+
+[Driver installation and download](https://evo.audio/driver-installation/)
+
+***
+
+**[Behringer UCA222](https://www.behringer.com/product.html?modelCode=P0A31)** & **Behringer UCA202 U-Control**, 2-in/2-out USB Audio Interface with Digital Output
+
+**Windows**: [ASIO4ALL](http://www.asio4all.org/) driver works OK but not great. There is also the [native driver](http://www.behringerdownload.de/_software/BEHRINGER_2902_X64_2.8.40.zip) which Behringer withdrew support for a while ago, and therefore removed from their download section.
+
+**macOS**: Works better than on Windows.
+
+**Linux**: Works better than on Windows.
+
+***
+
+**[Behringer UMC202HD](https://www.behringer.com/product.html?modelCode=P0BJZ)**, **UMC204HD**, and **UMC404HD** USB digital audio interfaces. Affordable. Behringer provides native ASIO drivers for Windows.
+
+**Windows**: Works great. [ASIO driver Windows 7 to 10](https://mediadl.musictribe.com/download/software/behringer/UMC/UMC-Driver_4-59-0.zip)
+
+**macOS**: Works great
+
+**Linux**: Works great
+
+***
+
+**[Behringer X32](https://www.behringer.com/behringer/product?modelCode=P0ASF)** X-USB digital mixing desk 32-in/32-out
+
+**Windows**: Should work.
+
+**macOS**: Should work.
+
+**Linux**: Not yet tested.
+
+***
+
+**[Behringer XR18](https://www.behringer.com/product.html?modelCode=P0BI8)** (XR serie), USB digital mixing consoles
+
+**Windows**: Should work.
+
+**macOS**: Should work.
+
+**Linux**: Not yet tested.
+
+***
+
+**[Berhinger XENYX serie](https://www.behringer.com/series.html?category=R-BEHRINGER-XENYXSERIES)**, USB digital audio interfaces
+
+**Windows**: Works, but not great. The [Behringer ASIO Driver](http://www.behringerdownload.de/_software/BEHRINGER_2902_X64_2.8.40.zip) does not appear to be very good. Audio latency with this "unsupported" driver seems poor - not better than ASIO4ALL.
+
+**macOS**: Works great.
+
+**Linux**: Works great.
+
+_More testing required._
+
+***
+
+**[Focusrite Scarlett serie](https://focusrite.com/en/scarlett)**, USB digital audio interfaces
+
+**Windows**: Works great. If you have issues with the buffer size going to 136, download the updated driver version `4.64.15.598` from [http://beta.focusrite.com/](http://beta.focusrite.com/)
+
+**macOS**: Should work great.
+
+**Linux**: Not tested, but should work great.
+
+***
+
+**[iConnectAUDIO4+](https://www.iconnectivity.com/products/audio/iconnectaudio4plus)**, Discontinued USB digital audio interface
+
+**Windows**: Provides [ASIO drivers](https://www.iconnectivity.com/downloads).
+
+**macOS**: Should work.
+
+**Linux**: Not yet tested.
+
+***
+
+**[Lexicon Omega](https://lexiconpro.com/en/products/omega)**, USB digital audio interface
+
+**Windows**: There is an ASIO driver which does not allow to use 64 samples buffer size and adds some latency.
+
+**macOS**: Should work.
+
+**Linux**: Not yet tested.
+
+***
+
+**[Native Instruments Komplete Audio 2](https://www.native-instruments.com/en/products/komplete/audio-interfaces/komplete-audio-1-audio-2/)**, USB digital audio interface
+
+**Windows**: Tested on *Windows 10* with 64 sample buffer and am getting great sound and total latency around 15ms over the ping time.
+
+**macOS**: Should work
+
+**Linux**: Not yet tested.
+
+***
+
+**[Steinberg UR22C](https://new.steinberg.net/audio-interfaces/ur22c/)** USB-C/USB3 digital audio interface
+
+**Windows**: Provides ASIO Driver. Not yet tested.
+
+**macOS**: Works directly on *macOS* with a beautiful sound even with un-balanced jack.  
+
+**Linux**: Works on a *Raspberry PI4* provided `jackd` version used is the one from `/usr/bin` (Tweaking `raspijamulus.sh`).
+
+***
+
+**[Steinberg UR22 MKII](https://www.steinberg.net/en/products/audio_interfaces/ur_series/models/ur22mkii.html)**, USB digital audio interface
+
+**Windows**: Works (great ?) on Windows.
+
+**macOS**: Not yet tested.
+
+**Linux**: Works (great?) on Linux.
+
+Sounds great, can achieve 32 frame buffer and works on *Windows* and *Linux*.  
+
+***
+
+**[Yamaha AG03](https://usa.yamaha.com/products/music_production/interfaces/ag_series/index.html)**, USB digital audio/MIDI interface
+
+**Windows**: Tested on *Windows 10* with 64 sample buffer and am getting great sound and total latency around 15ms over the ping time.
+
+**macOS**: Should work
+
+**Linux**: Not yet tested.
+
+#### Amp modelers/effects pedals for instruments
+
+**[Line 6 HX Stomp](https://line6.com/hx-stomp/)**, USB multi-effects pedal for guitar
+
+**Windows**: not yet tested.
+
+**macOS**: See [Remote Jam with Helix and Jamulus](https://jimamsden.wordpress.com/2020/04/04/remote-jamming-with-helix-and-jamulus/) for settings on a Mac.
+
+**Linux**: not yet tested.
+
+#### Digital recorders
+
+**Tascam DR-07X** stereo recorder with USB audio into computer, headphones in line-out of the recorder.
+
+**Windows**: Can also be used with an external mic in the line-in (had to use a pre-amp with that).
+
+**macOS**: should work.
+
+**Linux**: not yet tested.
+
+**Tascam DR-40X** stereo recorder as above. Set "Monitor" to "PC/Mac". **Linux Ubuntu 18.04**.
+
+***
+
+**[Zoom H4](https://zoomcorp.com/en/us/handheld-recorders/handheld-recorders/h4/)**, USB portable recorder
+
+**Windows**: Works well.
+
+**macOS**: Works well.
+
+**Linux**: Tested on Raspberry Pi 4. Works well.
+
+### FireWire devices
+
+**[Presonus StudioLive 16.4.2 AI](https://www.presonus.com/products/StudioLive-1642AI)** (StudioLive AI series), FireWire digital mixing desk  
+
+**Windows**: Since these devices work with Windows, they should also work with Jamulus.
+
+**macOS**: Works perfectly with Jamulus. Not yet tested on Big Sur. Assign the individual inputs in Jamulus or the corresponding inputs to a stereo auxiliary mix (to be patched in "Universal Control") if more than two channels. Use outputs 17-18 to monitor the Jamulus mix.  
+
+**Linux**: Not tested under Linux, may (or may not) work, see [here](https://forums.presonus.com/viewtopic.php?f=67&t=2717).
+
+***
+
+**[Edirol (Roland) FA-66](https://www.roland.com/global/products/fa-66/)** Firewire digital audio interface
+
+**Windows**: Works well. [ASIO driver download](https://www.roland.com/global/products/fa-66/downloads/)
+
+**macOS**: Works well.
+
+**Linux**: Works well.
+
+***
+
+**[MOTU Ultralite](https://motu.com/products/motuaudio/copy_of_ultralite/body-old.html)** (2010 models MK1/MK2), Firewire digital audio interface
+
+**Windows**: Their page says it should work on Windows.
+
+**macOS**: Tested on MacBook Pro 2015, **Mac OS X** 10.11.6 (El Capitan) with Apple Thunderbolt/FireWire adapter.
+
+**Linux**: Not yet tested. Should work since it's class compliant.
+
+***
+
+### Thunderbolt devices
+
+* **[Focusrite Clarett 4Pre](https://focusrite.com/en/usb-c-audio-interface/clarett-usb/clarett-4pre-usb)**, Thunderbolt 2 digital audio interface  
+
+* **[Resident Audio T4](http://www.residentaudio.com/t4overview)**, Thunderbolt 2 digital audio interface
+
+* **[Universal Audio Arrow](https://www.uaudio.com/audio-interfaces/arrow.html)**, Thunderbolt 3 digital audio interface  
+This device provides the **lowest latency**.
+
+* **[Zoom TAC-2](https://zoomcorp.com/en/us/audio-interface/audio-interfaces/tac-2/)**, Thunderbolt 2 digital audio interface
+
+### Internal soundcards
+
+**[HiFiBerry DAC+ ADC](https://www.hifiberry.com/shop/boards/hifiberry-dac-adc/)**, Raspberry Pi compatible HAC internal sound card.
+
+**Linux**: Virtually no jitter and good latency (20 milliseconds). No headphone amp, so you'll need one. Used with a mini console [Rolls MX122](https://rolls.com/product/MX22s). Tested on Raspberry Pi 4 under **Raspberry Pi OS Buster**, kernel version 4.19.
+
+**Windows**: Not yet tested (if anybody runs Windows ARM on a Raspberry Pi feel free to test it). Probably no ASIO Driver available.
+
+**macOS**: ?
+
+***
+
+**[Soundblaster Live!](https://en.wikipedia.org/wiki/Sound_Blaster_Live!)**, PCI internal sound card
+
+**Windows**: Works with [kX ASIO driver](https://www.kxproject.com/)
+
+**macOS**: ?
+
+**Linux**: ?
+
+**[Soundblaster Audigy 4](https://en.wikipedia.org/wiki/Sound_Blaster_Audigy#Sound_Blaster_Audigy_4)**, PCI internal sound card  
+
+See above. Not fully verified.
+
+## Audio devices known not to work with Jamulus
+
+* **Zoom B3**, USB amplifier modeling pedal for bass. **Does not support 48 kHz**.
+
+* **Line6 Bass POD**, USB amplifier modeling pedal for bass. **Does not support 48 kHz**.

wiki/en/en-Compiling.md

@@ -62,8 +62,16 @@ Will build the file and make it available in `./Release/Jamulus.app`
 ## Windows
 You don't need to compile Jamulus for Windows since we provide official binaries, but if you really want to, follow the instructions below.
 
-**Required software**: [Qt](https://www.qt.io/download), a compiler like Visual Studio ([Build Tools 2017 or 2019](https://visualstudio.microsoft.com/thank-you-downloading-visual-studio/?sku=BuildTools&rel=16) recommended), [ASIO development files](https://www.steinberg.net/en/company/developers.html)
+### Required Software
+* A compiler like [Visual Studio](https://visualstudio.microsoft.com) (You only need [Build Tools 2017 or 2019](https://visualstudio.microsoft.com/thank-you-downloading-visual-studio/?sku=BuildTools&rel=16) but can also choose the full IDE from the [Visual Studio download page](https://visualstudio.microsoft.com/downloads/))
+* [Qt](https://www.qt.io/download)
+    * Use the free GPLv2 license for Open Source development
+    * To determine the Qt version you need, check [qt-installer-windows.qs](https://github.com/corrados/jamulus/blob/master/windows/qt-installer-windows.qs): under INSTALL_COMPONENTS you will see `qt.qt5.[version]`, e.g., 5123 means version 5.12.3.
+    * Select Components during installation: Expand the Qt section, find the matching version, e.g., **Qt 5.12.3**, and add the compiler components for your compiler, e.g., `MSVC 2017 32-bit/64-bit` for Visual Studio 2019
+* [ASIO development files](https://www.steinberg.net/de/company/developer.html)
 
+
+### Download Jamulus source code
 Get the Jamulus source code e.g. via git or [zip download](https://github.com/corrados/jamulus/archive/master.zip) from the [Jamulus repo](https://github.com/corrados/jamulus). Make sure that there are **no** spaces in the directory you move the `jamulus` directory to since it might break the Jamulus installer (if you know how to fix this issue, please open an issue on the Jamulus repo to tell us how).
 
 ### Compiling and building installer
@@ -79,9 +87,10 @@ Most users will probably want to use this method:
 
 ### Compiling only
 
-1. Get and copy the [ASIOSDK](https://www.steinberg.net/de/company/developer.html) development files in `[\path\to\jamulus\source]\windows` directory so that, e.g., the
-  directory `[\path\to\jamulus\source]\ASIOSDK2\common` exists
-1. Open Jamulus.pro in Qt Creator then compile & run
+1. Create a folder under `\windows` called ASIOSDK2
+1. Download the [ASIOSDK](https://www.steinberg.net/asiosdk), open the top level folder in the .zip file and copy the contents into `[\path\to\jamulus\source]\windows\ASIOSDK2` so that, e.g., the folder `[\path\to\jamulus\source]\windows\ASIOSDK2\common` exists
+1. Open Jamulus.pro in Qt Creator, configure the project with a default kit, then compile & run
+
 
 ## General notes
 

wiki/en/en-Getting-Started.md

@@ -41,7 +41,7 @@ Also - [Jamulus OS!](https://sourceforge.net/projects/jamulus-os/files/JamulusOS
 
 In general, your device must support a sample rate of **48kHz** (DVD quality) and should allow you to listen to the computer's audio signal. On Windows it's recommended to choose a device with a native [ASIO](https://en.wikipedia.org/wiki/Audio_Stream_Input/Output) driver.
 
-See [the list of known good hardware](Sound-Devices).
+See [the community list of known good hardware](/kb/2021/01/05/Jamulus-Sound-Devices.html).
 
 ## Other guides
 * [This excellent guide](https://www.facebook.com/notes/jamulus-online-musicianssingers-jamming/idiots-guide-to-jamulus-app/510044532903831/){: target="_blank" rel="noopener noreferrer"} by [Simon Tomlinson](https://www.facebook.com/simon.james.tomlinson?eid=ARBQoY3KcZAtS3pGdLJuqvQTeRSOo4gHdQZT7nNzOt1oPMGgZ4_3GERe-rOyH5PxsSHVYYXjWwcqd71a){: target="_blank" rel="noopener noreferrer"} (_Facebook_) might also be worth a view.