ActivityWatch / ActivityWatch/aw-android

aw-notify support: activity-based notifications on Android

Aberta
#196 3 comentários 0 reações 0 responsáveis Ver no GitHub
Linguagem predominante
Kotlin
Estrelas
265
Forks
57
Merge médio
2d 21h
PRs com merge (30d)
19

Descrição

## Problem

Add `aw-notify` support to aw-android so users can opt into activity-based notifications such as per-app time alerts or category-budget nudges. The Android product behavior is not specified yet; this issue should define that behavior before implementation rather than assume a direct port of the desktop daemon.

PR #195 provides the Android 13+ `POST_NOTIFICATIONS` permission needed for any user-visible notification.

## Discovery scope

Before choosing an implementation, answer:

- Which first notification use case delivers enough value to ship?
- Is the rule engine shared with [`aw-notify`](https://github.com/ActivityWatch/aw-notify), ported, or Android-specific?
- Where are rules configured, and how can users disable or snooze them?
- What cadence and execution mechanism preserve battery life and Android background limits?
- Should evaluation query the local aw-server-rust API, consume watcher events directly, or use another boundary?
- How do quiet hours, duplicate suppression, timezone changes, and Do Not Disturb behave?

## Candidate MVP (not yet committed)

A WorkManager periodic task could evaluate one locally configured threshold against the on-device aw-server-rust data, post via `NotificationCompat`, and persist enough state to avoid duplicate alerts. Android periodic work has a 15-minute minimum interval, so this is appropriate for coarse summaries or budgets, not exact real-time limits.

## Acceptance criteria

- [ ] A concrete MVP use case and rule semantics are documented
- [ ] Notification opt-in/configuration UX is specified
- [ ] Scheduling, battery, and Android background-execution trade-offs are documented
- [ ] Duplicate suppression, quiet hours, timezone changes, and unavailable local server are covered
- [ ] The implementation boundary relative to desktop `aw-notify` is decided
- [ ] A scoped implementation issue or PR is created from the design

## Out of scope

- Implementing all desktop `aw-notify` features in the first Android slice
- Server-driven or cross-device notifications before sync is ready
- Treating the always-on foreground-service status notification as an `aw-notify` feature

## Related

- #195 — `POST_NOTIFICATIONS` manifest permission and runtime request
- #189 — v0.14.0 tracking issue
- Desktop project: https://github.com/ActivityWatch/aw-notify

Guia de contribuição

Nenhum guia de contribuição indexado para este repositório

Avaliação

Esta issue ainda não foi avaliada.

Receba novas issues na sua caixa de entrada

Um resumo curto de issues do GitHub para quem está começando.