4.15.7

Breaking Changes

• Added subtitleStream as first argument to Video.removeSubtitles (#1305)

Bug Fixes

• #1300 - Fix building documentation
• #1304 - Guard against None parentIndex
• #1308 - Fix subtitleLanguage attribute

New Features

• #1303 - Add lyricStreams() convenience method
• #1305 - Add support for on-demand subtitles

Improvements

• #1298 - test: fix test_audio_Audio_sonicallySimilar authenticated test
• #1306 - Remove DeprecationWarning for watched methods
• #1310 - docs: update butler tasks info

---

Thanks to new contributor @iDentitY4.

4.15.6

Bug Fixes

• #1287 - Fix batchMultiEdits() for collections

New Features

• #1284 - Use edit mixins for Playlists
• #1286 - Add support for 'group' and 'having' keys in smart filters
• #1288 - Add sonicallySimilar method to Audio class
• #1293 - feat: add PlexPartialObject.isLocked method

Improvements

• #1294 - tests: improve audio tests
• #1289 - style(typehints): replace string typehints
• #1295 - doc: fix documentation for BaseResource.provider
• #1297 - Fix flake8 #1295

---

Thanks to new contributor @zdimension.

4.15.5

Bug Fixes

• #1265 - Passing params for setSelectedSubtitles streams
• #1281 - fix: explicitly set includeFiles
• #1269 - Return None for history source if media no longer exists
• #1276 - Update algorithm for parsing smart filters

New Features

• #1271 - Add MyPlexAccount.ping() to refresh authentication token

Improvements

• #1266 - docs: fix readthedocs build
• #1277 - Update documentation for collection.sortUpdate.
• #1282 - build(pypi): verify readme and add long_description_content_type

---

Thanks to new contributors @ShanaryS, @jasmeralia, and @Dr-Blank.

4.15.4

Bug Fixes

#1262 - Fix datetime returning UTC
#1263 - Fix isLatest() and add canInstallUpdate()

Improvements

#1258 - ci: adjust plexapi timeout

4.15.3

Bug Fixes

• #1260 - Fix handling of live TV sessions

4.15.2

Breaking Changes

#1247 - Remove reload after saving the batch-edits

Bug Fixes

#1239 - Change Discover search URL
#1253 - Fix PlexServer.isLatest() check

New Features

#1241 - Add X-Plex-Language header to config

Improvements

#1240 - ci: retry bootstrap step
#1244 - Fix invalid escape sequence DepreactionWarning
#1245 - test_audio: Add missing assert
#1250 - Suppress toDatetime error when subscribedAt is empty
#1251 - Change Episode parent* attributes to properties

---

Thanks to new contributors @twolaw, @darthShadow, and @BenjaminOddou.

4.15.1

Bug Fixes

• #1201 - Fix documentation search
• #1216 - Validate empty items explicitly when editing items
• #1231 - Fallback timeout from constructor in query()

New Features

• #1204 - Add method to retrieve Plex server identity
• #1205 - Add methods to retrieve public IP and geolocation
• #1207 - Add properties to return the Plex Media Server data metadata paths
• #1219 - feat(alert): add option to use custom socket

Improvements

• #1203 - Improve parsing to datetime and add error handling
• #1206 - Rename "setDefault" to "setSelected" for media streams
• #1209 - Fix ElementTree DeprecationWarning when testing truth value (Python 3.12)
• #1220 - docs(readme): fix typos
• #1221 - style: fix F812 rule
• #1222 - docs: add Windows make file
• #1227 - Tests skip additional tests that require plex pass
• #1228 - style: lint all python files
• #1229 - test: add codeql analysis
• #1230 - Simplify PlexPartialObject eq return

4.15.0

Breaking Changes

#1129 - Update MyPlexAccount to use Plex API v2
#1133 - Update MyPlexResource to use Plex API v2
#1170 - Remove optional title argument from PhotoSection.searchAlbums() and PhotoSection.searchPhotos()
#1185 - Create separate PlexHistory objects
#1198 - Remove support for Python 3.7

Bug Fixes

#1169 - Change server continue watching endpoint
#1182 - Check object is instance of PlexPartialObject for __eq__ comparison

New Features

#1184 - Add LibrarySection methods to multi-edit items
#1186 - Add score and tagKey attribute to hub search results
#1187 - Add config option to disable auto-reloading
#1190 - Add SubtitleStream attributes for on-demand subtitles
#1191 - Add search kwargs to LibrarySection.get()

Improvements

#1164 - Update PyPI workflow to use trusted publishing
#1166 - Set Sphinx language to en
#1171 - Add job dependency and environment to pypi workflow
#1192 - Add music library language to bootstrap test server
#1195 - Fix MyPlexAccount tests
#1196 - Fix movie edition tests

---

Thanks to new contributor @fabricionaweb.

4.14.0

Breaking Changes

#1132 - Change updateProgress and updateTimeline to return self

• updateProgress() and updateTimeline() no longer auto-reload. Chain methods to reload (updateProgress().reload() and updateTimeline().reload()).

Bug Fixes

#1160 - Fix mutable default args for resource connection
#1163 - Pass session from MyPlexAccount to server/device connection

New Features

#1090 - Add support Discover isPlayed/markPlayed/markUnplayed
#1131 - Add support for Continue Watching hubs
#1134 - Add Chapters to Track
#1154 - Allow using MyPlexUser object for switchUser

Improvements

#1109 - Raise Exceptions on bad Download Responses
#1138 - Detect invalid token with myplex
#1142 - Do not add blank string to secrets log filter
#1144 - Fix code block doc string formatting
#1143 - Refactor fetchItems for pagination
#1155 - Read version from file instead of import in setup.py

4.13.4

Bug Fixes

#1123 - Fix missing markers attribute for Movie