xbmc · pannal · Nov 21, 2025
diff --git a/script.plexmod/LICENSE.txt b/script.plexmod/LICENSE.txt
diff --git a/script.plexmod/README.md b/script.plexmod/README.md
@@ -19,7 +19,7 @@ Master branch is based off of the official plex-for-kodi master branch.
 ## Installation
 
 ### Via repository (recommended)
-* Add `https://pm4k.eu` to your Kodi installation as a file source
+* Add `https://pm4k.eu` to your Kodi installation as a file source (Hit Add source in File Manager, click on the selected "`<None>`" in the list, enter `https://pm4k.eu`, OK, down, enter a name, hit OK)
 * Go to Settings->Addons, choose "Install from zip file", choose the file source you added and install the repository
 * Install Plex via Settings->Addons->Install from repository->Don't Panic->Video add-ons->Plex
 * Optional, recommended: Install Plextuary via Settings->Addons->Install from repository->Don't Panic->Look and Feel->Skin->Plextuary
@@ -29,7 +29,10 @@ Master branch is based off of the official plex-for-kodi master branch.
 * Optional, recommended: Install Plextuary skin using the above
 
 ### Manual
-* Checkout any branch of this GitHub repository, rename to `script.plexmod` and use as an addon
+* Checkout any branch of this GitHub repository, rename to `script.plexmod` and use as an addon (for it to work with "Install from zip", the contents of the zip should be the folder `script.plexmod`.
+
+### Installing to a read-only or write-protected location
+Set the environment variable `INSTALLATION_DIR_AVOID_WRITE` to any value before starting Kodi to prevent the addon from trying to write to its installation directory. Useful for package managers.
 
 ## Translation
 You can help! Join the translation effort at [POEditor](https://poeditor.com/join/project/ASOl50YAXg) (thanks for the free open source license, guys).
@@ -39,3 +42,7 @@ https://forums.plex.tv/t/plexmod-for-kodi-18-19-20-21/481208
 
 ## License
 [LICENSE](https://github.com/plexinc/plex-for-kodi/blob/master/LICENSE.txt)
+
+## Powered by
+
+[![JetBrains logo.](https://resources.jetbrains.com/storage/products/company/brand/logos/jetbrains.svg)](https://jb.gg/OpenSource)
diff --git a/script.plexmod/addon.xml b/script.plexmod/addon.xml
@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
 <addon id="script.plexmod"
        name="PM4K for Plex"
-       version="0.7.9"
+       version="1.0.5"
        provider-name="pannal">
     <requires>
         <import addon="xbmc.python" version="3.0.0"/>
@@ -15,6 +15,7 @@
     <extension point="xbmc.python.pluginsource" library="plugin.py">
         <provides>executable</provides>
     </extension>
+    <extension point="xbmc.ui.screensaver" library="screensaver.py"/>
     <extension point="xbmc.service" library="service.py" />
     <extension point="xbmc.addon.metadata">
         <summary lang="en_GB">PlexMod for Kodi</summary>
@@ -33,7 +34,7 @@
         <source>https://github.com/pannal/plex-for-kodi</source>
         <platform>all</platform>
         <news>
-- Based on 0.7.9-rev4
+- Based on 1.0.5e
         </news>
         <assets>
             <icon>icon2.png</icon>

diff --git a/script.plexmod/changelog.txt b/script.plexmod/changelog.txt
@@ -1,8 +1,189 @@
-[-0.7.9-rev4-]
-- Episodes: Clear VIDEO_PROGRESS onFirstInit; Only redirect to episode from progress if shows match
-- Collections: Fix shuffle play
-- Core/Playback/CoreELEC: Increase CoreELEC resume seek wait fix to 350ms (was 250ms)
-- Playlists: Fix shuffle/play button behaviour
+[-1.0.5d-]
+- Core/Plex.direct: Only check native resolving of hostnames containing plex.direct
+- Core/Plex.direct: Reset mapped hosts if the user skips the confirmation dialog
+- Core/Plex.direct: Fix long-existing issue with multiple servers in certain circumstances not triggering plex.direct host mapping check
+- Core/Plex.direct: Force mapping if requested
+- Core/GDM: GDM could still be reported as active under certain circumstances
+- Core/MyPlex: Consider a device that is product="Plex Media Server" as a server as well, even if it doesn't provide the correct attributes (can happen; very rare)
+- Core/PlexNet/CoreELEC: Properly report device and platform parameters to Plex.tv
+- Player: Don't throw away progress data during consecutive watch sessions; properly represent watched state in current video playlist during those
+- Player: Honor "Never show Post Play" properly even when an episode has ended
+- Player/Timeline: Never allow timeline reporting below 0 seconds
+- Player: SeekBehind: Never allow seek target to be < 0
+- Player/SeekDialog/AltSeekFix: Never react to seek attempts while we're waiting for a seek to happen
+- Player/MDE: If we don't want a subtitle, report it properly to the Plex server (still bugged, probably server-side)
+- Libraries: Move filter options out of the header area to fix overlapping music player and long filter descriptions
+- Libraries: Unify and optimize play/filter/jumplist/scrollbar navigation
+- Libraries/Listviews/Squares: Autoscroll long description texts
+- Libraries/Photos: Fix PhotoDirectory browsing
+- Library/Movies: Add filters for Writer, Producer, Editions, Audio Language, Subtitle Language, Folder Location (only if admin)
+- Library/Shows: Add filters for Director, Writer, Producer; correctly separate Studio and Network filters
+- Libraries: Store subfilter states
+- Libraries: Re-select currently selected items in filter dropdowns
+- Libraries: When re-opening applied filters, re-open all subfilter dropdowns until we reach our current one
+- Libraries: Cache subfilter content
+- Libraries: Depending on which "side" of the library view we are, when pressing "up", select either the left buttons or the right buttons
+- Libraries: Enable fast navigation through subfilter lists via scrollbar
+- Library/Movies: Allow filtering by HDR and DOVI; allow multiple boolean filters at the same time
+- Library/Photos: Fix filtering
+- Libraries: Allow filter clearing for boolean filters
+- Libraries/Movies: Add "year" and "progress" sort types
+- Libraries: Shows/Movies use sort order from PlexWeb
+- Libraries: Movies: Show current sort reference value if possible in addition to movie year
+- Libraries: Photos: Properly implement PlexWeb sort; fix display
+- Libraries/PosterSmall: Fix vertical cutoff
+- Libraries/Posters/PostersSmall: Scale and position scrollbar appropriately when moving down
+- Libraries: Re-select currently used item type and sort attribute in dropdowns
+- Dropdown: Allow opening a sublist by pressing RIGHT
+- Dropdown: Show scrollbar if a (child-)dropdown needs scrolling
+- Dropdown: Fix shadow size; perfect shadow positioning
+- PostPlay: Remove leftover bifurcation line
+- SeekDialog: Be smarter about playerprocessinfo/playerdebug/PM4K stream info (press left/right)
+- Settings: Make the combined continue watching/ondeck hub default enabled
+- Settings: Add setting "Force plex.direct mapping" (default: False)
+- Settings: Sanitize defaults ("Loop Theme Music" off vs on, "Home: Resume in-progress items" off vs on)
+- Settings: Temporarily remove "custom" theme setting as it's been broken for a while now
+- Settings: Rename "Episodes: Skip Post Play screen" to "Episodes: Continuous playback" to make functionality clearer
+- AddonSettings: widen maximum for "Use alternate seek" wait for seek to 5000 (was 2500)
+
+
+[-1.0.0-]
+CoreELEC
+- Fix issues with delayed audio playback via the alternate seek method
+- (Re-) Implemented sophisticated alternate seek method for problematic devices (brought its own quirks)
+- Gradually improved alternate seek to a stable state with community feedback
+- When switching audio track don’t trigger progress events
+
+Watchlist
+- Implement first version of the watchlist feature
+- Auto-remove watched items (movies, shows) from the watchlist (adjustable via setting)
+- Allow adding any media item to the watchlist from any media view
+- (blindly) remove item from watchlist if manually marked watched via Home or Library context menus
+- Allow visiting and playing back items on any available server with the item available, without having to manually switch servers
+- Allow selection between multiple versions, if the case, instead of only one/the first per server (ordered by bitrate)
+
+Subtitles
+- Add support for subtitle Auto-Sync (based on audio analysis, PlexServer-side)
+- Allow live-toggling of subtitle Auto-Sync in the player (overrides global setting temporarily, or per-TV-show setting)
+- Fix embedded subtitle selection when path mapping enabled
+- Add subtitle language denylist (disable subtitles for native languages)
+- Live-download subtitles via Plex (or Kodi, or both; pre-play and during playback)
+- Parse, use and store Plex account subtitle preferences
+
+Episodes
+- Fix episode progress handling
+- Try using PlexServer settings for episode completion handling
+- Improve background music handling
+- Fix play from beginning not working for context menu of episode list items
+
+Libraries
+- Massive potential speedup (5-10x) for huge libraries
+- Adhere to the library collections setting of Plex
+- Use library title in title header instead of library type
+- listview-16x9: Reimplement item type filter
+- General fixes
+
+Collections
+- Fix collections repeating themselves after CHUNKSIZE hit (240 by default); Improve performance tenfold for big collections; Implement chunking in Collection.all()
+
+Playlist
+- Fix playlist subsequent chunking (was broken) (thanks @BrendanMyers88)
+- Select the currently relevant item once it’s been created properly
+- Massively improve resource usage on big video playlists when returning from playback by only refreshing affected items
+- Correctly show and scale video progress
+
+UI
+- Mark any item as played/unplayed on Home (even in-progress ones), Libraries
+- Allow removing individual items from Continue Watching/On Deck (same as in official clients)
+- Implement fast server and user switch in Home (via long-press/context menu)
+- Visual changes to adhere more to the 2024 style (player, dropdowns, dialogs)
+- Add the ability to hide episode and movie spoilers defined by multiple user settings (titles, blur images, summaries, ratings)
+- Add the ability to always resume in progress media (also directly from home if wanted); can be overriden using long-press/context menu
+- Settings: Allow navigation using MOVE_RIGHT/LEFT; fixes
+- Unify dropdown behaviour: always allow round-robin on any dropdown; default close behaviour is pressing left or BACK/PREVIOUS_MENU
+- Core/Poster dimensions: Use 268x402 (0.66 ratio) for poster base resolution instead of 268x397 (0.675 ratio); unifies vertical scaling for posters and collection art
+- Unify bound Home key (should now work everywhere)
+- Home/Core: Don’t retain background image when switching home users
+- Home/Hubs: Use season thumbnail for episodes if possible (adjustable via setting)
+- Home: Add context menu option to start playback from beginning for in progress items when resume in progress items on home is enabled
+- Home: Make moving sections more resilient (esp. when moving fast/holding left/right)
+- Home: Add “Minimize” and “Exit” options to user menu (touch based devices can’t easily hit the exit menu by using BACK)
+- Episodes: Use season art as background if available
+- Episodes: Show correct cast per episode, not from parent show
+- Movies/Shows/Episodes: Add Directors (up to two) to the beginning of the cast list; support searching for director’s movies (currently not possible with shows/episodes)
+- Episodes/Shows/Movies: Make “go to section” action actually visit the section instead of the home hub
+- Remove most obsolete dividers in sub views
+- Movies/Episodes: Properly vertically align audio/video/subtitle labels within textures
+- Movies: Show duration for extras
+- Postplay: Scroll titles (instead of cutting them off + ellipsis); scroll multiline summaries
+- Item/AudioSettings: Don’t trim secondary title, scroll it
+
+Videoplayer
+- Modernize the usage of the Plex Media Decision Engine
+- Use bitrate instead of resolution when asking the Plex Server for a decision (better transcode behaviour, especially with HEVC)
+- Any transcode quality selection is now bitrate based, as the resolution can (and should) vary
+- Add the ability to not spoil anything during playback
+- Add fast resume/pause behaviour (use OK/ENTER to quickly resume when paused or pause when playing, instead of showing the OSD)
+- When showing stream info, pressing RIGHT will show playerprocessinfo, pressing LEFT will show playerdebug
+- Don’t skip to next episode after final credits marker was skipped if binge mode or skip postplay for TV isn’t active
+- Never show postplay for movie extras, regardless of any postplay setting
+- Allow for immediate skipping of a counting down marker (before you had to wait 1 second for that to work) (needs the respective AddonSetting enabled as well)
+- PlayerVideoCurrentPlaylist: Scroll titles if they’re too long; allow vertical round-robining at the top boundary; allow closing the playlist by pressing LEFT
+- Use uuid4() as session ID; keep session ID when switching streams; report session ID when sending timeline requests
+- Remove artificial percentage-based virtual chapters (intro/outro are still generated if necessary)
+- When stopping playback after idle, don’t start playback of next episode/playlist item
+- Fix rare occasion where immediately going to next item in playlist/season would keep the “skip prev” button disabled, when the playlist/season was started at episode 1
+- Ensure correct audio track was set after a handler was reused (skip to next video was pressed in player)
+- SeekDialog/CurrentPlaylist: Mark previous episodes/items as watched in current playlist during a multi-item playback session
+- SeekDialog/CurrentPlaylist: Show progress indicators for items in playlist; “live” snapshot of current video progress when opened as well
+
+Core:
+- Add Autoupdater (for beta releases)
+- VideoPlayer/Timeline event improvements
+- Ship certificate bundle and allow manual certificates
+- Improve background resolution by allowing a manual scale value
+- Fix Collections
+- Fix Playlists
+- Improve VideoPlaylists
+- Fix Postplay issues
+- Fix MusicPlayer
+- Migrate to InfoTags for Kodi >= 20, removes deprecation warning for setInfo
+- Fix HTTPConnection was never async. Unify Asynchronicity between HTTPConnection and HTTPSConnection via AsyncConnectionMixin
+- Add requests cache for Plex data (can also be persisted), to speed up re-visiting resource-heavy views
+- Fix core networking issues
+- Basic support for external players. Does not support seeking or resuming inside external players but tries to keep the playback and resume states (for resuming an item with an external player you’ll have to seek there yourself); only supports path mapping if the external player can access the same path PM4K sees
+- Core/Transcode/Audio: Allow audio transcode targets ‘mp3’, ‘ac3’, ‘aac’, ‘opus’, ‘vorbis’, ‘eac3’, ‘flac’, ‘alac’ (new: eac3, vorbis, flac, alac)
+- Improve audio stream type detection
+- Improve correct audio stream selection during certain events fixing Kodi quirks
+- Add setting to loop theme music (default: on)
+- Harden VideoPlayer
+- Implement cleaner shutdown functionality
+- Support custom theme.mp3 theme music for TV shows and movies (additional extensions: 'ac3', 'aac', 'opus', 'vorbis', 'eac3', 'flac', 'alac')
+- Watchlist/Core/ThemeMusic: While traversing items of multiple types (movies and shows), properly stop or start theme music if necessary
+- Support Plex markers as watched indicators
+- Check plex.direct dns rebind issues more thoroughly and don’t completely rely on the protection flags from the Plex server registry (often false); can lead to a slightly longer bootup time
+- Fix plex.direct host mapping not being triggered in certain situations (local docker IP mapped to VM for example)
+- Don’t consider a resolved plex.direct domain with IP 0.0.0.0 as “successfully resolved”
+- Force plex.direct connectivity check if the current connection has hostname issues (should fix certain setups with manual connections/LAN connections without allowing insecure local connections, falling back to plex.direct)
+- Home/Movies/Shows/Episodes/Libraries: Implement generic watched toggle; toggle watched via keyboard mapping “w” (buttonCode: 61527)
+- Home: Don’t fail hard when no currently selected server is available
+- Home: After selecting an unavailable server from the dropdown, shutdown wasn’t possible
+- Write templates to user directory instead of plugin directory when env var INSTALLATION_DIR_AVOID_WRITE is set (useful when plugin directory isn’t writable)
+- AddonSettings: Use 850ms as new default for the Alternate seek fix (was: 500ms)
+- Bring back screensaver.
+- Optionally allow direct play for resolutions above 4K
+
+Translations
+- Update translations for Spanish (100%), French (75%), Chinese (90%), Hungarian (100%), Italian (63%)
+
+Addons:
+- Provide the Plextuary skin with optimizations for CoreELEC and CoreELEC CPM
+- Plextuary: Allow customization of Exit menu
+- Add "McFontFace" Kodi font management plugin
+- Add "PM4K Log Uploader" plugin
+
+
+[-0.7.9-rev3-]
 - Player: Only send timeline events if playstate has changed or we haven't sent one for 15 seconds; fixes #137
 - AddonSettings: Fix default cert bundle setting
 - Core/plexnet/http: Fix session cert bundle usage by using the correct attribute (verify vs cert); should fix kodi 18 connectivity