First Launch
Everything that happens after you install the app: macOS permissions, AI configuration, and you are ready to run your first session.
Before reading this, make sure you have completed Prerequisites (calendar setup and AI credentials prep).
1. Grant macOS permissions
On first launch, Azynote will ask for four macOS permissions. Grant all of them for the full experience.
Microphone
Azynote transcribes your voice locally via Whisper during sessions. When macOS prompts you, click OK / Allow.
If you missed the prompt:
- System Settings > Privacy & Security > Microphone
- Toggle Azynote on
- Restart Azynote
Calendar
Azynote displays your meetings and links sessions to calendar events. When macOS prompts you, click OK / Allow.
If you missed the prompt:
- System Settings > Privacy & Security > Calendar
- Toggle Azynote on
- Restart Azynote
You can verify the status inside the app: Settings > AI Configuration > Calendar Integration. The Status line should read "Calendar access granted". If it doesn't, click Refresh Access.
Screen & System Audio Recording
Azynote captures meeting app audio separately from your microphone, so it can tell who said what. macOS will show a Screen & System Audio Recording prompt. Click Allow.
If you missed the prompt:
- System Settings > Privacy & Security > Screen & System Audio Recording
- Toggle Azynote on
- Restart Azynote
Accessibility
Azynote registers a global hotkey (Control+Shift+K) for Quick Capture. This requires Accessibility access. macOS will prompt you. Click Open System Settings, then toggle Azynote on.
If you missed the prompt:
- System Settings > Privacy & Security > Accessibility
- Toggle Azynote on
- Restart Azynote
2. Configure AI
Open Settings > AI Configuration > Gemini Provider.
If you chose Option A (Google AI Studio)
- Pick the Google AI Studio radio button
- Paste your API key into the Gemini API Key field
- Wait for the green "API key is valid" indicator
If you ever see "Invalid API key", regenerate the key in AI Studio and paste the new one in.
If you chose Option B (Vertex AI)
- Pick the Vertex AI radio button
- Fill in:
- GCP Project ID: from Prerequisites, step B.3
- Region: the one you noted down
- Check the ADC Status indicator. It should show a green checkmark.
Next: Core Concepts. Read it once. The rest of the app will click.