Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Use Simkl's Plex webhook https://simkl.com/apps/plex/
Changes you make to webhook settings through your Plex account online usually sync to your Plex Media Server within a few minutes. The server periodically checks in with your Plex account, so it will pull down any new configurations during its next sync. If you want to speed things up, you can try one of the following:
Manually trigger a server refresh: Sign in to your Plex Media Server’s web interface and navigate through your account settings. Simply viewing or toggling related settings can sometimes prompt the server to sync sooner.
Restart the Plex server: Stopping and restarting your Plex Media Server often forces it to fetch the latest settings right away.
Sign out and back in: Log out of your Plex account on the server and then log back in. This can refresh the connection and pull down the changes more quickly.
By using these methods, you’ll usually see any webhook adjustments take effect faster than just waiting for the automatic periodic checks.
To debug you can try using webhook instead of Simkl's webhook to see if your plex is actually sending anything
Simkl TV Tracker for Windows
Keep your watch history accurate without lifting a finger. The Simkl TV Tracker app for Windows automatically detects and scrobbles TV episodes and anime you play on your PC’s media players, ensuring your Simkl profile stays up-to-date.
Simkl TV Tracker is a lightweight Windows application (beta) that:
Auto-Detects Viewing: Monitors popular media players to identify TV show and anime episodes.
Scrobbles to Simkl: Sends your watched progress directly to Simkl’s API once you reach defined thresholds.
Supports Downloaded Files: Works with files on your computer—perfect for offline or iTunes content.
Operating Systems
Windows 7, 8, 10 (32-bit and 64-bit)
Media Players
VLC (recommended), KMPlayer, GOM, iTunes, MPlayer, RealPlayer, DivX Plus, Windows Media Player, PowerDVD, BSPlayer, Winamp, MPC-HC, AVS Media Player, FLVPlayer4Free, et al.
Driver & Tracker
A background driver monitors all video files opened on your PC.
The Tracker app reads file metadata (e.g., filename, metadata tags) and matches it against Simkl’s database.
Detection & Scrobbling
Download Personal Installer
Visit Apps → Automatic Trackers → TV Tracker on Simkl ()
Click Download (includes your unique account key).
Run Installer
Open a TV Episode File
Play any supported file in your favorite media player.
A detection popup appears after ~7–15 seconds (longer for rare anime).
Watch & Scrobble
Movies Not Scrobbled: Only TV shows and anime episodes are tracked.
Beta Version: May contain bugs—please report any issues on Simkl’s Discord #bugs-tracker.
Mac, iOS, Android: Coming soon! For now, Manual and Chrome Extension tracking serve macOS and mobile users.
No Detection Popup
Rename your file to match Show.Title.S01E01 format.
Switch to VLC for best detection success.
App Freezes
With Simkl TV Tracker, build a fully automated, accurate watch history without manual checkmarks. Enjoy seamless tracking across your Windows PC!
File Types
Standard: .avi, .mkv, .mp4, .m4v
Partial Downloads: .crdownload, .part, .ts
When you start an episode, the Tracker displays a small popup (bottom right corner) identifying the show and episode number.
If you watch 70% or more, the Tracker sends a “watched” ping to Simkl’s API.
If you close the player before reaching 70%, the episode may still be scrobbled once Playback stops.
Taskbar Icon Indicators
Running, waiting for video file
Trying to detect video file
Detected TV Show & episode (awaiting 70% watched)
Could not detect this video file
Marked episode as watched
Double-click the downloaded .exe file.
Wait for it to install and you are done!
Let the episode play until at least 70% is buffered.
Tracker auto-marks the episode as watched on Simkl.
Managing Issues
If no popup appears, ensure:
The file name includes the show’s title and episode number (e.g., Show.Name.S02E05.mkv).
Supported media player and file type.
Driver Freeze Workaround:
Uninstall conflicting Microsoft Visual C++ versions via Control Panel → Programs & Features.
Open Control Panel → Programs & Features.
Uninstall all Microsoft Visual C++ redistributables.
Reinstall the Tracker app.
Partial File Detection
If playing .crdownload files, ensure they’re >70% complete for correct scrobbling.
Scroll down to General section where you will find Simkl TV Tracker plugin. Short link: http://localhost:8096/web/index.html#!/plugins/plugincatalog.html
Click install
Restart Emby server
Open plugin settings and click log in, click the PIN link (you should be automatically logged in) and come back to Emby. If you see a blank settings page at this point, refresh the page and then you'll be able to see your Simkl profile name which means you are logged in and can change the settings.
Instead of using your custom domain, open the IP URL of your Emby server and you should not have any issues with the login.
Open your seedbox settings and click the Remote (WAN) access IP URL
Now you should be able to log in to Simkl the add-on settings.
If you're using Emby with an NGNIX proxy server, or your own custom domain, you may need to add some config in ngnix like in the screenshot below, to fix the issue.
When you watch 70% of the video on Emby (configurable in Add-On options), Simkl Add-on will send a ping to the Simkl API that you watched the video and Simkl will mark this video as watched in your Simkl profile.
Simkl Add-On for Emby can detect and mark TV Shows, Anime episodes, and Movies that you watch on your Emby Media Player.
Even when Emby could not recognize the video you’re watching, it will send the filename to Simkl as well, which has a better detection library, especially for Anime filenames so everything that you watch can be recognized and marked as watched.
Yes! Check the code on GitHub
Please report any bugs at https://github.com/SIMKL/Emby/issues
location /Simkl {
rewrite ^/Simkl/(.*)$ /***YOUR CUSTOM URL***/Simkl/$1 last;
}
Cross-Platform Tracker for Windows, macOS, and Linux
Media Player Scrobbler is a community-developed, open-source tracker that connects your local media players to your Simkl account.
It detects what you’re watching in real time and updates your Simkl watch history automatically across all major operating systems.
Works on Windows, macOS, and Linux. Ideal for users who watch content on multiple platforms or want an open-source alternative to the Simkl TV Tracker.
Media Player Scrobbler (MPS) is a cross-platform application that automatically tracks what you watch on your media players and updates your Simkl profile in real time.
It works silently in the background, detecting playback from supported media players (VLC, MPV, PotPlayer, MPC-HC, MPC-BE, etc.), identifying the movie/episode based on filenames, tracking progress, and marking items as watched once you reach a set threshold (default: 70%).
MPS supports Movies, TV Shows, and Anime, provides offline support, and works on Windows, macOS, and Linux.
Best results: VLC and MPV are recommended for best accuracy.
The Media Player Scrobbler runs quietly in the background and links your player activity to your Simkl profile.
Step-by-step Breakdown:
Detect Playback MPS monitors supported players for active video playback.
Extract Metadata Uses the filename + player title to identify the media.
Identify Movie or Episode
Matches filename data to Simkl’s database (e.g., Show.Name.S01E03.mkv).
Download & Setup
Download the latest installer from GitHub:
Right-click → Run as Administrator
Follow the setup wizard:
Accept the license
The Scrobbler launches automatically.
Log in with your Simkl account when prompted.
A system tray icon appears — that means it’s active.
Related Links:
Ensure Python 3.9+ and pipx are installed:
Authenticate with your Simkl account.
The tray icon will appear — tracking is now live.
Add this to Startup Applications:
⚠️ macOS support is under testing; some features may behave differently.
or
Authenticate when prompted.
Grant accessibility permissions if asked.
Tray icon shows app status.
After installation, configure your player for accurate detection.
Go to Tools → Preferences → Interface → Web.
Enable Web Interface.
Restart VLC.
Create or edit:
Paste the plugin script (from GitHub media-players guide).
Open Options
Go to Player → Web Interface
Enable
Set a password
No setup required — fully supported out of the box.
Media Player Scrobbler includes a built-in Local History Viewer, allowing you to browse your watch history in your browser.
Analyze your locally tracked movies, TV shows, and anime directly in your browser.
Unified history for all media types
Search, filter, and sort by type, title, or year
Grid/List modes with dark/light toggle
Episode and movie details with runtime breakdown
Open the watch-history-viewer folder.
Open index.html in a browser.
The viewer loads from your local data.js history file.
Use clean filenames:
Movie.Title.2023.mkv
Show.Name.S01E04.mp4
Configure your player properly (see Media Player Configuration).
Some players hide titles in fullscreen — disable fullscreen title hiding.
Restart the app
Check hidden system tray icons
Ensure desktop environment supports tray apps (Linux/Mac)
Enable VLC Web Interface
Ensure the password matches the configuration file
Run debug mode:
Media Player Scrobbler is the most flexible and powerful tracking solution for Simkl users who want:
automatic scrobbling
full media support (movies, TV, anime)
cross-platform compatibility
offline syncing
Whether you're on Windows, macOS, or Linux, MPS ensures your watch history stays accurate, instant, and fully synced, no manual effort required.
If used with properly configured media players, Media Player Scrobbler provides the most reliable and seamless playback tracking experience available for Simkl.
How to Set Up Simkl on Kodi?
The Simkl Add-On for Kodi allows you to automatically track what you’re watching on your media player.
It connects your local playback data to your Simkl account, so when you watch a TV show, anime, or movie, Simkl updates your progress in real-time.
Whether you’re binging a new season or watching offline files, Simkl makes sure your watch history stays perfectly synced.
When you watch 70% of a video on Kodi (default threshold, configurable in Add-On settings), the Simkl Add-On sends a ping to the Simkl API, marking that episode or movie as “watched” on your profile.
Mark as Watched When you reach 70% completion (default), it sends the scrobble.
Sync to Simkl Updates appear instantly on your Simkl profile. Offline? No problem — MPS will sync everything once you're online.
▶️ Start/Pause Tracking
Toggle live tracking
📜 Status Info
Shows current player detection and connection state
⚙️ Tools
Access logs, configuration, and debugging
🔄 Check for Updates
Installs new versions automatically
❌ Exit
Closes the background service
🟢 Running
Active and tracking media
Tracking active
🟡 Paused
Temporarily suspended
Tracking paused
🔵 Stopped
Idle but ready
App idle but running
🔴 Error
Connection or API issue
Choose install location
Enable Auto-start on login (recommended)
Enable Auto-update checking
Statistics via interactive charts
Built with plain HTML, CSS, and JavaScript (no frameworks)
🪟 Windows
✅ Stable
Native EXE installer, auto-start, tray app
🐧 Linux
✅ Stable
Install via pipx, tray app supported
🍏 macOS
⚠️ Experimental
pip installation, tray app (permissions required)
Windows
Use .exe installer → runs from tray
No commands needed
Linux
pipx install simkl-mps → tray app
Requires setup command
macOS
pip install simkl-mps[macos] → tray app
Experimental / untested
Authentication failed
Run simkl-mps init --force
No movie detected
Ensure proper filename: Movie.Title.(Year).ext
App won’t start
Run as admin (Windows) or check simkl_mps.log
Offline sync delay
Wait until reconnect; queued scrobbles will upload
Windows
%USERPROFILE%\simkl-mps\simkl_mps.log
macOS
~/kavin/simkl-mps/simkl_mps.log
Linux
~/.kavin/simkl-mps/simkl_mps.log
Simkl’s add-on can:
Detect and track TV Shows, Anime Episodes, and Movies.
Recognize files using TVDB and TMDB metadata.
Fall back on filename recognition for unmatched videos (great for anime or custom library names).
Even if Kodi fails to identify a title, Simkl can still detect it through its filename and database matching ensuring your progress is never lost.
Simkl features an official Kodi addon that you can install from the Kodi official repository.
Follow these steps to install the Simkl addon on Kodi:
Open Kodi
Navigate to Settings:
System → Settings → Add-ons → Install from repository → Kodi Add-on repository → Services → Simkl TV Tracker
Select the Addons folder.
Click Install from repository.
Select Kodi Addon Repository.
Click on Services.
Choose Simkl TV Tracker.
Click Install to download the SIMKL TV Tracker addon.
The addon will be downloaded in a few seconds. You should see a Simkl TV Tracker Addon Installed notification at the top right.
You’ll be prompted to authorize your Simkl account with Kodi using a code.
If the login prompt doesn’t appear:
Go to Settings → Add-ons → My Add-ons → Services → Simkl → Configure → LogIn
Visit https://simkl.com/pin on your phone or computer browser.
You’ll be prompted to log in to your Simkl account.
Once you have signed in, Simkl will ask you to allow Kodi Scrobbler to use your account. Select Yes.
You’ll see a Congratulations notification.
Kodi Addon is now connected to your Simkl account.
Simkl’s main TV metadata source is TheTVDB, with connected TMDB IDs linked internally.
To ensure accurate scrobbling:
Switch to TVDB under your Kodi library settings.
Keep your Simkl add-on logged in and active.
After installation, you can adjust how the Simkl Add-On behaves:
Open Kodi & Navigate to Settings Page
Select the Addons folder.
Select My add-ons.
Scroll down, to find Services
Here select SIMKL TV Tracker
Click Configure
Open the Options tab. Each setting below is live as soon as you click OK.
What it does: If ON, Kodi automatically marks what you watch as “watched” on your Simkl profile, no buttons to press.
Recommended: ON (default). Turn OFF only if you want to scrobble manually.
What it does: Sets how much of the video must be watched before Simkl marks it as watched.
Default: 70%
When to change:
60–70% if you often skip credits and want reliable scrobbles.
80–90% if you want stricter completion (e.g., you pause a lot or scrub around).
Example: A 120-minute movie at 70% will scrobble after ~84 minutes watched.
What it does: Shows a small on-screen confirmation bubble when Simkl records the watch.
Recommended: ON while testing; turn OFF later if you prefer a clean screen.
What it does: Ignores short clips under this duration to avoid logging trailers, promos, or intros.
Default: 5 minutes
Good ranges:
3–5 min if you watch a lot of short-form anime/OVAs.
8–10 min if you frequently open trailers or bonus clips and don’t want them scrobbled.
Click OK (top-right of the dialog) to apply.
Defaults restores the add-on’s original values.
Cancel discards any changes you made.
Nothing scrobbles at all
Re-open Configure → LogIn and sign in again.
Ensure Auto-scrobble is ON.
Confirm you watched past the Scrobble at percentage threshold.
Increase Minimum file length if trailers are being logged; decrease it if short episodes aren’t.
Verify your device has internet access when playback ends.
Episodes marked incorrectly / not found
Switch the Kodi TV source to TVDB (especially for anime and multi-cut shows).
Make sure your files have clean names (season/episode tags help: Show.Name.S01E03).
Double scrobbles or odd duplicates
Avoid stopping/starting around the threshold repeatedly.
Keep Scrobble at percentage at least 60% to prevent edge triggers.
Media Player → Player Title → Simkl Scrobbler → Parse Title → Identify Media → Track Progress → Simkl API → Mark as Watched → Simkl Profilesudo apt install python3 python3-pip pipxpipx install simkl-mpssimkl-mps traysimkl-mps tray --autostartpip install "simkl-mps[macos]"pipx install "simkl-mps[macos]"simkl-mps tray~/.config/mpv/scripts/simkl.luasimkl-mps tray --debugError (API/auth/player detection)
