Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

a few more things to check #1855

Closed
wants to merge 3 commits into from
Closed

a few more things to check #1855

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
1027c9e
a few more things to check out
acli May 20, 2024
122d4fe
refactor and make the draft text more consistent with the existing text
acli May 20, 2024
1412262
rewrite the new bits. Wrong interface is not really a "no sound" problem
acli May 20, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
20 changes: 19 additions & 1 deletion TROUBLESHOOTING.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -9,15 +9,33 @@ 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.
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.

#### Check JACK
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 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**
Expand Down
Loading