Jump to content
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.

## Installation

Install the sonospy-gitAUR package.

## Configuration

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

### sonospy.conf

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`

## Usage

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)

### sonospy-scan

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

### sonospy

Enable and start `sonospy.service`.

## See also

- Official web site
- Sonospy Community Forum

Categories:

- Music
- Media servers