# Quick Reference

Essential information at a glance.

## For Staff

### First-Time Setup
1. Select audio input device
2. Click "Start Streaming"
3. Share QR code or URL
4. Monitor listener count

### Before Each Service
- [ ] Mac plugged in and awake
- [ ] WiFi connected
- [ ] Audio device connected
- [ ] Audion running
- [ ] Click "Start Streaming"
- [ ] Test on one phone
- [ ] QR codes visible

### During Service
- [ ] Monitor audio levels (green bars)
- [ ] Check listener count
- [ ] Keep Mac awake
- [ ] Don't close Audion

### After Service
- [ ] Click "Stop Streaming"
- [ ] Can leave Audion running for next service

---

## For Listeners

### Connecting
1. Scan QR code OR visit URL
2. Tap "Start Listening"
3. Adjust device volume

### iOS Users
⚠️ Keep screen on - audio stops when locked

**How to:**
Settings → Display & Brightness → Auto-Lock → Never

### Battery Tips
- Lower screen brightness
- Close other apps
- Bring charger/power bank

---

## Troubleshooting - Quick Fixes

### Can't Connect?
1. Check WiFi - same network?
2. Try turning WiFi off and on
3. Restart browser
4. Rescan QR code

### No Audio?
1. Check device volume
2. Try headphones
3. Tap "Stop" then "Start"
4. Refresh browser page

### Audio Cutting Out?
1. Move closer to WiFi router
2. Check WiFi signal bars
3. Close other apps
4. Reduce other network usage

---

## Network Info

**Mac Requirements:**
- Local WiFi connection
- Port 8080 open (usually automatic)

**Listener Requirements:**
- Same WiFi as Mac
- Modern web browser
- JavaScript enabled (usually default)

**Typical URL Format:**
```
http://192.168.1.100:8080/listen
```

---

## Audio Levels Guide

🟢 **Green (0-70%)** → Perfect! Keep it here  
🟡 **Yellow (70-90%)** → Good, approaching max  
🔴 **Red (90-100%)** → Too loud! Lower gain

**Target:** Green bars that occasionally touch yellow

---

## Keyboard Shortcuts

| Action | Shortcut |
|--------|----------|
| Open Preferences | `⌘,` |
| Close Window | `⌘W` |
| Quit Audion | `⌘Q` |

---

## Default Settings

**Audio:**
- Sample Rate: 44.1kHz or 48kHz (auto)
- Format: Mono (auto-mixed from stereo)
- Latency: 80-150ms typical

**Network:**
- Port: 8080
- Protocol: HTTP
- Scope: Local only

**Title:** 🎧 Audio Stream  
**Subtitle:** Assistive Listening Service

---

## Status Indicators

| Status | Meaning |
|--------|---------|
| 🟠 Monitoring | Audio engine running, not streaming |
| 🟢 Streaming | Broadcasting to listeners |
| 🔴 Stopped | Not monitoring or streaming |

**Listener Count:**
- Shows in app window
- Shows as dock badge
- Updates real-time

---

## MIDI Quick Start

1. Preferences → MIDI Tab
2. Enable MIDI control
3. Select device
4. Click "Learn" for Start
5. Press MIDI button/control
6. Click "Learn" for Stop
7. Press different MIDI button
8. Done!

**Supported:**
- Control Change (CC)
- Note On messages
- Any MIDI channel

---

## File Formats

**Logos:**
- PNG (recommended - transparency)
- JPG (photos)
- SVG (scalable)
- GIF (transparency)

**QR Codes:**
- 1000x1000 pixels
- PNG format
- High contrast for printing

---

## Emergency Contacts

**Technical Issues:**
- Check [Troubleshooting Guide](troubleshooting.md)
- Email: me@josiaho.com

**During Service:**
- Have backup audio plan
- Keep someone who knows system available
- Have manual available

---

## Common URLs

| Page | URL Path |
|------|----------|
| Listener Page | `/listen` |
| Logo Image | `/logo` |
| Status Check | `/status` |
| Audio Stream | `/audio` |

**Example:**
- `http://192.168.1.100:8080/listen` - Main page
- `http://192.168.1.100:8080/status` - Stream status

---

## Best Practices

✅ **Do:**
- Test before services
- Keep Mac plugged in
- Prevent Mac sleep
- Monitor listener count
- Have backup plan
- Train multiple people

❌ **Don't:**
- Let Mac go to sleep
- Disconnect audio during service
- Change settings mid-service
- Forget to enable streaming
- Ignore warning signs (no audio, etc.)

---

## Quick Diagnostics

**Problem:** Nothing works  
**Check:** Is Mac on WiFi?

**Problem:** No audio meter  
**Check:** Audio device selected?

**Problem:** Can't connect  
**Check:** Same WiFi network?

**Problem:** Audio stops  
**Check:** iPhone screen locked? (Keep on)

**Problem:** Choppy audio  
**Check:** WiFi signal strength?

---

**Need more details?** See the [full documentation](README.md).