ArrMatey日历与Activity Queue指南:如何快速掌握新片上映与实时下载监控
ArrMatey日历与Activity Queue指南:如何快速掌握新片上映与实时下载监控
ArrMatey 是一款面向 *arr 生态(Sonarr、Radarr、Lidarr 等)的免费移动端统一客户端,支持 Android 与 iOS 双平台。它的两大核心功能——日历(Calendar)与活动队列(Activity Queue),可以帮你快速掌握新片、新剧集、新专辑的上映排期,并实时监控下载任务的进度与状态。本指南用最短的篇幅,带你上手这两个模块的常用玩法。
日历与Activity Queue是什么
一句话概括:
- 日历(Calendar):汇总所有已连接 *arr 实例的「未来日程」——即将上映的电影、新剧集、新专辑、新书和有声书,支持列表与月历两种视图。
- Activity Queue:实时监控所有下载客户端的任务队列,查看进度、预计完成时间(ETA)和历史下载记录,并可对任务执行取消、加入黑名单等操作。
这两个模块分别对应源码中的核心逻辑:
- 日历状态管理:CalendarViewModel.kt
- 活动队列逻辑:ActivityQueueViewModel.kt
日历功能:一站式查看所有媒体上映排期
在底部导航进入「日历」页签(Android 端入口为 CalendarTab.kt),即可看到所有实例合并后的未来排期。日历覆盖五种媒体类型,分别来自不同 *arr 实例:
| 类型 | 来源实例 | 示例封面 |
|---|---|---|
| 电影(Movies) | Radarr | 见下图左 |
| 剧集(Episodes) | Sonarr | 见下图右 |
| 图书(Books) | Bookshelf | 见下下页 |
| 专辑(Albums) | Lidarr | 见下下页 |
列表视图与月历视图一键切换
日历提供两种展示模式(定义于 CalendarFilterState.kt):
- 列表视图(List):按日期分组,逐条列出即将上映的媒体,信息密度高,适合快速扫读。
- 月历视图(Month):以日历网格展示,每个日期下方标注当天排期,适合整体浏览「这一周有什么」。
点击顶栏的视图切换按钮即可在两者间互换,你的选择会被自动保存,下次打开仍保持原设置。
按内容类型与播出状态精准过滤
日历的筛选菜单(CalendarFilterMenu)提供以下常用开关:
- 内容类型过滤:全部 / 仅电影 / 仅剧集 / 仅专辑 / 仅图书 / 仅有声书。只关注电影党可以一键隐藏其他类型。
- 仅显示监控中(Monitored Only):只看你正在追踪的媒体,屏蔽未监控项目。
- 仅显示首映(Premieres):快速锁定每部剧集的第一集。
- 仅显示季终(Finales):关注完结集数,追剧党必备。
💡 小贴士:首映与季终筛选互斥开启,方便你在「追新」和「看完结」两种模式间切换。
一键回到今天
列表很长时容易「迷路」。日历提供了**滚动到今天(Scroll to Today)**按钮,点击即可瞬间定位到当前日期,实现路径为 ScrollToTodayButton.kt。
Activity Queue:实时掌握下载队列状态
进入「活动」页签(入口为 ActivityTab.kt),这是 *arr 生态中最重要的下载监控中心。
六大子页签各管一摊
Activity Queue 通过分段页签(定义于 ActivityTabSegment.kt)把信息分成 6 类:
| 页签 | 用途 |
|---|---|
| Activity(活动) | 当前正在进行中的下载/导入任务,含进度条与 ETA |
| History(历史) | 已完成、失败或取消的任务记录,可按状态筛选 |
| Downloaded(已下载) | 最近成功入库的媒体 |
| Blocklist(黑名单) | 被手动或规则拉黑的发行源 |
| Missing(缺失) | 队列中已失效、需要重新搜索的项 |
| Cutoff Unmet(未达标) | 质量未达到你设定最低标准的项 |
每个页签都支持按实例筛选(比如只看 Radarr 的任务),以及排序与搜索(默认按「添加时间」排序,见 ActivityQueueUiState.kt)。
自动轮询:无需手动刷新
Activity Queue 内置后台轮询机制(ActivityQueueService.kt 中的 startPolling / stopPolling),进入页面后会自动周期性拉取各实例的最新队列数据,任务状态、进度百分比和预计完成时间都会自动更新,真正做到「实时」监控。离开页面时轮询停止,避免无谓消耗。
对队列任务直接操作
发现不想要的任务?在队列中可以直接执行常见操作,无需打开 Web 界面:
- 移除(Remove):从队列中取消该任务;
- 加入黑名单(Blocklist):拉黑这个发行源,防止以后再次匹配;
- 跳过重新下载等质量相关操作。
对应后端能力封装在 ActivityQueueService.kt 与删除任务的用例 DeleteQueueItemUseCase 中。
常见问题
Q1:日历里看不到某个媒体的排期? 确认对应 *arr 实例已正确添加,并且该媒体处于「监控中」状态;若开启了「仅显示监控中」开关,未监控内容会被隐藏。
Q2:Activity Queue 一直不更新? 检查对应实例网络是否可达;开启「慢实例模式(Slow Instance Mode)」可延长超时时间,适合远程实例。
Q3:多实例之间如何区分任务? 利用页签内的实例筛选器即可按 Sonarr / Radarr / Lidarr 等实例单独查看,也可在任务卡片上直接查看来源实例。
写在最后
ArrMatey 的日历让你「提前知道什么要上线」,Activity Queue 让你「实时知道下载进行到哪」,两者配合正好覆盖了 *arr 用户的日常动线:看排期 → 等待下载 → 检查入库。上手成本几乎为零,所有设置(视图模式、筛选条件、排序方式)都会自动保存。建议先熟悉日历的内容类型过滤,再掌握 Activity Queue 的黑名单与缺失页签,这两个点能让你的媒体库管理效率提升一大截。



