> ## Documentation Index
> Fetch the complete documentation index at: https://ogh.riturajbasak.tech/llms.txt
> Use this file to discover all available pages before exploring further.

# Android Permissions That Ogh Requests and Why It Needs Them

> A complete reference to every Android permission Ogh may request, exactly when each one is asked for, and what happens if you deny it.

Ogh requests only the permissions required for the specific features you actually use. If you never select the camera as a source, Ogh will never ask for `CAMERA`. Permissions are granted at runtime — not bundled silently at install — so you always see a system dialog before Ogh can access a sensitive capability.

## Permissions reference

| Permission              | When requested                                                              | Why it's needed                                                  |
| ----------------------- | --------------------------------------------------------------------------- | ---------------------------------------------------------------- |
| `CAMERA`                | When you select Camera as your video source                                 | To capture video from the front or back camera                   |
| `RECORD_AUDIO`          | When Microphone or System Audio is selected                                 | To capture microphone input or device playback audio             |
| MediaProjection consent | When you select Screen as your video source, or System Audio on Android 10+ | To capture the screen or app audio                               |
| `POST_NOTIFICATIONS`    | When you tap **Go Live** on Android 13+                                     | To show the persistent streaming notification while you are live |

<Note>
  Permissions are requested when you tap **Go Live** — not at install time. If you change sources between sessions, Ogh will ask for any new permission the first time you go live with that source.
</Note>

## What happens when a permission is denied

Ogh is designed to degrade gracefully so a single denied permission does not break unrelated features:

* **`CAMERA` denied** — Ogh cannot start a camera session. Your microphone and system audio selections are unaffected and the stream can still proceed with another video source.
* **`RECORD_AUDIO` denied** — The requested audio source change is not applied and your previous audio selection remains active. No other part of the session is affected.
* **MediaProjection cancelled** — Session preparation is aborted immediately. No broadcast is created and Ogh returns to the ready state. You can tap **Go Live** again and choose a different source, or re-grant the MediaProjection consent when prompted.

## Revoking permissions

<Tip>
  You can revoke any permission at any time from **Android Settings → Apps → Ogh → Permissions**. The change takes effect the next time you try to use that feature.
</Tip>

## Foreground service notification

When a stream is active, Ogh displays a persistent notification so you always know the stream is running. This notification is required by Android for any app performing long-running foreground work and cannot be hidden while streaming is in progress. On Android 13 and later, Ogh requests the `POST_NOTIFICATIONS` permission when you tap **Go Live** so this notification can be shown correctly.