Mac 的延时动态

电池、应用和音乐的公开动态。Mac 每 5 分钟上传最近 15 分钟的变化，通常延时 7 分钟播放，普通应用／歌曲切换约每 2 秒合并显示，减少闪动；首包到达前等待有效窗口，取得窗口后暖机；缺少覆盖时停止播放。

正在读取查看时间窗口 ↗

电池未公开等待新快照

前台应用

未公开

仅公开应用名称

Apple Music · 等待新快照

♫

——

系统负载 · 1 分钟—5 分钟 — · 15 分钟 —

运行中的 GUI 应用

未公开

应用原生图标 · © 各软件作者 · 图标 API · 来源与使用说明

只显示已观测且有效的内容 · 读取中

API 快速调用

需要什么	GET 路径	返回内容
动态窗口	/api/timeline	基线、事件、缺口、播放策略；适合客户端连续播放
单个完整切片	/api/now	音乐（含可选 URL）、应用、电池与负载；buffered 延时 7 分钟
音乐小组件	/api/music	歌名、歌手、可空的封面与歌曲 URL
前台应用	/api/apps/active	应用名、静态图标与图片 API 地址
运行应用	/api/apps/running	名称与图标对象数组，未采集为 null
电池与负载	/api/device	device.battery、device.system
固定应用图标	/api/icons	随部署发布的原生 PNG 清单

本页每 60 秒只请求一次 /api/timeline，其余变化在内存播放；短时间连续切换只展示最后候选，时间线 API 中的已有事件保留。敏感遮蔽、清空与断档会立即撤掉旧显示。简单页面每轮只读一次 /api/now；四个分类接口各自读取一次 KV，不要并行轮询全部入口。封面优先使用 Mac 上报的 URL，缺少有效 URL 时保留浏览器兼容查询。curl 与图片示例 · 浏览图标与复制地址 · 完整 API

在你自己的 Mac 上使用

MacFlare 本机只使用系统自带工具。部署一次后，由 macOS 原生 launchd 定时推送；无需第三方后台管理器或播放器。

文档导航 按「部署自己的状态页」「接入现有 API」「维护和贡献」提供完整阅读路径。

从哪里开始	文档
部署自己的状态页和 API	快速开始
绑定域名、更新与回滚	部署指南
隐藏应用、选择更新模式	本机配置
延长免费额度的使用时间	额度与更新策略
接入博客或 README	接入示例
查看 JSON 字段和错误码	API 参考

默认 buffered 每 5 分钟上传一个窗口，每日定时写入约 288 次，比 eco 减少 60%。网页显示延时状态，不代表设备此刻可连接或用户在场；KV 最终一致和采集缺口可能使播放暂停。时序与恢复设计 · 隐私与数据边界