Where your data lives

What Avocet stores, where it lives on disk, and what never leaves your Mac.

Your meeting audio, transcripts, and database never leave this Mac. Recording, transcription, and speaker matching all run here. Avocet makes model-download, update-check and licensing requests, and sends a problem report only when you click Send. One link opens in your browser. None of these requests sends meeting audio, transcripts, ids or contents.

What leaves your Mac

  • Model download: a request to huggingface.co during setup, when a model is missing or fails verification, or when you explicitly re-download a model. See Model download.
  • Update check: a request to updates.avocet.dev for a newer version. You can turn it off. See Update checks.
  • License check: activation, validation and deactivation contact api.polar.sh and reveal your IP address. Activation sends your license key, Avocet's organization id, the label "Avocet Mac" and a random id for this installation. Validation and deactivation send your license key, Avocet's organization id and the activation id. Avocet checks at most once a day, retries hourly after a failure and checks again when you choose Recheck. It allows 14 days offline grace. If the last validation said the key was granted, builds released through the next anniversary of the key remain eligible during grace, including in the first paid year. After grace, an eligible paid build remains recordable through its paid-through anniversary. Polar may return customer details, which Avocet does not store or log.
  • Trial registration: before the first trial recording, Avocet contacts avocet.dev with a lowercase HMAC-SHA256 code derived from this Mac's IOPlatformUUID and the stable public app salt, plus the capped trial count. It never sends the raw UUID, a license key, email, meeting id or meeting contents. The first sync must succeed before recording starts. Later syncs keep the server count current when possible and fail open if offline. On activation, Avocet makes one at-most-once conversion request with the same code and count; an offline failure may lose it, and no later trial request is made. The code is pseudonymous, not anonymous, and the service can correlate requests for the same Mac. It also sees your IP. The trial service deletes its record 12 months after the last sync or conversion, and you can ask support to delete it sooner. After deletion, a Mac whose local history is also erased can start a fresh trial. The trial service does not link the code to your license or email.
  • Activation link: when you click Open Avocet on the thank-you page, Avocet sends only the one-time claim token to avocet.dev/api/v1/license/claim and receives your license key. Avocet keeps the token in memory until the app closes to prevent a second claim request; it is never logged or included in diagnostics. Avocet fills the masked License key field in Settings; you still choose Activate. You can always paste the key from Polar's email instead.
  • Problem report: only when you click Send in Settings > App > About > Report a problem. It carries your description and only the optional email, system information and redacted diagnostics you leave selected. The request goes to avocet.dev, where Chris reads it. See Diagnostics.
  • Changelog link: when you click Read more on an available update, your browser opens avocet.dev. Avocet does not load that page itself.

Links that open System Settings show panes on this Mac and make no network call. There is no account, no analytics, no crash reporting, and no meeting-data sync.

Your meeting notes and audio

Each meeting gets its own dated folder under ~/Documents/Avocet/, containing your markdown note, a JSON transcript, and two audio files: mic.flac for your side and system.flac for everyone else. In Settings > Recording > Limits, you can choose how many days to keep audio. When Avocet is idle, it deletes audio from ready meetings older than that setting. The clock starts on the first idle sweep after this version starts, even when retention is off. Leave the setting empty or enter 0 to keep audio forever. Transcripts and notes stay. Discarded recordings are removed after 7 days, or sooner if you delete them from the meeting view menu. See Exporting for what is in each file.

The database

Meeting metadata, speaker identities, voiceprints, dictionary rules, settings and the license key live in one SQLite database at ~/Library/Application Support/dev.avocet.app/avocet.db. The trial count, registration status and paid-version recovery record also live in the macOS login Keychain. The Keychain copy does not contain your license key. The database is the source of truth for meetings; markdown notes and JSON files are generated from it and stay in sync automatically.

When a schema migration fails at startup, Avocet appends the timestamp, retry classification and original error to ~/Library/Application Support/dev.avocet.app/startup.log. This app-level log is separate from the database, keeps earlier entries, and has a 1 MiB UTF-8 size limit. It stays on this Mac and is not uploaded with a problem report. You can copy the complete failure details from the startup error window before quitting Avocet.

Models

The transcription and speaker-matching models you downloaded during setup live under ~/Library/Application Support/dev.avocet.app/models/. They run locally. In Settings > Transcripts > Models, Verify and update checks installed models offline and downloads a replacement only when a model fails its loader check. Re-download always fetches a fresh copy of the selected model. Avocet stages and checks a replacement before publishing it. If a download or check fails, the active folder stays in place and Settings reports the error. Maintenance waits until model use by processing or embedding ends; processing and embedding wait for maintenance to finish.

Diagnostics

When debug capture is on, Avocet writes a small log and a snapshot file inside each meeting's folder to help diagnose a problem. These stay on your Mac unless you choose Include diagnostics in a problem report. The report preview shows the redacted log and settings summary that will be uploaded. It excludes audio, transcripts, the database, debug.json, exports, device names, paths and other private fields.

Model download

Avocet needs two models before it can transcribe: Parakeet TDT v3 for speech, and a speaker model for telling voices apart. It downloads them from huggingface.co, the public model host, during setup.

  • When: during setup, if a model is missing, or if Verify and update finds a model that fails its offline loader check. Re-download always contacts Hugging Face for a fresh copy of the selected model, even when its files are present. Model maintenance and meeting processing do not use the cache at the same time.
  • What it sends: Hugging Face sees your IP address and which model files you ask for. Avocet adds no account of its own, device ID, or meeting data.
  • How to avoid it: you can't turn it off, because Avocet cannot transcribe without these models. After setup, Avocet can verify installed models offline. Re-download is optional; it fetches a fresh copy when you choose it. Update checks and installing updates also use the network.

Update checks

Avocet checks updates.avocet.dev for a newer version when automatic checks are enabled. You can turn Automatically check for updates off in Settings > App > About, or use Check now to request a check yourself.

Update checks contact updates.avocet.dev and reveal your IP address. Your current version and architecture are used on this Mac to choose an update. License keys, activation IDs and paid-through dates are not sent to the updater or archive host. Installing an update downloads the new version from the same service. Meeting audio and transcripts are not sent.

Deleting a meeting

Deleting a meeting removes its folder, its markdown note, and its database rows. This is permanent. There is no trash or undo.