• v0.0.15 9e6e298f75

    v0.0.15
    All checks were successful
    Publish Python Package to PyPI / Upload release to PyPI (release) Successful in 39s
    Build and Push Docker Image / build-and-push (release) Successful in 6m23s
    Stable

    spotizerrphoenix released this 2026-01-25 09:09:27 +00:00 | 1 commits to main since this release

    Device Identity Overrides:
    Improves on v0.0.14 by:

    • Adding robust device type logic with default values to simulate a real device
      • This changes what is sent to spotify and shown as the device type (icon) in the connect menu
    • Commit: 9e6e298f75

    Docs:

    Device Identity Prompts

    Before starting Spotify Connect discovery, the tool prompts you for device identity fields. Press Enter to accept the defaults for the selected device type:

    Example:
    - Device name: `Living Room Speaker`
    - Device type: `SPEAKER`
    - Device ID: a random 40-character hex string (generated each run)
    - Device software version: `Spotify Connect 3.2.6`
    - System info string: `Spotify Connect 3.2.6; Linux; Speaker`
    

    Valid device type values:

    UNKNOWN, COMPUTER, TABLET, SMARTPHONE, SPEAKER, TV, AVR, STB, AUDIO_DONGLE, GAME_CONSOLE, CAST_VIDEO, CAST_AUDIO, AUTOMOBILE, SMARTWATCH, CHROMEBOOK, UNKNOWN_SPOTIFY, CAR_THING, OBSERVER, HOME_THING

    Notes:

    • Defaults for device name/software/system info adjust based on the device type you choose.
    • The device type prompt is used to select a realistic profile (name/software/system info) so the advertised device looks consistent.
    • The login handshake still reports OS as OS_UNKNOWN (hardcoded in the librespot library).
    • Changing device_id between attempts will break decryption of the login blob.
    • Preferred locale is derived from the Spotify region prompt.

    Logging

    The tool enables debug logging by default so you can see what it is sending. It logs:

    • The device identity values that will be advertised and sent during authentication.
    • HTTP requests to your Spotizerr server (URLs, payload keys, and response codes).
    • Librespot and Zeroconf debug output from the underlying library.
    Downloads