Skip to content

Releases: jellyfin/jellyfin-sdk-kotlin

v1.3.2

23 Jul 09:48
Compare
Choose a tag to compare

Fixed an issue where java.net.ConnectException was not mapped to the SDK's TimeoutException and adds two tiny features:

  1. Accept "minimumServerVersion" in JellyfinOptions to forcefully support older Jellyfin versions
  2. Add clientLogApi.logFileUrl to generate the URL used for crash reports

Changelog

Contributors

Compatibility

Info Jellyfin version
Minimum API Version 10.8.1
Recommended API Version 10.8.1

v1.3.1

05 Jul 16:04
Compare
Choose a tag to compare

Jellyfin 10.8.1 was released with a few changes to the API. Unfortunately this includes some breaking changes. Keep using the previous SDK release (1.3.0) If you'd like to support 10.8.0 or don't need the changes from this release.

The breaking changes in the API are:

  • Added splashscreenEnabled field in BrandingOptions
  • Added vppTonemappingBrightness and vppTonemappingContrast fields in EncodingOptions

The mentioned API models will cause an exception when using 10.8.0 or lower because they lack a value in the API responses and have no defaults set.

Changelog

Contributors

Compatibility

Info Jellyfin version
Minimum API Version 10.8.1
Recommended API Version 10.8.1

v1.3.0

11 Jun 08:08
Compare
Choose a tag to compare

Jellyfin 10.8 was just released! This version of the SDK builds on top of the API changes and guarantees compatibility. The SDK now requires the server to use 10.8 or newer because of some incompatible changes in the WebSocket code and stricter nullability in the API. We recommend using a previous SDK version (like 1.2) if you still want or need to support Jellyfin 10.7.

Significant changes in this release include:

  • WebSocket code now authenticates via HTTP header instead of URL (incompatible with 10.7)
  • Lot's of nullability fixes in the API code
  • More enums in the API (BaseItemKind is an exiting one here)

Changelog

Contributors

Compatibility

Info Jellyfin version
Minimum API Version 10.8.0
Recommended API Version 10.8.0

v1.3.0-beta.3

16 May 06:34
Compare
Choose a tag to compare

This beta bumps the versions of our used libraries and fixes an issue in POST requests (#395) that use binary data or text instead of JSON. No changes to the API in this beta.

Changelog

Contributors

Compatibility

Info Jellyfin version
Minimum API Version 10.8.0
Recommended API Version 10.8.0-beta.3

v1.2.0

26 Apr 13:16
Compare
Choose a tag to compare

I'm excited to announce version 1.2.0 of the Jellyfin Kotlin SDK. This is a relatively small release compared to the previous
v1.1.0 release. Highlights of this release are:

  • Completely rewritten WebSocket API which is easier to use and more stable
  • Refactored helper functions for Java compatibility
  • Extension functions for GeneralCommandMessage
  • Ability to change device info on Android platform

Read the migration guide at /docs/migration/v1.2.md or the WebSocket guide at /docs/websockets.md to get started
with this release.

Changelog

Contributors

Compatibility

Info Jellyfin version
Minimum API Version 10.7.0
Recommended API Version 10.7.7

v1.3.0-beta.2

19 Apr 16:52
cbdc3f8
Compare
Choose a tag to compare

This second beta updates the generated API to the second beta for 10.8. It also adds a new utility extension function for Quick Connect implementations and a bugfix in the ServerVersion comparator.

Changelog

Contributors

Compatibility

Info Jellyfin version
Minimum API Version 10.8.0
Recommended API Version 10.8.0-beta.2

v1.2.0-beta.3

19 Apr 16:49
Compare
Choose a tag to compare

This release is binary compatible with the previous beta. If no new issues are found the 1.2.0 release should follow within a few weeks.

Changelog

Contributors

Compatibility

Info Jellyfin version
Minimum API Version 10.7.0
Recommended API Version 10.7.7

v1.3.0-beta.1

17 Apr 17:26
Compare
Choose a tag to compare

This is the first beta for the 1.3.0 version of the SDK. This release only supports Jellyfin 10.8 or newer. The WebSocket code in this version does not work with 10.7 based servers because of authentication changes. The most significant changes in the API are nullability fixes and the introduction of the BaseItemKind enum. Upgrading should be fairly straightforward.

Changelog

Contributors

Compatibility

Info Jellyfin version
Minimum API Version 10.8.0
Recommended API Version 10.8.0-beta.1

v1.2.0-beta.2

10 Apr 08:29
44818c0
Compare
Choose a tag to compare

The WebSocket code now reconnects automatically and a bunch of bugfixes were made to make it more reliable. The most significant change in this beta is the move from Ktor to OkHttp as the backend for the socket code. This release is binary compatible with the previous beta, except for some smaller internal API's that are unlikely to be used directly. If no new issues are found the 1.2.0 release should follow within a few weeks.

Changelog

Contributors

Compatibility

Info Jellyfin version
Minimum API Version 10.7.0
Recommended API Version 10.7.7

v1.2.0-beta.1

26 Mar 20:21
5dd9e24
Compare
Choose a tag to compare

This is the initial beta for the upcoming 1.2.0 release. The focus for this release was rewriting the WebSocket code. It's not ready for production use until we fix a few known bugs and missing features (unnecessary reconnects on subscription changes and the lack of automatic reconnection logic). However, everything else in this beta is stable and unlikely to change until release.

Changelog

Contributors

Compatibility

Info Jellyfin version
Minimum API Version 10.7.0
Recommended API Version 10.7.7