Skip to content

Latest commit

 

History

History
138 lines (87 loc) · 5.27 KB

README.md

File metadata and controls

138 lines (87 loc) · 5.27 KB
Raw

Build Status dependencies Status devDependencies Status

Unofficial Sonos Controller for Linux

First I was tinkering with Chrome apps and sonos. I released this as a Chrome app, which had a good 70k users on the Chrome store. Subsequently Chrome apps turned out to be a dying platform, so I've moved over to Electron. The project is written in mostly ES6 and utilizes React and Redux to manage the UI

Why?

I use Ubuntu as my main OS, and there's no decent controller app. So I am aiming to at some point provide a usable sonos controller that can run on Linux also, installed via deb file. Maybe it won't have all the functions of the real sonos player, but if I can browse the library, Spotify and manage the queue, I'll be pretty damn happy.

Install via snap

Since v0.2.0-alpha1 the app gets published to snapcraft.

snap install --edge sonos-controller-unofficial

Install via .AppImage file

Find the latest .AppImage on the release page. You can right click it on Ubuntu, then under "Permissions" mark is as executable. ALternatively run:

chmod +x sonos-controller-unofficial-amd64-0.2.1-alpha8.AppImage

After that it can be launched by double click or via invoking it through the terminal.

To create a .desktop entry in Ubuntu, add it under something like ~/.local/share/applications/unoffical-sonos-controller-for-linux.desktop with the following content, of course referencing the right file)= location and version:

#!/usr/bin/env xdg-open
[Desktop Entry]
Terminal=false
Type=Application
Categories=Audio;
Name=sonos-controller-unofficial
Icon=appimagekit-sonos-controller-unofficial
Exec="/home/username/Downloads/sonos-controller-unofficial-0.2.1-alpha8.AppImage" %U

Install via .deb file

Find the latest .deb on the release page. On Ubuntu, you can double click the downloaded file to install it via the Software Center. Alternatively run

sudo dpkg -i sonos-controller-unofficial-amd64-0.2.1-alpha8.AppImage

and Run locally

You will need node.js for this.

First, initialize the project:

npm install

Second, start the electron app in develop mode:

npm run develop

Building a deb and AppImage binaries:

npm run dist

This might require some additional binaries, like graphicsMagick and icnsutils, which you can install via apt

Firewall settings

You will need to whitelist these if you run Ubuntu firewall for example:

  • TCP 1400 outgoing
  • TCP 4000 incoming
  • UDP 1900 outgoing
  • UDP 1905 incoming

Troubleshooting

Q: The app keeps searching for my Sonos system

Device discovery utilizes the Simple Service Discovery Protocol over IPv4 and relies on multicast IP addresses and UDP messages.

Make sure you check the Firewall settings above are applied correctly.

If all ports are open and search still doesn not work, but you know the IP address of one of the devices, you can add an IP manually by using the developer menu option.

Contributions

Feel free to fork and create pull requests. Any help with the variety of music services would be most welcome.

Issues

For any issues, please submit them on the issues page.

Before you do, make sure you check the Firewall settings above are applied correctly.

To provide more context please take the time and attach a copy of your current app state. You can do this by using the "Save app state to file" option in the Developer menu.

Thanks to other projects

Please refer to the above projects' licenses (MIT), where they apply.