🎬 Media Player Scrobbler for Simkl

Automatic media tracking for all your media players

✨ Features

🎮 Supports Every Famous Media Player (VLC, PotPlayer, MPV, MPC-HC and more)
🌐 Cross-Platform – Windows, macOS, Linux
🖥️ Native Executable – System tray, auto-update, and background service (Windows)
📈 Accurate Position Tracking – For supported players (configure via Media Players Guide)
🔌 Offline Support – Queues updates when offline
🧠 Smart Media Detection – Intelligent filename parsing
🍿 Media-Focused – Optimized for every type of media (Movies,TV Shows and Anime)

⚡ Quick Start

Windows: Use the Windows Guide (EXE installer, tray app, no commands needed).
Linux: Use the Linux Guide (pipx recommended, tray app, setup command needed).
macOS: Use the Mac Guide (pip install, tray app, setup command needed, untested).

After installation, authenticate with SIMKL and configure your media players using the Media Players Guide (this step is critical for accurate tracking).

🔍 How It Works

graph LR
    A[Media Player] -->|Player Title| B[Simkl Scrobbler]
    B -->|Parse Title| C[Media Identification]
    C -->|Track Progress| D[Simkl API]
    D -->|Mark as Watched| E[Simkl Profile]
    
    style A fill:#d5f5e3,stroke:#333,stroke-width:2px
    style E fill:#d5f5e3,stroke:#333,stroke-width:2px

🚦 Performance Notes

Online:

Player Detection: ~4.2 sec
Media Info Scrobble: ~3.7 sec
Notification: ~1.5 sec
Completion Detection Delay: ~5.2 sec
Completion Sync: ~13.3 sec
Completion Notification: ~1.5 sec

Offline:

Media Scrobble: ~1.2 sec
Notification: ~0.5 sec
Completion Save: ~3 sec
Completion Notification: ~0.5 sec

📝 License

See the LICENSE file for details.

🤝 Contributing

Contributions are welcome! Please submit a Pull Request.

☕ Support & Donate

Just a little reminder! If you enjoy what I create, you can support me at https://ko-fi.com/itskavin

🙏 Acknowledgments

Simkl – API platform
guessit – Filename parsing
iamkroot's Trakt Scrobbler – Inspiration
Masyk, Ichika – Logo and technical guidance (SIMKL Devs)

🛠️ Related Tools

These tools can help organize and rename media files automatically, which can improve the accuracy and ease of scrobbling.

FileBot - Media File Renaming
TVRename - TV File Data Automation (Optional)
Shoko - Anime File Data Automation (Optional)

Made with ❤️ by kavin

⭐ Star us on GitHub • 🐞 Report Bug • ✨ Request Feature

Metadata

Release files for simkl-mps 2.4.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for simkl-mps 2.4.1
File	Size	Uploaded
simkl_mps-2.4.1.tar.gz	4.0 MB	Jul 3, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for simkl-mps 2.4.1
File	Interpreter	ABI	Platform	Reset
simkl_mps-2.4.1-py3-none-any.whl 4.1 MB Jul 3, 2026	Python 3	none	any	Details

Total release size: 8.1 MB

Release files / simkl_mps-2.4.1.tar.gz

Download URL	simkl_mps-2.4.1.tar.gz
Size	4.0 MB
Tags	Source
SHA-256 checksum How to use checksums	`6a8ce2a2b6ae6c0c1188a6addc2fbbfe3b67f6af47ddd732817198254b9bcc76`
BLAKE2b-256 checksum How to use checksums	`245f893c5fa14279616ca485b134b1e4fe9d692d8f740762bb411a237fec56a0`
Upload date	Jul 3, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`poetry/2.4.1 CPython/3.11.15 Linux/6.17.0-1018-azure`

Release files / simkl_mps-2.4.1-py3-none-any.whl

Download URL	simkl_mps-2.4.1-py3-none-any.whl
Size	4.1 MB
Tags	Python 3
SHA-256 checksum How to use checksums	`0e4a9feb75378c3561c1b4624e6b6339a08b2623a8e4f6ca64ee13f2132fe151`
BLAKE2b-256 checksum How to use checksums	`b130bb257c192b9aad474aa67b920033fb1c1e6bb2acc1573425cdf845348397`
Upload date	Jul 3, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`poetry/2.4.1 CPython/3.11.15 Linux/6.17.0-1018-azure`