> ## 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.

# Ogh Quickstart: Configure and Start Your First Live Stream

> A step-by-step walkthrough of adding your first destination, configuring quality, and starting your first live stream with Ogh on Android.

This guide walks you through everything you need to do to go live for the first time with Ogh. From adding a destination to tapping **Go Live**, the whole process takes just a few minutes. Before you start, make sure you have [installed Ogh](/installation) on your device.

## Your First Stream

<Steps>
  <Step title="Open Ogh — Settings Loads First">
    Launch Ogh from your app drawer. On a fresh install, the app opens directly to **Settings** rather than the Preview screen. This is by design: Preview is only available once you have configured at least one streaming destination. Keep Settings open and move on to the next step.
  </Step>

  <Step title="Add a Destination">
    In Settings, tap **Destinations** (or **Platforms** for YouTube/Twitch) and add at least one place to stream to. Ogh supports three destination types:

    * **Manual RTMP/RTMPS** — Enter a name for the destination, your server URL (e.g., `rtmps://live.example.com/app`), and your stream key. Use this for any RTMP-compatible service not listed below. See [Manual RTMP destinations](/destinations/manual-rtmp) for details.
    * **YouTube** — Tap **Connect YouTube** to sign in via your system browser using OAuth/PKCE. No Google Play Services required. See [YouTube destinations](/destinations/youtube).
    * **Twitch** — Tap **Connect Twitch** to start Device Auth, which opens a verification URL in your browser for you to approve. See [Twitch destinations](/destinations/twitch).

    You can add multiple destinations; Ogh encodes once and publishes to all enabled outputs simultaneously.

    <Tip>
      When adding a manual destination, prefer `rtmps://` over `rtmp://` whenever your streaming service supports it. RTMPS encrypts the connection, protecting your stream key as it travels across the network. Plain `rtmp://` sends the stream key in the clear.
    </Tip>
  </Step>

  <Step title="Configure Stream Quality and Settings">
    Still in **Settings**, scroll to the **Video** section and adjust the quality settings to match your needs and upload bandwidth:

    | Setting    | Options                                     | Default  |
    | ---------- | ------------------------------------------- | -------- |
    | Resolution | 360p, 480p, 540p, 720p, 1080p, 1440p, 2160p | 720p     |
    | Frame rate | 15, 24, 25, 30, 50, 60 fps                  | 30 fps   |
    | Bitrate    | 0.8 – 35 Mbps                               | 2.5 Mbps |

    You can also configure:

    * **Stream title, description, and privacy level** — used by YouTube when you go live. YouTube also has a **Latency** setting (Ultra Low, Low, or Normal) that controls stream delay.
    * **Pause image** — the still image shown when you use **Hide Video**. By default this is the Ogh logo; you can select any local image file from your device.
    * **Lock orientation** — keeps the app interface in a fixed orientation throughout your session. Enabled by default.
    * **Keep screen awake** — prevents your device from sleeping while Ogh is open. Enabled by default.

    <Note>
      Settings are hidden during a live session — you cannot change resolution, bitrate, destinations, or other configuration while you are streaming. Make sure everything is set the way you want it before you tap **Go Live**.
    </Note>
  </Step>

  <Step title="Open the Preview Screen">
    Once a destination is configured, the **Preview** tab becomes available in the navigation bar. Tap it to open the broadcast-control screen. You will see a large preview surface and the stream controls below it.
  </Step>

  <Step title="Choose Your Video Source">
    At the bottom of the Preview screen, tap either **Screen** or **Camera** to select your video source:

    * **Screen** — Captures your entire display (default). Ogh will request MediaProjection permission when you go live.
    * **Camera** — Captures from your device camera. If both front and back cameras are available, the button changes to **Flip Camera** so you can switch facing while live.
  </Step>

  <Step title="Select Your Audio Sources">
    Next to the source controls, choose which audio you want to include in your stream:

    * **Microphone** — Captures audio from your device microphone. Enabled by default.
    * **System Audio** — Captures audio playing from other apps on your device (requires Android 10 or newer). Enabled by default.

    You can enable both for a mixed feed, one or the other, or neither for a silent stream.
  </Step>

  <Step title="Tap Go Live and Grant Permissions">
    Tap the **Go Live** button. The button immediately changes to a disabled **Preparing…** state while Ogh:

    1. Requests any required Android permissions (camera, microphone, MediaProjection for screen/system audio).
    2. Resolves provider endpoints for YouTube or Twitch, if connected.
    3. Configures the encoder and connects to all enabled destinations.

    Grant each permission Android asks for. Once all outputs connect, the status badge changes to **Live** and your stream duration counter starts.
  </Step>

  <Step title="Manage Your Live Session">
    While you are live, you have several controls available:

    * **Screen / Camera / Flip Camera** — Switch your video source on the fly without dropping your stream or rebuilding RTMP connections.
    * **Hide Video** — Replaces your video feed with a still image (the Ogh logo or your custom pause image) while keeping audio and all RTMP connections active. Tap **Show Video** to resume.
    * **Stop** — Ends the broadcast, disconnects all RTMP outputs, and releases capture resources. You are returned to the idle Preview screen.

    When you are finished, tap **Stop** to end your stream cleanly.
  </Step>
</Steps>