🎬 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

Loading

🚦 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