Media-Player-Scrobbler-for-Simkl

🎬 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)
• ⏱️ Real-Time Scrobble & Watching Now – Displays live watching/paused status on Simkl and saves unfinished progress
• 🔄 Reverse Playback Resume – Automatically resumes unfinished media in MPV and PotPlayer from your Simkl saved position
• ⏳ Minimum Watch Time – Configurable threshold before scrobbling to prevent accidental scrobbles
• 🔌 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

🚦 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)