Media-Player-Scrobbler-for-Simkl

一个跨平台应用，自动追踪你的媒体播放器播放情况，并同步你的SIMKL账户的进度。

  • 语言Python
  • 默认分支main
  • 大小13.8 MB
  • 更新2 天前
在 GitHub 打开
avatarByteTrix
70
82
GNU General Public License v3.0

项目介绍

ByteTrix/Media-Player-Scrobbler-for-Simkl 是一个托管在 GitHub 上的开源项目，主要使用 Python 编写，采用 GNU General Public License v3.0 许可证，目前获得 70 个 Star、8 次 Fork。

仓库全名
ByteTrix/Media-Player-Scrobbler-for-Simkl
开源许可证
GNU General Public License v3.0
Star 数
70
Fork 数
8
未关闭 Issue
2

README 摘要

🎬 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 &…

完整内容见 GitHub 原始 README 或本页 。

常见问题

Media-Player-Scrobbler-for-Simkl 用什么语言开发？

主要使用 Python 编写，采用 GNU General Public License v3.0 许可证，目前有 70 个 Star。

Media-Player-Scrobbler-for-Simkl 可以免费商用吗？

仓库标注的许可证为 GNU General Public License v3.0，商用前请先阅读仓库 LICENSE 文件确认授权范围。

如何获取 Media-Player-Scrobbler-for-Simkl 的源码？

可以直接克隆仓库：git clone https://github.com/ByteTrix/Media-Player-Scrobbler-for-Simkl.git，默认分支为 main；安装与运行步骤见仓库 README。

Media-Player-Scrobbler-for-Simkl 最近还在维护吗？

仓库最近一次更新为 2 天前，当前有 2 个未关闭 Issue；Star 数为 70，可作为社区活跃度的参考。

本页面展示项目元数据与原始 README，GitRead 中文社区 编辑团队负责选题收录。

相关仓库

public-apis/public-apis avatar
public-apispublic-apis
16 小时前
497.1k
54.1k
65

免费 API 汇总列表

apipublic-apisfree+7
Python
15.5 MB
7
详情
EbookFoundation/free-programming-books avatar
free-programming-booksEbookFoundation
17 小时前
401.3k
67.4k
95

免费可获取的编程书籍

bookseducationhacktoberfest+2
Python
21.8 MB
3
详情
donnemartin/system-design-primer avatar
system-design-primerdonnemartin
9月15日
377.3k
59.2k
643

学习如何设计大规模系统。为系统设计面试做准备。包含 Anki 闪卡。

designdesign-patternsdesign-system+10
Python
11.0 MB
0
详情
vinta/awesome-python avatar
awesome-pythonvinta
1 天前
333.3k
28.0k
0

回答“我想用 Python 做 X，该用哪个工具？”的权威清单

awesomeawesome-listpython+3
Python
6.8 MB
2
详情
practical-tutorials/project-based-learning avatar
project-based-learningpractical-tutorials
6 天前
289.3k
36.8k
239

精选的项目实战教程列表

tutorialprojectbeginner-project+5
Python
473 KB
1
详情
NousResearch/hermes-agent avatar
hermes-agentNousResearch
1 小时前
261.6k
58.1k
53.7k

与你共同成长的智能体

aiai-agentai-agents+10
Python
1.3 GB
3
详情
TheAlgorithms/Python avatar
PythonTheAlgorithms
5 天前
226.0k
51.3k
90

所有算法均用 Python 实现

algorithmalgorithm-competitionsalgorithms-implemented+11
Python
17.9 MB
2
详情
yt-dlp/yt-dlp avatar
yt-dlpyt-dlp
4 天前
206.1k
17.9k
2.1k

功能丰富的命令行音视频下载器

youtube-dlpythonsponsorblock+4
Python
63.5 MB
0
详情

关于

GitHub 原始描述（英文）

A cross-platform application that automatically tracks media playback from your media player and synchronizes your progress with your SIMKL account.

描述取自 GitHub 官方 API，保持仓库作者书写的原文。

简要分析

热度分
89
价值分
44
活跃状态
活跃
media-trackermpc-hcmpv-playermpv-wrapperscrobblesimklsimkl-apisimkl-trackersimkl-tv-trackervlc-media-player
GitHub

语言占比

CSS
HTML
Inno Setup
JavaScript
PowerShell
Python
Shell

Release

贡献者

itskavinitskavindependabot[bot]dependabot[bot]CopilotCopilotErayRonaldErayRonaldJinxAgainJinxAgain

README

🎬 Media Player Scrobbler for Simkl

Platform Ask DeepWiki

SIMKL MPS Logo
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

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

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)

评论

暂无评论