# New-recording notifications

An opt-in feature surfaced in **Settings → Notifications**. When enabled, the app watches `MediaStore` for new call-style recordings and posts a notification so the user can open the app and transcribe them.

## Flow

```mermaid
flowchart TD
    A[Settings toggle ON] --> B[Permission grants:<br/>READ_MEDIA_AUDIO + POST_NOTIFICATIONS]
    B --> C[NewRecordingMediaObserver.refreshRegistration]
    C --> D[ContentObserver on MediaStore.Audio.EXTERNAL_CONTENT_URI]
    C --> E[WorkManager unique periodic 15-min backup]
    D -->|onChange · debounced 1.4s| F[performNewRecordingScan]
    E -->|every 15 min| F
    F -->|new untranscribed call-style row<br/>past the watermark| G[PostCallNotificationHelper]
    G --> H[Notification · tap → MainActivity]
```

## Watermark

When the user enables the toggle, the app records the current `DATE_MODIFIED` timestamp as a **watermark** in `CallRecordingPrefs`. Only files with a `DATE_MODIFIED` *newer* than the watermark trigger a notification — old library files never fire.

## Dedupe

`notified_new_recording_ids` in `CallRecordingPrefs` is a set of MediaStore IDs already notified. The same file never fires twice, even across app restarts.

## Boot recovery

`BootCompletedReceiver` re-registers the `ContentObserver` after device reboot so the feature survives a restart without the user re-enabling it.

## Backup scan

A WorkManager **unique periodic** job (every 15 minutes) acts as a safety net in case the `ContentObserver` misses an event (some OEMs throttle or batch MediaStore notifications).

## No phone-state permission

Detection is purely MediaStore-based. The app does **not** need `READ_PHONE_STATE` or call logs to detect new recordings.

## Notification tap behaviour

Tapping the notification opens `MainActivity`. `EXTRA_HIGHLIGHT_RECORDING_ID` is plumbed through the intent, but the Calls tab does not yet scroll-to / pulse the highlighted row (roadmap item).

## Disabling

Turning the toggle off in Settings:

1. Unregisters the `ContentObserver`.
2. Cancels the periodic WorkManager job.
3. Leaves the watermark and dedupe set intact (so re-enabling doesn't notify for old files).

## Related

* [**Permissions**](/android-client/permissions.md) — `POST_NOTIFICATIONS` and `READ_MEDIA_AUDIO` requirements.
* [**Architecture**](/android-client/architecture.md) — `CallRecordingScanner` heuristics.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.scryon.app/android-client/notifications.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.