From 1027c9ec1bc5687c83e29031ac955f374218367b Mon Sep 17 00:00:00 2001 From: Ambrose Li Date: Mon, 20 May 2024 03:39:50 -0400 Subject: [PATCH 1/3] a few more things to check out --- TROUBLESHOOTING.md | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/TROUBLESHOOTING.md b/TROUBLESHOOTING.md index b20d898fc..4fdfd355c 100644 --- a/TROUBLESHOOTING.md +++ b/TROUBLESHOOTING.md @@ -8,6 +8,7 @@ In this brief document will be listed some problems and some solutions, some pro 2. If you have set `interpolation` in the `general` section of the configuration file to to `soxr`, comment it out or set it to `auto` or `basic` as the `soxr` setting can cause lower-powered devices to bog down at critical times, e.g. see [this report](https://github.com/mikebrady/shairport-sync/issues/631#issuecomment-366305203). ### No/Low Sound +#### ALSA Let's say you've just installed or updated Shairport Sync and you are testing it for the first time after installing or updating. If you are using the default ALSA backend, don't forget to check two simple things: 1. Check that the volume on the output device is turned up. If the output device has a "mixer" i.e. a volume control, Shairport Sync does not, by default, try to control it. Therefore, if it happens to be very low or even at zero, you might not hear audio that is actually coming through to the device. (You can get Shairport Sync to control a mixer -- see [here](https://github.com/mikebrady/spsdoc/blob/main/ADVANCED%20TOPICS/InitialConfiguration.md) for some hints.) @@ -15,6 +16,16 @@ If you are using the default ALSA backend, don't forget to check two simple thin You can use `alsamixer` for both of these checks. A muted output has the letter(s) `M` as its value. Select it and type `M` again to unmute. +#### JACK +If you’re using the JACK backend, check that you have connected your inputs and outputs. You do have to connect them yourself. + +#### Network issues +If the audio end looks fine, there are a couple of simple things on the network end worth checking: + +1. Is the wi-fi interface up? +2. Are Shairport Sync and the Apple device on the same wi-fi network? +3. Is the Apple device reachable from the system running Shairport Sync? (That is, are there any routing issues?) It *is* possible for the mDNS multicast to reach Shairport Sync even though the two devices can’t actually talk to each other. + ### Sync is slightly off! Please see [Adjusting Sync](./ADVANCED%20TOPICS/AdjustingSync.md). From 122d4fed36b6723a691736a4207aa8f8b9fd7139 Mon Sep 17 00:00:00 2001 From: Ambrose Li Date: Mon, 20 May 2024 15:01:17 -0400 Subject: [PATCH 2/3] refactor and make the draft text more consistent with the existing text --- TROUBLESHOOTING.md | 23 ++++++++++++++--------- 1 file changed, 14 insertions(+), 9 deletions(-) diff --git a/TROUBLESHOOTING.md b/TROUBLESHOOTING.md index 4fdfd355c..713e3b897 100644 --- a/TROUBLESHOOTING.md +++ b/TROUBLESHOOTING.md @@ -8,23 +8,28 @@ In this brief document will be listed some problems and some solutions, some pro 2. If you have set `interpolation` in the `general` section of the configuration file to to `soxr`, comment it out or set it to `auto` or `basic` as the `soxr` setting can cause lower-powered devices to bog down at critical times, e.g. see [this report](https://github.com/mikebrady/shairport-sync/issues/631#issuecomment-366305203). ### No/Low Sound -#### ALSA Let's say you've just installed or updated Shairport Sync and you are testing it for the first time after installing or updating. -If you are using the default ALSA backend, don't forget to check two simple things: +Don't forget to check a few simple things: +#### Check ALSA +If you are using the default ALSA backend, 1. Check that the volume on the output device is turned up. If the output device has a "mixer" i.e. a volume control, Shairport Sync does not, by default, try to control it. Therefore, if it happens to be very low or even at zero, you might not hear audio that is actually coming through to the device. (You can get Shairport Sync to control a mixer -- see [here](https://github.com/mikebrady/spsdoc/blob/main/ADVANCED%20TOPICS/InitialConfiguration.md) for some hints.) 2. Check that the output device is not muted. Some audio applications (including very old versions of Shairport Sync) leave the output device mixer in a muted state after use to minimise the possibility of noise. However, this is not generally compatible with other audio players using the same device, as they generally expect the device to be unmuted. You can use `alsamixer` for both of these checks. A muted output has the letter(s) `M` as its value. Select it and type `M` again to unmute. -#### JACK -If you’re using the JACK backend, check that you have connected your inputs and outputs. You do have to connect them yourself. +#### Check JACK +If you’re using the JACK backend, +check that you have connected your inputs and outputs. +You do have to connect them yourself. -#### Network issues -If the audio end looks fine, there are a couple of simple things on the network end worth checking: +#### Check Network +If the audio end looks fine, -1. Is the wi-fi interface up? -2. Are Shairport Sync and the Apple device on the same wi-fi network? -3. Is the Apple device reachable from the system running Shairport Sync? (That is, are there any routing issues?) It *is* possible for the mDNS multicast to reach Shairport Sync even though the two devices can’t actually talk to each other. +1. Check that the wi-fi interface is up. +2. Check that Shairport Sync and the Apple device are on the same wi-fi network. +3. Check that the Apple device can be reached from the system running Shairport Sync. +It *is* possible for the two to be aware of each other +even though they can’t actually talk. ### Sync is slightly off! Please see [Adjusting Sync](./ADVANCED%20TOPICS/AdjustingSync.md). From 1412262718736d027210cb914da829e6a351b9de Mon Sep 17 00:00:00 2001 From: Ambrose Li Date: Mon, 20 May 2024 15:08:37 -0400 Subject: [PATCH 3/3] rewrite the new bits. Wrong interface is not really a "no sound" problem --- TROUBLESHOOTING.md | 14 ++++++++------ 1 file changed, 8 insertions(+), 6 deletions(-) diff --git a/TROUBLESHOOTING.md b/TROUBLESHOOTING.md index 713e3b897..d116812f4 100644 --- a/TROUBLESHOOTING.md +++ b/TROUBLESHOOTING.md @@ -10,6 +10,7 @@ In this brief document will be listed some problems and some solutions, some pro ### No/Low Sound Let's say you've just installed or updated Shairport Sync and you are testing it for the first time after installing or updating. Don't forget to check a few simple things: + #### Check ALSA If you are using the default ALSA backend, 1. Check that the volume on the output device is turned up. If the output device has a "mixer" i.e. a volume control, Shairport Sync does not, by default, try to control it. Therefore, if it happens to be very low or even at zero, you might not hear audio that is actually coming through to the device. (You can get Shairport Sync to control a mixer -- see [here](https://github.com/mikebrady/spsdoc/blob/main/ADVANCED%20TOPICS/InitialConfiguration.md) for some hints.) @@ -18,22 +19,23 @@ If you are using the default ALSA backend, You can use `alsamixer` for both of these checks. A muted output has the letter(s) `M` as its value. Select it and type `M` again to unmute. #### Check JACK -If you’re using the JACK backend, +If you are using the JACK backend, check that you have connected your inputs and outputs. You do have to connect them yourself. #### Check Network -If the audio end looks fine, - -1. Check that the wi-fi interface is up. -2. Check that Shairport Sync and the Apple device are on the same wi-fi network. -3. Check that the Apple device can be reached from the system running Shairport Sync. +If you can select Shairport Sync as a speaker but audio continues to come out of the Apple device itself, +check that the Apple device can be reached from the system running Shairport Sync. It *is* possible for the two to be aware of each other even though they can’t actually talk. ### Sync is slightly off! Please see [Adjusting Sync](./ADVANCED%20TOPICS/AdjustingSync.md). +### Shairport Sync does not appear on the Apple device +Please check that the wi-fi interface is up, +and that Shairport Sync and the Apple device are on the same wi-fi network. + ### WiFi adapter running in power-saving / low-power mode **Check Throughput**