Kodi repository and add-on for Scrob — the self-hosted scrobbling service for movies and TV shows.
| Directory | ID | Purpose |
|---|---|---|
service.scrob |
service.scrob |
Kodi service add-on that scrobbles playback events to your Scrob instance |
repository.scrob |
repository.scrob |
Kodi repository add-on that lets Kodi install and update service.scrob automatically |
- In Kodi, go to Settings → System → Add-ons and enable Unknown sources.
- Download the latest
repository.scrob-*.zipfrom the Releases page. - Go to Add-ons → Install from zip file and select the downloaded zip.
- Kodi will confirm that the Scrob Repository has been installed.
- Go to Add-ons → Install from repository → Scrob Repository → Services → Scrob.
- Click Install.
- Open the add-on settings (Add-ons → My add-ons → Services → Scrob → Configure).
- Set the following:
| Setting | Description | Default |
|---|---|---|
| Scrob URL | Base URL of your Scrob instance | http://localhost:7330 |
| API Key | API key from your Scrob instance | (empty) |
| Progress report interval | How often (in seconds) playback progress is sent | 60 |
- Restart Kodi (or the add-on) for the settings to take effect.
service.scrob runs as a background service in Kodi and listens for player events (play, pause, resume, seek, stop). When a movie or episode starts playing, it reads the metadata (title, year, TMDB/TVDB/IMDB IDs) and sends it to your Scrob instance via the webhook API. Progress updates are sent at the configured interval so Scrob can track your position in real time.
Only movie and episode media types are scrobbled; music and other content is ignored.
If you prefer to add the repository manually in Kodi rather than installing from a zip:
| File | URL |
|---|---|
addons.xml |
https://ellite.github.io/scrob-kodi/addons.xml |
addons.xml.md5 |
https://ellite.github.io/scrob-kodi/addons.xml.md5 |
| Data directory | https://ellite.github.io/scrob-kodi/ |
GPL-3.0-only — see LICENSE for details.