giof71/spotconnect repository overview

⁠spotconnect-docker

A docker image for SpotConnect⁠.
This repository replaces the previous airplay⁠ and upnp⁠ separate variants of the project, which will be no longer updated.
The latest images include version 0.20.8⁠.

⁠References

This is based on this project⁠ by philippe44⁠.
In UPnP mode (SPOTCONNECT_MODE=upnp), it will let you use your upnp renderers (including those created with upmpdcli⁠ and mpd⁠) as Spotify Connect devices.
In AirPlay mode (SPOTCONNECT_MODE=raop), it will let you use your AirPlay renderers as Spotify Connect devices, including those that you have created using Shairport Sync⁠.

⁠Links

⁠Build

Simply build using the following:

docker build . -t giof71/spotconnect:latest

⁠Configuration

Configuration is available through a set of environment variables.
There are currently just a few variables available to set, but more will come as soon as possible.

⁠HTTP Content length modes (UPnP only)

From the application's own help text:

-g -3|-2|-1|0|<n> HTTP content-length mode (-3:chunked(*), -2:if known, -1:none, 0:fixed, <n> your value)

So the variable UPNP_HTTP_CONTENT_LENGTH_MODE can be set accordingly.

⁠HTTP Caching modes (UPnP only)

From the application's own help text:

-A 0|1|2 HTTP caching mode (0=memory, 1=memory but claim it's infinite(*), 2=on disk)

So the variable UPNP_HTTP_CACHING_MODE can be set accordingly.

⁠Output Codec values

⁠Output Codec values for UPnP

From the application's own help text:

-c mp3[:<rate>]|opus[:<rate>]|vorbis[:rate]|flc[:0..9]|wav|pcm audio format send to player (flac)

So possible values include but are not limited to the following list: flc, flc:5, wav, mp3, mp3:320, etc.

⁠Output Codec values for AirPlay

From the application's own help text:

-c <alac|pcm> audio format send to player (alac)

So possible values are alac and pcm.

⁠Log Level Values

Please note that the possible values for the variables starting with LOG_LEVEL_ are the following: error, warn, info, debug, sdebug.

⁠Generate a configuration file

You can generate a configuration file for the upnp version using the following command:

docker run -it \
  --user 1000:1000 \
  --network host \
  --rm \
  -v ${PWD}:/config \
  --entrypoint /app/bin/spotupnp-linux \
  giof71/spotconnect \
  -i /config/spotconnect-upnp-new.xml

The option --user 1000:1000 is needed if the current directory is owned by your user (use the correct uid/gid if they are not 1000 and 1000 respectively).
This will result in a new file named spotconnect-upnp-new.xml in you current directory.
Similarly the command for the airplay version is like the following:

docker run -it \
  --user 1000:1000 \
  --network host \
  --rm \
  -v ${PWD}:/config \
  --entrypoint /app/bin/spotraop-linux \
  giof71/spotconnect \
  -i /config/spotconnect-airplay-new.xml

The resulting file will be of course named spotconnect-airplay-new.xml.
You can then modify your configuration files to your needs and use them in the your compose file(s) by putting them in the /config volume.

⁠Run

Simple docker-compose files below.

⁠UPnP Mode

---
version: "3"

volumes:
  config:

services:
  spotconnect-upnp:
    image: giof71/spotconnect:latest
    container_name: spotconnect-upnp
    network_mode: host
    environment:
      - SPOTCONNECT_MODE=upnp
      - PUID=1000
      - PGID=1000
    volumes:
      - config:/config
    restart: unless-stopped

⁠AirPlay Mode

---
version: "3"

volumes:
  config:

services:
  spotconnect-airplay:
    image: giof71/spotconnect:latest
    container_name: spotconnect-airplay
    network_mode: host
    environment:
      - SPOTCONNECT_MODE=raop
      - PUID=1000
      - PGID=1000
    volumes:
      - config:/config
    restart: unless-stopped

⁠Changelog

The changelog of the upstream project is available here, on the upstream repo⁠.