Hacktoberfest 2026: le issue che i maintainer hanno segnato per ottobre, aperte e adatte ai principianti. Sfoglia le issue Hacktoberfest

aw-notify: settingsStore integration and shared webui config surface

Aperta
  • Qualcosa non va?
#201 22 commenti 0 reazioni 1 assegnatario Vedi su GitHub

I maintainer di solito rispondono entro 1 giorno

@TimeToBuildBob ci sta già lavorando.

Dal 25/7/2026.

Valutazione

Difficoltà
4/5
Tempo stimato
3-5 giorni
Idoneità per principianti
45/100
Tipo di issue
Funzionalità
Chiarezza
Specificata chiaramente
Stato di attività
Attiva
Stack tecnologico
kotlin, python
Ambito
backend-api-design, mobile

Direzione di ricerca

Il NotifyWorker nell’app Android usa attualmente DEFAULT_ALERTS hardcoded. Per prima cosa, esamina il daemon Python desktop aw-notify per comprenderne il modello di configurazione. Poi, esamina l’endpoint dell’API settings lato server (/api/0/settings/aw-notify/alerts) per vedere come archiviare e recuperare la configurazione. Il lavoro consiste nel modificare il worker Kotlin affinché legga da questa API, creare un valore predefinito di fallback e assicurarsi che la webui possa esporre un pannello di configurazione compatibile. «Done» significa che l’app Android usa la configurazione degli avvisi memorizzata sul server e condivisa con il client desktop.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

Follow-up to #199 (merged) — centralising alert configuration so Android shares the same config surface as aw-notify on desktop.

What's missing from the MVP

The NotifyWorker shipped in #199 hardcodes DEFAULT_ALERTS directly in Kotlin. The only server-side setting it reads is startOfDay. Everything else (categories, thresholds, enabled/disabled) requires a code change.

Goals

  1. settingsStore integration — store alert config under /api/0/settings/aw-notify/alerts (or a sub-key of the existing settings namespace). The Android app reads this at worker startup instead of the hardcoded list, matching the server-side config model aw-notify desktop already uses.

  2. Shared webui config surface — once the config lives in the settings API, the aw-webui can expose a config panel identical to (or compatible with) the desktop aw-notify settings, so users manage thresholds in one place regardless of client.

  3. Reduced default thresholds — the current defaults (All at 1h/2h/4h/6h/8h, Work at 15m/30m/1h/2h/4h, etc.) are too dense for most days. Trim to 2–3 thresholds per category max, or align with whatever the desktop aw-notify defaults converge to after #200 lands.

  4. Migration path — if a user has no server-side config, fall back to a minimal built-in default (not the current verbose list) so first-run behaviour is conservative.

Out of scope here

  • Anomaly/percentile-based notifications → tracked in #200
  • App-layer quiet-hours (the OS aw_notify_channel + DnD is sufficient for now)

Cross-references

  • #199 — the initial notify implementation (merged)
  • #200 — smart anomaly-detection notifications (v2 direction)
  • aw-notify desktop — the Python daemon this should share config with
Lingua principale
Kotlin
Stelle
275
Fork
60
Merge medio
20h 32m
PR unite (30g)
38

Preparare l'ambiente

Questo progetto non fornisce container di sviluppo, Dockerfile né guida per i contributori, quindi l'ambiente è a tuo carico: parti dal suo README e consulta la nostra guida al primo contributo per i passaggi generali.

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di ActivityWatch/aw-android

Tutte le issue di ActivityWatch/aw-android

Issue simili

Altre issue su Kotlin

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.