From ArchWiki

Sonospy is a music server for Sonos that allows you overcome the 65,000 local track limit and also offers various customisation options.


Install the sonospy-gitAUR package.


Sonospy is controlled by a set of configuration files, which contain comments and example setup:

  • /etc/sonospy/sonospy.conf contains the systemctl service parameters
  • /opt/sonospy/data/scan.ini configures the sonospy file scanner
  • /opt/sonospy/data/pycpoint.ini is the main server ini
  • /opt/sonospy/data/defaultindex.ini is the default userindex ini
  • /opt/sonospy/data/userindex.ini is the customisable userindex ini


Key fields:

  • SERVICE: Controls the service name displayed in Sonos
  • Music Path: Sets the path to the music library
Note: Sonos_db and Sonos_ini are symlinked from /opt/sonospy/data to /opt/sonospy/app/sonospy so the application functions. If these are modified, then the equivalently named files should be available in /opt/sonospy/app/sonospy. This was introduced to comply with arch packaging standards and is not part of the source program.

Sonospy ini files

  • scan.ini
  • pycpoint.ini
  • defaultindex.ini
  • userindex.ini

Details can be found in the files and examples can be found in /opt/sonospy/app/sonospy

Note: The data files are all symlinked to /opt/sonospy/app/sonospy


Sonospy has two services:

  1. A file scanner to catalogue the music and extract the metadata (sonospy-scan)
  2. A music server for Sonos (sonospy)


Enable and start sonospy-scan.timer. This is set to run a daily scan to check for updates to the music library


Enable and start sonospy.service.

See also