simkl-mps 2.2.0rc1

Automatic Media 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)
• 🔌 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).

📚 Documentation

• Windows Guide
• Linux Guide
• Mac Guide
• Supported Media Players
• Usage Guide
• Local Watch History
• Advanced & Developer Guide
• Troubleshooting Guide
• Todo List

🔍 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

If you find this project useful, consider supporting development: Donate via CoinDrop

🙏 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