Skip to content

savingaudio.mdx

Latest commit

 

History

History
102 lines (80 loc) · 3.16 KB

savingaudio.mdx

File metadata and controls

102 lines (80 loc) · 3.16 KB
Raw
title Cloud Audio Storage
sidebarTitle Cloud Audio Storage
icon cloud-arrow-up
description Set up Google Cloud Storage for saving audio files from your Omi device.

Overview

Store audio files from your Omi device in Google Cloud Storage (GCS). This guide walks you through creating a bucket, setting up credentials, and connecting it to the Audio Streaming feature.

You'll need an active Google Cloud Platform account. If you don't have one, [create one here](https://console.cloud.google.com/).

Setup

1. Go to the [GCS console](https://console.cloud.google.com/storage/browser) 2. Click **Create Bucket** 3. Configure the bucket: 
| Setting | Recommended Value |
|---------|-------------------|
| Name | Something unique, e.g. `omi-audio-files` |
| Location | Multi-region for reliability, or single region for lower cost |
| Storage class | **Standard** (for frequently accessed files) |
| Public access | **Off** (keep audio private) |
| Access control | **Uniform** |

4. Click **Create**
1. Go to **IAM & Admin → Service Accounts** in the GCP console 2. Click **Create Service Account** 3. Set the name (e.g. `omi-audio-uploader`) 4. Grant the **Storage Object User** role 5. Click **Done** 1. Click on the service account you just created 2. Go to the **Keys** tab 3. Click **Add Key → Create new key → JSON** 4. The key file downloads automatically 
<Warning>
Keep this key file secure. It grants access to your storage bucket.
</Warning>
Convert the key to Base64 for use as an environment variable: 
<Tabs>
  <Tab title="macOS / Linux" icon="terminal">
    ```bash
    base64 -i your-key-file.json
    ```
  </Tab>
  <Tab title="Windows" icon="windows">
    ```powershell
    [Convert]::ToBase64String([IO.File]::ReadAllBytes("your-key-file.json"))
    ```
  </Tab>
</Tabs>

Copy the output — this is your `GOOGLE_APPLICATION_CREDENTIALS_JSON` value.
Go back to the [GCS console](https://console.cloud.google.com/storage/browser) and copy your bucket name from the list. This is your `GCS_BUCKET_NAME` value.

Environment Variables

You'll need these two values when deploying the audio streaming service:

Variable Description
GOOGLE_APPLICATION_CREDENTIALS_JSON Base64-encoded service account key
GCS_BUCKET_NAME Your storage bucket name

Next Steps

Stream real-time audio from your device to cloud storage Create apps that use audio data