Skip to content

Commit ffda98f

Browse files
committed
Add a "Troubleshooting" section to squeezeplay.md
Based on this forum post[1], add a new "Troubleshooting" section to the documentation for SqueezePlay, which includes a workaround for getting stuck at the "Libraries" screen during initial setup, when SqueezePlay is run on a host that has more than one (active?) network interface. [1]: https://forums.lyrion.org/forum/user-forums/general-discussion/1732269-squeezeplay-setup-8-4-1r1474-exe-windows-not-finding-server Signed-off-by: Kevin Ernst <[email protected]>
1 parent e9b6581 commit ffda98f

File tree

1 file changed

+25
-1
lines changed

1 file changed

+25
-1
lines changed

docs/players-and-controllers/squeezeplay.md

Lines changed: 25 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -64,4 +64,28 @@ Play Favorite 0-9 0-9
6464

6565
## Troubleshooting
6666

67-
In case you encounter issues, please head over to the [forums](https://forums.lyrion.org/forum/user-forums/general-discussion/93838-squeezeplay-for-windows-with-asio-directsound-wasapi-and-wdmks-device-support) for assistance.
67+
_Some_ issues with SqueezePlay can be resolved by renaming (or removing) the `userpath` directory. Keep in mind that your installed apps and any menu customizations are stored in `userpath`, so it's best to make a backup before tinkering with it!
68+
69+
For the various supported platforms, `userpath` is located in:
70+
71+
* `%USERPROFILE%\AppData\Roaming\SqueezePlay` for Windows
72+
* `~/Library/Preferences/SqueezePlay` for macOS
73+
* and `~/.squeezeplay` for other Unix/Linux
74+
75+
Removing/renaming this directory allows you to start with a fresh configuration, and go through the first-launch setup steps again.
76+
77+
### No libraries showing up during initial setup
78+
79+
SqueezePlay has a known issue[^fn1] on several platforms where it fails to receive the broadcast packets from instances of Lyrion Media Server on your local network, when the host running SqueezePlay has multiple network interfaces. This can leave you stuck at the "Libraries" screen during initial setup, with no obvious way to proceed.
80+
81+
If it isn't possible to disable the other network interfaces during initial setup, try this workaround[^fn2]:
82+
83+
1. press <kbd>D</kbd> (upper case) to get to the top-level menu
84+
2. choose _Settings__Advanced_ (off the bottom of the default screen, so use arrow keys to scroll)
85+
3. choose _Networking__Remote Libraries_
86+
4. enter the IP address of the desired LMS instance
87+
88+
In case you encounter other issues, please head over to the [forums](https://forums.lyrion.org/forum/user-forums/general-discussion/93838-squeezeplay-for-windows-with-asio-directsound-wasapi-and-wdmks-device-support) for assistance.
89+
90+
[^fn1]: https://forums.lyrion.org/forum/user-forums/general-discussion/1732269-squeezeplay-setup-8-4-1r1474-exe-windows-not-finding-server?p=1732388#post1732388
91+
[^fn2]: https://forums.lyrion.org/forum/user-forums/general-discussion/1732269-squeezeplay-setup-8-4-1r1474-exe-windows-not-finding-server?p=1745250#post1745250

0 commit comments

Comments
 (0)