# Web app recorder (https://test.sageox.ai/docs/context-capture/web-app-recorder)

# Web app recorder

The SageOx web app recorder lets you capture team discussions directly from your browser. Recordings are automatically transcribed and feed into your Team Context.

## Accessing the recorder

### From the web app

1. Navigate to your team's **Media** section
2. Click **Record** to open the recorder
3. Or go directly to: `https://sageox.ai/team/{your-team-id}/media/record`

### From mobile (iPhone, Android)

The recorder works in any mobile browser. For the best experience, add it to your home screen.

## Add to home screen

Adding SageOx to your home screen gives you:
- One-tap access to the recorder
- Standalone app experience (no browser chrome)
- Faster launch times

### Safari (iPhone/iPad)

1. Open `sageox.ai` in Safari
2. Tap the **Share** button (square with arrow)
3. Scroll down and tap **Add to Home Screen**
4. Tap **Add** to confirm

The app will appear on your home screen as "Record" with the SageOx icon.

### Chrome (Android)

1. Open `sageox.ai` in Chrome
2. Tap the **three-dot menu** (⋮)
3. Tap **Add to Home screen**
4. Tap **Add** to confirm

## Recording a discussion

### Before recording

On the entry screen, you can optionally add:
- **Title** - Name your recording (auto-generated if blank)
- **Participants** - Tag who's in the discussion
- **Intent** - What type of discussion (standup, design review, etc.)
- **Context** - Notes for the AI to understand the recording

### During recording

The minimal recording interface shows:
- **Timer** - Duration of current recording
- **Waveform** - Visual audio feedback
- **Pause/Resume** - Temporarily stop audio capture
- **Stop** - End recording and begin processing

You can also:
- Edit the title
- Add or remove participants
- Add context notes
- Take photos (for whiteboard captures, diagrams)

### After recording

When you stop:
1. Recording is uploaded to SageOx
2. AI transcription begins automatically
3. Speaker identification runs on the transcript
4. You're redirected to the recording detail page

## Features

### Real-time upload

Audio chunks are uploaded as you record, not after you stop. This means:
- No waiting for upload after recording
- Audio already uploaded is not lost if your connection drops
- Works on slow connections

### AI transcription

Recordings are automatically transcribed with:
- Speaker diarization (identifies different voices)
- Timestamps for every segment
- Searchable transcript text

### Speaker assignment

After transcription, you can:
- Match detected speakers to team members
- Listen to voice samples for each speaker
- Jump to specific quotes in the audio

### Photo capture

During recording, tap the camera icon to:
- Capture whiteboard content
- Save diagrams and sketches
- Reference photos are attached to the recording

## Mobile limitations

Mobile browsers have limitations that affect recording:

### Background audio

**iOS Safari and Android Chrome stop recording when you switch apps.** This is a browser security restriction, not a SageOx limitation.

If the recording stops due to app switching:
- Audio captured before leaving is preserved
- You'll see a notification when returning
- The partial recording is still accessible

### Battery and storage

- Long recordings use significant battery
- Audio is uploaded in real-time (uses data)
- Consider WiFi for recordings over 30 minutes

## Troubleshooting

### Microphone permission denied

1. Open your browser settings
2. Find SageOx in site permissions
3. Enable microphone access
4. Reload the page

### Recording won't start

- Check that another app isn't using the microphone
- Try closing other browser tabs
- On mobile, ensure the device isn't on Do Not Disturb

### Poor audio quality

- Move closer to the microphone
- Reduce background noise
- Check if you're using the correct microphone (laptop vs headset)

## What's next

- [Discussions](/docs/context-capture/discussions) - Managing recorded content
- [Getting Started](/docs/getting-started) - Full setup guide
