# Notifications, inbox & voice settings Controls what shows up in your unified inbox, how and when Omniscio alerts you, and how voice commands and text-to-speech behave. --- ## Alarm assertiveness {#alarmsAssertiveness} Choose how forcefully an alarm interrupts you when it fires. **Full-screen modal** (the most assertive option) takes over the screen until you dismiss it — use this for alarms you cannot afford to miss. **Banner toast** pops up in the corner and fades; it still plays a sound. **Silent banner** shows the same corner pop-up but skips the sound entirely, so you see the alert without being interrupted mid-call or mid-focus. You can override the assertiveness for any individual alarm; this setting is the fallback default for alarms that do not specify their own. Accepted values: `"modal"`, `"banner"`, `"silent-banner"`. --- ## Inbox analytics {#inboxAnalyticsEnabled} When turned on, Omniscio quietly tracks how you work with inbox items — how long things wait before you clear them, how often you open the inbox without acting, and roughly how much time you spend on each item. That data feeds the **Stats → Inbox** tab so you can spot patterns over time. Everything stays on this device; no message content, phone numbers, or identifiers are ever stored. Turn it off if you do not want that tracking at all. Default: on. --- ## Show sessions in inbox {#inboxShowSessions} Controls whether Claude Code sessions that need your attention appear in the unified inbox. When on, any session in a "Needs You" state — waiting for your reply, stuck, or errored — shows up as an inbox row. Turn it off to keep the inbox clear of session cards and rely only on the sidebar indicators. Default: on. --- ## Show SMS in inbox {#inboxShowSms} Controls whether incoming text messages routed via Pushbullet appear as rows in the unified inbox. When on, each incoming SMS creates an inbox card you can read and reply to without leaving Omniscio. Turn it off if you prefer to handle texts in your phone's own messaging app and want to keep the inbox free of SMS cards. Requires the SMS integration (Pushbullet) to be set up separately. Default: on. --- ## Show Telegram in inbox {#inboxShowTelegram} Controls whether incoming Telegram messages appear as rows in the unified inbox. Omniscio connects to Telegram via the MTProto protocol directly — no bot required. When on, new Telegram messages land in your inbox alongside your other communications. Turn it off to stop Telegram cards from appearing there. Requires a Telegram account to be connected in Settings. Default: on. --- ## Show daily digest in inbox {#inboxShowDigest} Controls whether your daily briefing summary appears in the unified inbox. When on, the morning digest card — a summary of overnight AI session activity across all your hubs — shows up as an inbox row. Turn it off to stop the digest from cluttering the inbox; the digest is still generated and accessible elsewhere. Default: on. --- ## Show GitHub in inbox {#inboxShowGithub} Controls whether GitHub notifications, pull requests, and issue updates appear in the unified inbox. When on, unread GitHub events create inbox cards so you can triage your GitHub activity without switching apps. Turn it off if you prefer to manage GitHub notifications in GitHub itself or another tool. Requires a connected GitHub account. Default: on. --- ## Show Gmail in inbox {#inboxShowGmail} Controls whether Gmail messages and threads appear in the unified inbox. When on, unread emails land in your inbox alongside sessions, SMS, and other channels. Turn it off to keep the inbox free of email cards and rely on the dedicated Gmail panel instead. Requires Gmail to be connected and enabled. Default: on. --- ## Show calendar reminders in inbox {#inboxShowCalendar} Controls whether Google Calendar reminders and agenda items appear in the unified inbox. When on, upcoming events and reminders land in your inbox alongside sessions and other channels. Turn it off to keep the inbox free of calendar cards and rely on the Calendar panel instead. Requires Google Calendar to be connected. Default: on. --- ## Show cron jobs in inbox {#inboxShowCron} Controls whether scheduled cron job results appear in the unified inbox. When on, the outcome of each cron run — whether it succeeded, failed, or produced output — creates an inbox row so you can review automation results in one place. Turn it off if you want cron results hidden from the main inbox. Default: on. --- ## Show automations in inbox {#inboxShowAutomations} Controls whether automation rule results appear in the unified inbox. When on, each time an automation rule fires and produces an outcome, an inbox card is created. Turn it off if your automations are noisy and you do not want to review each result individually. Default: on. --- ## Show CLI approvals in inbox {#inboxShowCliPending} Controls whether pending CLI approval requests appear in the unified inbox. When on, any agent or external process that is waiting for your approval before continuing shows up as an inbox row, prompting you to act. Turn it off to suppress these cards — but be aware that pending requests will then only be visible via the CLI approval panel. Default: on. --- ## Show recipes in inbox {#inboxShowRecipes} Controls whether recipe orchestration results appear in the unified inbox. When on, the output of each recipe run — a multi-step automated workflow — creates an inbox row. Turn it off if you prefer to check recipe results in the Recipes panel rather than the inbox. Default: on. --- ## Low disk space alerts {#lowDiskSpaceAlertEnabled} When on, Omniscio warns you in the inbox if free disk space drops below your configured floor and automatic cleanup cannot recover enough space. The warning is an inbox card, not a system notification. Turning this off silences only the warning — the automatic disk cleanup (which removes finished worktrees to protect your drive) keeps running regardless. Default: on. --- ## Low disk space floor {#lowDiskSpaceFloorGb} The minimum amount of free space Omniscio tries to keep on your working drive, in gigabytes. When free space drops below this number, finished worktrees are automatically cleaned up. If cleanup cannot recover enough space and low-disk alerts are on, you receive an inbox warning. Range: 5 to 500 GB. Adjust upward if you work with very large repos or want a bigger safety buffer. --- ## SMS offline alerts {#smsHealthAlertsEnabled} When on, Omniscio raises an inbox alert and a single notification if SMS is turned on but stops working — for example, if your Pushbullet token expires or the connection drops for a sustained period. The alert clears automatically once SMS reconnects, so you do not need to manually dismiss it. Turn it off if you are OK discovering SMS outages on your own. Only relevant while the SMS integration is enabled. Default: on. --- ## Meeting Rooms {#meetingRoomsEnabled} Shows the Meeting Rooms panel in the sidebar and enables the Ctrl+Shift+Z keyboard shortcut to open the quick-launch palette. Meeting Rooms let you save your recurring video call links (Zoom, Google Meet, Teams, etc.) for one-tap joining. Your saved rooms are preserved when you disable this — turning it back on restores them. Turn it off if you do not use saved meeting links and want to keep the sidebar uncluttered. Default: off. --- ## Meeting call auto-detection {#meetingsAutoDetectEnabled} When on, Omniscio watches for an active audio call on your computer — including browser-based calls like Google Meet and Microsoft Teams — and automatically shows a heads-up overlay so you can start capturing notes without manually starting a recording. Turn it off if you always start meetings manually or find the automatic prompt distracting. Default: off. --- ## Live transcript indicator {#meetingsLiveIndicator} When on, a small floating window appears on screen while a meeting is being recorded, showing the live transcript as it is being captured. It gives you a real-time view of what is being transcribed so you can catch any errors immediately. Turn it off if you find the overlay distracting and prefer to review the transcript afterward. Default: on. --- ## Speaker attribution {#meetingsSpeakerAttribution} When on, the transcript labels each line with who said it — distinguishing your voice from other participants. This makes the transcript easier to follow when reviewing a meeting with multiple speakers. If your transcription provider does not detect multiple speakers cleanly, turning this off can produce a cleaner single-stream transcript. Default: on. --- ## Summary language {#meetingsSummaryLanguage} The language Omniscio uses when writing the AI-generated notes and summaries for your meetings. This is the OUTPUT language — it controls what language the summary is written in, not what language is spoken. Set it to match the language you want to read your notes in. You can set this independently from the transcription language, so you can speak in one language and receive notes in another. --- ## Transcript auto-delete {#meetingsTranscriptRetention} Automatically deletes the raw meeting transcript after a set period to save space and protect privacy. Options are to never delete, or to delete after 30 days, 90 days, or 1 year. Your AI-written notes and summaries are always kept — only the raw transcription text is removed. Set to **Off** if you want to keep raw transcripts indefinitely. Default: off. --- ## Transcription language {#meetingsTranscriptionLanguage} The language spoken in your meetings, used to improve the accuracy of the live transcriber. Setting this correctly helps the speech recognition engine handle accents, vocabulary, and phrasing for the language you actually speak during calls. You can set it independently from the summary language. --- ## Wake word detection {#wakeWordEnabled} When on, Omniscio listens for one of two wake phrases — say **"Hey Omniscio"** or **"Computer"** — to activate voice commands without touching the keyboard. This keeps your hands free during tasks. The built-in engine (OpenWakeWord) runs locally at no cost and requires no account or API key. Requires voice commands to also be enabled. Default: off. --- ## Error/warning display time {#toastDisplayDurationSeconds} How long error and warning toasts stay on screen before auto-dismissing. Choose from preset durations: 5, 8, 10, 15, or 30 seconds. The default (8 seconds) matches the previous fixed duration. Success and info toasts are unaffected and always use a shorter fixed duration. If code passes an explicit duration when creating a toast, it overrides this setting. Number (seconds); accepted values: 3–30. Default: `8`. --- ## Notification timing {#notificationBehavior} Controls when Omniscio sends OS-level notifications to your taskbar or notification center. **Always** sends a notification every time a session needs attention, even if Omniscio is in the foreground. **Backgrounded** (the default) sends notifications only when Omniscio is in the background or minimized — so you are not double-alerted while already looking at the app. **Never** disables all OS notifications from Omniscio entirely. Accepted values: `"always"`, `"backgrounded"`, `"never"`. Default: `"backgrounded"`. --- ## Notification history {#notificationHistoryEnabled} When on, Omniscio keeps a local log of every notification sound decision — whether a chime fired, was suppressed, or was rate-limited — so you can always look up "what was that sound?" in Settings → Notifications. The log stays on this device and is bounded in size. Turn it off to stop recording chime history; the notification sounds themselves are unaffected. Default: on. --- ## Notification sounds {#notificationSoundEnabled} Master switch for all notification chime sounds in Omniscio. When off, no sounds play for any session event — needs-you, stalled, or error — regardless of the per-event sound settings below. Turn it off for a fully silent experience, or use a headphone-friendly alternative. Default: on. --- ## Needs-you sound {#notificationSoundNeedsYou} The sound Omniscio plays when a session switches to "Needs You" — the agent has asked a question or is waiting for your reply. You can set a custom audio file path or use one of the built-in sounds. The default is `builtin:alert-ping`. Works only when notification sounds are on and the volume is above zero. --- ## Stalled sound {#notificationSoundStalled} The sound Omniscio plays when a session appears to have stalled — it has been running without producing output for longer than expected. You can set a custom audio file path or use one of the built-in sounds. The default is `builtin:soft-bell`, which is intentionally gentler than the needs-you alert. Works only when notification sounds are on. --- ## Error sound {#notificationSoundError} The sound Omniscio plays when a session hits an error state. You can set a custom audio file path or use one of the built-in sounds. The default is `builtin:attention`. Works only when notification sounds are on. --- ## Notification volume {#notificationSoundVolume} Sets how loud all notification sounds play, from 0 (silent) to 1 (full volume). The default is 0.5 (half volume). This applies to every notification chime — needs-you, stalled, and error alerts all share this volume setting. Alarms use the same volume by default but can be overridden per alarm. --- ## Mobile sound {#mobileSoundEnabled} When on, Omniscio plays notification sounds on the mobile web app in addition to the desktop. Off by default because mobile browsers often restrict auto-playing audio. Turn it on if you use the mobile interface and want audio chimes there as well. --- ## Text-to-speech {#ttsEnabled} Master switch for Omniscio's read-aloud feature. When on, you can have session replies spoken aloud via a voice synthesis provider of your choice. Turning it on unlocks the TTS controls below and reveals the speaker button in the session header (if `showSessionVoiceButton` is also on). Off by default. Requires a supported TTS provider to be configured with a valid API key. --- ## Auto-read replies {#ttsAutoRead} When on, Omniscio automatically speaks each new completed session reply aloud as it arrives, without you pressing the play button. Use this for a fully hands-free experience. Off by default — when off, replies are only read when you manually press the speaker button. Requires `ttsEnabled` to be on. --- ## TTS daily cost cap {#ttsDailyCapUSD} The maximum amount Omniscio will spend on text-to-speech audio synthesis each calendar day, in US dollars. Once the cap is reached, read-aloud stops for the rest of the day. Range: $0 (disables TTS) to $100. Default: $5. Adjust upward if you use TTS heavily and keep hitting the cap. --- ## TTS provider {#ttsProvider} The voice synthesis service used to generate spoken audio. Each provider has different voice styles, latency characteristics, and pricing. Options: Fish Audio (the default), Grok (xAI), ElevenLabs, Speechify, Pika, and Soniox. Fish Audio and Soniox are company-funded (no personal API key needed); the others bill to your own provider key. Requires `ttsEnabled` to be on. --- ## TTS speed {#ttsSpeed} How fast the synthesized voice speaks, from 0.5× (half speed) to 2× (double speed). The default is 1.0 (normal speed). This setting bakes the tempo into the generated audio at synthesis time. If you want to adjust playback speed without re-synthesizing, use the narration playback rate setting instead. Requires `ttsEnabled` to be on. --- ## TTS volume {#ttsVolume} The playback volume of spoken audio, from 0 (silent) to 1 (full volume). The default is 0.8. This is separate from the notification sound volume — it controls only the TTS read-aloud level. Requires `ttsEnabled` to be on. --- ## TTS character limit {#ttsMaxChars} The maximum length of a single message that Omniscio will read aloud in full, measured in characters. Messages longer than this limit are handled according to your summarization mode setting. Range: 100 to 10,000 characters. Default: 2,000. Increase it if you often want very long replies read verbatim; lower it to keep spoken replies brief. --- ## TTS summarization mode {#ttsSummarizationMode} What Omniscio does when a reply exceeds the character limit above. **Verbatim** reads the full text regardless of length. **Summarize** always condenses the reply before speaking it. **Auto** (the default) reads short replies in full and summarizes only when the reply exceeds the threshold below. Accepted values: `"verbatim"`, `"summarize"`, `"auto"`. --- ## Show TTS button in session header {#showSessionVoiceButton} When on, a speaker icon appears in the session header bar so you can trigger read-aloud from within a session without opening settings. Hidden by default to keep the session header uncluttered. Requires `ttsEnabled` to also be on — enabling this setting alone will not show the button until TTS is turned on. Default: off. --- ## Voice commands {#voiceEnabled} Master switch for voice input and commands. When on, Omniscio listens for your voice via the microphone — you can speak to send messages, issue commands, and navigate the app. Turning it on also unlocks wake-word detection and the voice command settings. Off by default. This is the top-level gate; all other voice features require this to be on. Enabling voice implies consent to send your audio to the configured speech-to-text provider. --- ## Voice feedback sounds {#voiceFeedbackSounds} When on, Omniscio plays small audio cues to confirm voice actions — for example, a brief tone when it starts listening, finishes processing, or completes a command. These sounds help you know your voice input was heard without looking at the screen. Turn it off for a fully silent voice experience. Requires `voiceEnabled` to be on. Default: on. --- ## Voice response style {#voiceResponseStyle} Controls how the AI responds when you send a message by voice. **Off** means the AI replies the same way it would for a typed message — no length adjustment. **Short** keeps replies brief and to the point, better suited for spoken responses. **Conversational** strikes a middle ground: friendly and natural, but not as terse as "short." Accepted values: `"off"`, `"short"`, `"conversational"`. Default: `"off"`. --- ## Speech-to-text provider {#voiceSttProvider} The service that converts your spoken audio to text for voice input. Options: Deepgram Nova-3 (the default — fast, streaming), ElevenLabs Scribe v2 (lowest latency), Groq Whisper v3 Turbo (transcribes after you stop speaking), Grok/xAI (in development, requires xAI key), and Built-in/local (free, runs on your own computer — revealed by `localSttEnabled`). Each provider has different latency, accuracy, and cost characteristics. Requires `voiceEnabled` to be on. Default: `"deepgram"`. --- ## Filter spam {#spamFilterEnabled} Checks messages from people you don't know and keeps junk in Spam. Messages from people you know are never checked. **Off by default**, so nothing is filtered until you turn it on; the per-channel switches below are then live, and each is disabled until this one is on. Toggle; accepted values: `true | false`. Find it in the Inbox hub's Spam tab. --- ## Filter spam in texts {#spamFilterSmsEnabled} Checks texts from numbers that aren't saved as contacts and that you have never texted. Short-code senders such as bank and login codes are never checked. On by default, but it does nothing until **Filter spam** is on. --- ## Filter spam in agent email {#spamFilterAgentEmailEnabled} Checks new email from strangers to your agent's address and your public support address. Caught mail starts no session and gets no reply, so junk sent to your agent cannot quietly spend a session. On by default, but it does nothing until **Filter spam** is on. --- ## Filter spam in calendar invites {#spamFilterCalendarEnabled} Checks calendar invites from organizers outside your own organization. A caught invite is hidden rather than announced — you get no notice for it. On by default, but it does nothing until **Filter spam** is on. --- ## Remove invites from blocked senders {#spamFilterCalendarDeleteEvent} Also deletes an invite from your Google Calendar when it comes from a sender you have marked as spam. Invites the automatic check catches are only hidden, never deleted; this is the switch that removes them. Deleted invites stay in Google Calendar's trash for 30 days. On by default, but it does nothing until **Filter spam** is on.