add specify device name from audiotest -l
@@ -135,7 +135,30 @@ $ pactl list modules short
```
For more information like usage counts and properties, remove the ```short```.
-### Other useful commands
+## Specifying an input device
+By default Mycroft will use the system default device for all audio. In most cases this provides a more consistent, flexible and reliable experience. If however other methods do not work, we can specify the exact input device Mycroft should use in our `mycroft.conf` file. For information on this configuration file, see https://mycroft.ai/documentation/mycroft-conf/.
+
+We first need to know the device name. Assuming your `mycroft-core` directory is located in the current users home directory. This can be found by running:
+`$ ~/mycroft-core/start-mycroft.sh audiotest -l`
+
+This will output a list of audio devices, before it runs the mic-test. The output we need looks like:
+```
+====================== Audio Devices ======================
+ Index Device Name
+ 4: HDA Intel PCH: ALC269VB Analog (hw:1,0)
+ 6: pulse
+ 7: default
+```
+
+This can be added to your user level configuration file - `~/.mycroft/mycroft.conf` by adding the following lines:
+```
+"listener": {
+ "device_name": "DEVICE_NAME"
+ },
+```
+Where "DEVICE_NAME" is taken from the audio device output. As this file is written in JSON, we must be careful that each entry except the last one ends with a comma after the curly bracket. If this is the last entry in the file, delete the comma.
+
+## Other useful commands
`lsusb` can be used to see what USB devices are connected to the system. `lsusb -v` can be also used, but produces significantly more output.
