# Guides

The guides section is task-oriented: short walkthroughs you can
follow when you want to get a specific thing done.

## Day-to-day

- [The tray menu and Settings](/guides/settings/) — what every menu
  item does, where settings live on disk, and what the indicators
  mean.
- [Recordings & retention](/guides/recordings-and-retention/) — disk
  budgets, per-camera retention, event clips vs. continuous record.
- [Detection tuning](/guides/detection-tuning/) — masks, zones,
  per-object thresholds, ANE vs. GPU, and using your own ONNX or
  Frigate+ model.
- [Adaptive transcoding](/reference/adaptive-transcoding/) — enable
  bandwidth-adaptive HLS playback for recordings and live view;
  VideoToolbox hardware transcoding on the Media Engine, zero CPU,
  opt-in per camera. Especially useful for remote and mobile access.

## Integrations

- [Home Assistant](/guides/home-assistant/) — the official Frigate
  HACS integration, pointed at your Mac.
- [MQTT, webhooks, notifications](/guides/notifications/) — what
  Fregata can push out and where to wire it.

## Operations

- [Updates & renewals](/guides/updates-and-renewals/) — how Fregata
  checks for updates, what your license covers, and how to renew.
- [Performance](/guides/performance/) — diagnosing CPU spikes,
  inference time, RAM-disk sizing, and the perf-logging env var.
- [Moving & uninstalling](/guides/moving-and-uninstalling/) — taking
  Fregata to a different Mac, and the clean-up steps when you're
  done with it.
- [Troubleshooting](/guides/troubleshooting/) — common error messages
  and what to try, indexed by the exact string the app surfaces.
- [Getting help](/guides/support/) — GitHub Discussions for community support, or email the team directly.