# Getting Started

Get Audion up and running in just a few minutes.

## System Requirements

- **macOS 11 (Big Sur) or later**
- Any audio input device (built-in mic, USB interface, soundboard)
- Local WiFi network
- Mac connected to your audio system

## Installation

1. Download Audion from the [AppStore](http://audion.josiaho.com)
2. Launch Audion from Applications

## Initial Setup

### Step 1: Select Your Audio Input

1. Open Audion
2. From the **Audio Input** dropdown at the top, select your audio source:
   - Built-in microphone
   - USB audio interface
   - Soundboard output
   - Aggregate device

> **Tip:** If you don't see your device, try unplugging and reconnecting it, then restart Audion.

### Step 2: Test Your Audio

1. Speak or play audio through your selected input
2. Watch the **Level Meter** in the middle of the window
3. The meter should move with your audio (green bars are good!)
4. If you see no movement, check your audio connections

### Step 3: Start Streaming

1. Click the **"Start Streaming"** button
2. The status will change to "Status: Streaming" (green text)
3. The app is now broadcasting audio on your local network

### Step 4: Share the Connection

You'll see a URL displayed in the app like:

```
Access at: 192.168.1.100:8080/listen
```

**Option A: Share the URL**
- Tell listeners to visit this URL in their browser
- Works best for small groups

**Option B: Generate QR Code**
1. Click the **"QR Code"** button
2. Save the QR code as a PNG file
3. Print it in bulletins or display it on signage
4. Listeners scan and connect instantly

## First Stream Checklist

✅ Audio input device selected  
✅ Level meter showing audio activity  
✅ "Start Streaming" button clicked  
✅ Status shows "Streaming" in green  
✅ QR code generated and shared  
✅ Test with your own phone to verify

## What's Next?

- **For staff:** Learn about [Audio Setup](audio-setup.md) options
- **For attendees:** Share the [For Listeners](for-listeners.md) guide
- **Customize:** Add your logo with [Customization](customization.md)
- **Automate:** Set up [MIDI Control](midi-control.md)

## Quick Troubleshooting

**No audio showing on meter?**
- Check that your audio device is selected
- Verify audio is actually playing through that device
- Try selecting a different input device

**Can't connect from phone?**
- Make sure phone is on the same WiFi network as the Mac
- Verify the IP address hasn't changed
- Try turning WiFi off and back on

**Audio is choppy?**
- Check WiFi signal strength
- Reduce distance between listener and WiFi router
- Consider upgrading your WiFi network

---

Need more help? Check out [Troubleshooting](troubleshooting.md) or contact [support](mailto:me@josiaho.com?subject=Re:Audion).