Knuckles only works with servers compatible with the REST API version 1.4.0 onwards (Subsonic 4.2+). It follows strictly the OpenSubsonic API Spec, being fully retro-compatible with the original Subsonic API.

First install the package:

python3 -m pip install knuckles

Or add it to your project:

project = [
    "knuckles>=1.0.0"
]

import knuckles

server = knuckles.subsonic(
    # Adding https:// is done automatically,
    # /rest should never be added to the URL
    url = "example.com",
    user = "kutu",
    password = "caisopea",
    client = "knuckles client"
)

ping = server.ping()

# Print the supported version of the OpenSubsonic REST API
print(ping.version)

To start making more complex interactions with the API make use of the API reference. Enjoy coding and good luck!

Created with ❤️ by Jorge "Kutu" Dobón Blanco.