I’ve been working on a new Python SDK for Jellyfin (https://jellyfin.org/).

The official Python client jellyfin-apiclient-python (https://github.com/jellyfin/jellyfin-apiclient-python) is pretty much unmaintained, and I kept running into rough edges (missing exceptions, mismatched info/config, no playlist support, etc.).

So I built a new library: jellyfin-sdk (https://github.com/webysther/jellyfin-sdk-python). It’s basically a high-level wrapper on top of OpenAPI-generated bindings, with some nicer patterns (method chaining, JSONPath, inversion of control). A few things it does differently:

- Target specific Jellyfin server versions (avoid breakage when APIs change)

- Handle multiple servers (different versions, same client)

- Drop-in replacement for the legacy client, but with fixes

- Debug mode that prints every request as `curl` (super useful when Jellyfin acts weird)

Install:

pip install jellyfin-sdk

Quick example:

import jellyfin, os

api = jellyfin.api(os.getenv("URL"), os.getenv("API_KEY"))

print(api.system.info.version, api.system.info.server_name)

Docs: https://webysther.github.io/jellyfin-sdk-python.github.io/sd...

GitHub: https://github.com/webysther/jellyfin-sdk-python

I’d love feedback — especially from anyone running Jellyfin at home and hacking around with its API.