v1.3.0

What's New

• Backend-assisted identification — items without reliable Kodi IDs now fall back to server-side matching with confidence thresholds
• Better filename parsing — anime absolute episodes, multi-episode files (S01E01-E02), season folders, improved movie year extraction
• Library import preview — see what will be synced before importing
• Rating prompt options — configurable delay and suppression
• Debug tools — test connection, status viewer, debug export, manual queue clearing
• Stricter backend URL validation with developer mode override
• Logout safety — warns when unsynced queued events would be deleted
• Playback session IDs — prevents stale queued events from reappearing after a stop

Installation

Download script.punchplay.zip below and install via Settings → Add-ons → Install from zip file in Kodi.

script.punchplay 1.1.1

• Improve watched-threshold detection by caching playback position between heartbeat events.\n- Add playback session IDs and event timestamps to prevent stale queued progress replay.\n- Preserve PunchPlay link callback URLs through login for QR/device-code approval.

v1.1.0

New Features

• Rate after watching — a star-slider dialog (1–10) appears after a scrobble. Use left/right to change the rating, OK to confirm, Back to skip. Toggle in Settings → Scrobbling → Rate after watching.
• Kodi library sync — one-click import of all watched movies and episodes from your Kodi library into PunchPlay, with original watch dates preserved. Settings → Library → Sync Kodi Library.
• Auto-close login — the QR login dialog now closes automatically when you approve on your phone. No more two-step flow.

Improvements

• Fix false scrobble when stopping immediately after a previous watched session
• Login/logout guards — "Already connected" / "Not logged in" notifications
• Faster login poll (3s instead of 5s)

Installation

Download script.punchplay.zip below and install via Settings → Add-ons → Install from zip file in Kodi.

v1.0.3

Changes

• Fix crash on Python 3.8 (Kodi Nexus on Windows) — modern type hint syntax caused TypeError: 'type' object is not subscriptable
• Fix login poll silently swallowing HTTP errors
• Fix stale QR image on re-login
• Improved error handling and logging throughout

Installation

Download script.punchplay.zip below and install via Settings → Add-ons → Install from zip file in Kodi.

v1.0.2

Changes

• QR code login — the login dialog now shows a scannable QR code alongside the device code. Scan with your phone camera to open punchplay.tv/link with the code pre-filled. Users on a computer can still read the URL and code and type them manually.
• Falls back gracefully to the text-only dialog if the backend hasn't been updated.

Installation

Download script.punchplay.zip below and install via Settings → Add-ons → Install from zip file in Kodi.

Note

The QR feature requires the PunchPlay backend to be running version 2026-04-15 or later. Older backends will show the original text dialog (v1.0.1 behaviour).

v1.0.1

Changes

• Login dialog fix — your code now appears at the top of the dialog, so it's visible immediately without having to wait for it to scroll into view
• Heartbeat thread now stops cleanly on any unhandled error
• Offline queue WAL mode set once on DB init (not on every connection)
• Anime detection no longer matches the broad "animation" genre
• Offline queue flush loop stops on 401 so stale events don't block the queue

Installation

Download script.punchplay.zip below and install via Settings → Add-ons → Install from zip file in Kodi.

v1.0.0

Initial release of PunchPlay Scrobble for Kodi.

Installation

1. Download script.punchplay.zip below
2. In Kodi: Settings → Add-ons → Install from zip file
3. Navigate to the downloaded zip and confirm
4. Open Settings → Add-ons → My add-ons → Services → PunchPlay Scrobble → Configure
5. Click Login to PunchPlay and visit punchplay.tv/link to connect your account