Desktop app: privacy and data
This page lists what the desktop app for Mac and Windows reads, stores and sends. Every row names the source file that does it, so you can check. The same list is inside the app, in Settings, Privacy and data, next to the real state of your computer: permissions, files with their size, and a log of what the app did.
Permissions
What each system permission lets the app do. On Windows there is no per-app switch for most of these.
- MicrophoneRecords your voice while you dictate: from the shortcut until you release it, press it again or reach 2 minutes. The zerosoft page in a tab also gets it for meetings, calls and Rec recordings you start there. The Settings window never gets it. Source: audio.rs, dictation.rs, tabs.rs
- AccessibilityUsed for one thing: sending the Paste keystroke (Command+V) to the app in front, so dictated text lands where your cursor is. To pick the right key it reads your current keyboard layout. It does not read other apps' windows, text or keys. Without it the text stays on the clipboard and you paste it yourself. Source: platform.rs, clipboard.rs
- Screen and system audio recordingMeeting notes capture the sound your computer plays (the other people in a call). macOS puts that under screen recording. The system requires a video stream, so the app asks for one of 2 by 2 pixels and never reads it. Screen recordings in Rec are made by the page in the tab through the webview, and macOS can ask for this same permission for them. Source: system_audio.rs, commands.rs
- CameraVideo calls in Talk and your face in Rec recordings. The app hands the camera only to a tab whose page is your server, and to the Rec camera bubble. The webview does not say which frame asks, so a frame inside your server's page gets the same answer as the page. Any other page in a tab, and the Settings window, are refused. Source: tabs.rs, rec_overlay.rs
- ClipboardNo system permission. To paste, the app keeps what is on your clipboard (text or image) in memory, writes the dictated text, sends Paste and 450 ms later puts back what was there, unless you copied something else meanwhile. What it held is never written to disk or sent. The dictated text it writes is marked so clipboard history does not keep it (see "What the system does on its own"). Source: clipboard.rs, dictation.rs
- Global shortcutsNo system permission. The app registers specific key combinations with the system: the dictation shortcut, "paste last", Esc only while it dictates, and two Rec shortcuts only while Rec records. It installs no keyboard hook, so it cannot see any other key you press. Source: dictation.rs, rec_overlay.rs
- NotificationsShows new mentions, messages and updates as system notifications. Title and text come from your server and go straight to the system; the app does not save them. Source: badge.rs, commands.rs
Stored on your computer
Files and folders the app and its webview write, what macOS or Windows keeps about the app on their own, and what older versions of the app left behind.
- App settingsServer address, dictation shortcut and mode, the switches on this page, where you left the recording indicator and the app version in which Accessibility was last seen allowed. Plain JSON. No account data. On Windows it is in Roaming (%APPDATA%), which can travel with a roaming profile.How long: Until you delete all local data.Settings or metadata onlyRemoved by "Delete all local data"macOS:
~/Library/Application Support/ai.zerosoft.desktop/settings.jsonWindows:%APPDATA%\ai.zerosoft.desktop\settings.jsonSource: config.rs - Open windows and tabsFor each tab, its path inside zerosoft and its title, which can include the name of a record such as a document or a contact. Also window sizes and positions, and your tab preferences. Plain JSON. With "Reopen my windows and tabs" off, only the preferences are saved. Versions before 0.3.7 kept it in Roaming on Windows; it is moved once, and anything left there is listed and deleted with the rest.How long: Rewritten as tabs change. Removed when you delete all local data.May hold your contentRemoved by "Delete all local data"macOS:
~/Library/Application Support/ai.zerosoft.desktop/session.jsonWindows:%LOCALAPPDATA%\ai.zerosoft.desktop\session.jsonSource: session.rs, tabs.rs - Main window positionSize and position of the main window, written by the window-state plugin. On Windows it is in Roaming (%APPDATA%), which can travel with a roaming profile.How long: Removed when you delete all local data. On the first launch after that, the window does not get its old position back, and the file the plugin writes when the app quits is removed again.Settings or metadata onlyRemoved by "Delete all local data"macOS:
~/Library/Application Support/ai.zerosoft.desktop/.window-state.jsonWindows:%APPDATA%\ai.zerosoft.desktop\.window-state.jsonSource: lib.rs - Dictations that were not sentThe audio of a dictation that could not be sent (no connection, signed out, server error), as a WAV file, plus a small metadata file: when it was recorded, how long it is, the file type, why it failed, how many times it was retried, the server it is for, the category (email, chat, note or other) and, if that switch is on, the name of the app in front. Not encrypted. On macOS only your user can read the files (mode 600). Audio that was sent is not kept. On Windows, versions before 0.3.7 kept them in Roaming; they are moved once, and anything left there is listed, pruned and deleted with the rest.How long: At most 20, each for 7 days (also checked at launch) or until it is sent. It is only sent to the server it was recorded for (dictations saved by this version or later; older ones go to the current server). Turn off "Keep dictations that could not be sent" and none is written. "Delete all local data" removes them, and again at the next launch in case one was being saved at that moment.May hold your contentRemoved by "Delete all local data"macOS:
~/Library/Application Support/ai.zerosoft.desktop/pending/Windows:%LOCALAPPDATA%\ai.zerosoft.desktop\pending\Source: retry.rs, dictation.rs - Activity log and last useThe log on this page and when each permission was last used. Event type, time, duration, size, host and, if that switch is on, the name of the app in front. It holds no audio, text or clipboard contents.How long: The last 500 events or 30 days. Clearing deletes the file. "Export" saves a copy in your Downloads folder (zerosoft-activity-<time>.json, readable only by your user on macOS); the app does not keep track of exported copies or delete them.Settings or metadata onlyRemoved by "Delete all local data"macOS:
~/Library/Application Support/ai.zerosoft.desktop/privacy/activity.jsonWindows:%LOCALAPPDATA%\ai.zerosoft.desktop\privacy\activity.jsonSource: privacy.rs - Website dataWhat the zerosoft website stores, as in a browser: local storage and databases (including what it keeps for offline use). On Windows this folder also holds the cookies and the cache. Written by the system webview (WebKit on macOS, WebView2 on Windows) in its own formats.How long: Until you delete it. Deleting website data on its own signs you out on this computer and on the server, and asks the webview to clear it; the webview does not confirm when it is done. "Delete all local data" removes the folder at the next launch, before any window opens; if it cannot, Settings says so.May hold your contentRemoved by "Delete all local data"macOS:
~/Library/WebKit/ai.zerosoft.desktop/Windows:%LOCALAPPDATA%\ai.zerosoft.desktop\EBWebView\Source: tabs.rs, commands.rs - Cookies (your session)The website cookies, including the session cookie that keeps you signed in. The webview stores it; the app encrypts nothing here and keeps no other copy of the session, in a file or in the system keychain. For its own requests the app reads the cookie from the webview each time.How long: Until you sign out, the session expires, or you delete website data.May hold your contentRemoved by "Delete all local data"macOS:
~/Library/HTTPStorages/ai.zerosoft.desktop.binarycookiesSource: auth.rs, api.rs - Web cachePages, images and scripts the webview cached to load faster.How long: Managed by the webview. Removed when you delete website data.May hold your contentRemoved by "Delete all local data"macOS:
~/Library/Caches/ai.zerosoft.desktop/Source: tabs.rs - System preferences filemacOS keeps a preferences file for every app. For zerosoft it holds what AppKit and WebKit store on their own (for example text direction). The app writes nothing to it.How long: Kept by macOS. The app does not delete it.Settings or metadata onlymacOS:
~/Library/Preferences/ai.zerosoft.desktop.plistSource: privacy.rs - Downloaded installersOn Windows, each update leaves its installer in a folder named exactly zerosoft-<version>-updater-<letters> in your temporary folder; only folders with that name and a version number are listed. On macOS the update is applied in place and its temporary files are removed.How long: Until you delete them, or Windows cleans the temporary folder.Settings or metadata onlyRemoved by "Delete all local data"Windows:
%TEMP%\zerosoft-<version>-updater-…Source: privacy.rs, updater.rs - Data from the old app (0.1.x)Only if you used the first version of the desktop app (0.1.0 to 0.1.2, built with Electron): its folder, with its settings, an encrypted copy of the session (session.bin) and the cookies of its own browser. This version does not read it. The app only treats a folder as the old app's if it has the exact name and files that app leaves (such as Local State, Preferences or session.bin, or a pending update for the updater cache); a folder of another app with a similar name is never listed or deleted. If the old app is still running, some files may stay; they are then reported after "Delete all".How long: Until you delete it.May hold your contentRemoved by "Delete all local data"macOS:
~/Library/Application Support/zerosoft/, ~/Library/Caches/zerosoft-desktop-updater/Windows:%APPDATA%\zerosoft\, %LOCALAPPDATA%\zerosoft-desktop-updater\Source: privacy.rs - Keychain key from the old app (0.1.x)macOS only, and only if you used version 0.1.x: the key it used to encrypt its session copy, in your login keychain as "zerosoft Safe Storage". Deleting it removes only that item. It is only shown, and deleted, if the old app's folder is there or the item looks exactly like the one Chromium creates; otherwise it is left alone. If macOS refuses (keychain locked or access denied), "Delete all" goes on and reports it.How long: Until you delete it.Settings or metadata onlyRemoved by "Delete all local data"macOS:
Keychain: zerosoft Safe StorageSource: platform.rs, privacy.rs - zerosoft:// link handlerOn Windows, every time it starts the app registers itself in your user registry (HKEY_CURRENT_USER\Software\Classes\zerosoft) as the program that opens zerosoft:// links, which is how signing in through the browser comes back to it. It holds the path of the app. On macOS the system reads this from the app itself.How long: While the app is installed. "Delete all local data" does not remove it, because the app registers it again when it restarts.Settings or metadata onlyWindows:
HKEY_CURRENT_USER\Software\Classes\zerosoftSource: lib.rs, privacy.rs - Open at loginOnly if you turned on "Open zerosoft when I log in": a login item kept by the system (a LaunchAgent on macOS, a Run entry in the registry on Windows). It holds the path of the app.How long: Until you turn the switch off or delete all local data. If the system does not let the app remove it, Settings says so after "Delete all".Settings or metadata onlyRemoved by "Delete all local data"Source: lib.rs, commands.rs
What leaves your computer
Every request the native part of the app makes, and the pages the Settings window loads. "Your server" is zerosoft.ai, or the address you set in Settings, Account. It must be HTTPS (plain HTTP only for localhost). A test fails if the code calls an address that is not on this list.
- The zerosoft app in each tabWhat the website sends in any browser: the pages you open, your work and the session cookie. Analytics the website uses apply here as they do in a browser.When: While a tab is open.To: Your serverSource: tabs.rs, nav.rs
- DictationThe audio of what you said (WAV, 16 kHz, mono), its duration, a category (email, chat, note, other) worked out from the name of the app in front, that app's name (macOS, if the switch is on; otherwise the word "desktop") and the session cookie. The server transcribes it and saves the text in your Voice history. One request without a cookie (GET /api/voice/dictate, which answers with nothing) opens the connection and wakes the server when you start. Two fixed fields go with it: capture=desktop (so your history says it came from the desktop app) and fast=1 (a faster cleanup for short phrases).When: When you finish a dictation or resend a saved one.To: Your serverAddresses:
POST /api/voice/dictate, GET /api/voice/dictateSource: api.rs, dictation.rs, platform.rs - Voice settings, dictionary and historyThe session cookie and what you change. These live on the server; the app shows them and saves your edits. "Paste last" asks the server for your latest dictation when the app has none in memory.When: When you open those sections in Settings, or use "paste last".To: Your serverAddresses:
GET /api/voice/settings, PATCH /api/voice/settings, GET /api/voice/dictionary, POST /api/voice/dictionary, DELETE /api/voice/dictionary/{id}, GET /api/voice/sessionsSource: commands.rs, dictation.rs - Meeting notesThe app hands the computer audio it captures to the zerosoft page in a tab, in memory. That page records the meeting and uploads it the way the website does. The native part sends nothing itself.When: While a meeting records with computer audio (macOS).To: Your serverSource: system_audio.rs, commands.rs
- Unread count and notificationsThe session cookie and the time of the previous check. The answer has your unread counts, up to 5 new notifications, the apps your workspace turned off, and your name and email (shown in Settings). Checks made without a previous time (the first one after each launch, and the ones Settings makes) also tell the server that your account uses the desktop app.When: Every 30 seconds, when a window gets focus, and when Settings opens.To: Your serverAddresses:
GET /api/desktop/badgeSource: badge.rs, commands.rs - Settings sectionsThe session cookie and the language of the app, to list the settings sections your account has.When: When the Settings window opens.To: Your serverAddresses:
GET /api/settings/navSource: commands.rs - Web sections of SettingsSections such as Account, Workspace or an app's settings are pages of your server loaded in the Settings window, with your session cookie, like in a browser. That window's user agent ends in zerosoft-settings/<version> so the server shows the page without the site's menus.When: When you open one of those sections.To: Your serverSource: commands.rs, nav.rs
- Sign in with GoogleYour browser opens the sign-in page of your server with a one-time challenge (PKCE), a random state, the language of the app and the platform (Mac or Windows). When the browser returns, the app trades a one-time code and its verifier for the session cookie and puts it in the webview. Signing in with email happens inside the tab, like on the website.When: When you sign in.To: Your serverAddresses:
/api/desktop/login, POST /api/desktop/tokenSource: auth.rs, deeplink.rs - Sign outThe session cookie, to end the session on the server too (the same two requests the website makes). Then the app removes the session cookie from this computer, even if the server did not answer.When: When you sign out from the app, delete website data, or delete all local data.To: Your serverAddresses:
GET /api/auth/csrf, POST /api/auth/signoutSource: auth.rs, commands.rs - UpdatesA request for the update feed, without your session cookie, identified as zerosoft-desktop/<version>. If there is a new version, the package is downloaded from the address in that feed (GitHub Releases). The app installs it only if its signature matches the public key built into the app.When: 20 seconds after launch, every 4 hours, and when you ask.To: Your server, GitHub ReleasesAddresses:
GET /api/desktop/update/latest.jsonSource: updater.rs, tauri.conf.json, desktop-release.ts - Links and connecting accountsNothing from the app. A link to another site, and the consent screen of an integration (Gmail, Calendar, Slack and others), open in your system browser.When: When you click them.Source: nav.rs, lib.rs
What the system does on its own
- Pages run in the system webview, which has services of its own that the app does not change: on macOS, WebKit can check sites against Safe Browsing (Fraudulent website warning); on Windows, WebView2 can check addresses with Microsoft Defender SmartScreen and send crash reports to Microsoft, depending on your Windows settings. Source: tabs.rs, tauri.conf.json
- Notification Center on macOS and the notification center on Windows keep the title and text of each notification the app shows until you clear them. Source: badge.rs, commands.rs
- Dictated text the app puts on the clipboard to paste is marked as temporary. On macOS it carries the TransientType and ConcealedType markers, which clipboard history apps that follow nspasteboard.org skip, and it stays on this Mac instead of going to Universal Clipboard (every macOS version the app supports allows this). On Windows it is excluded from clipboard history and from the cloud clipboard. Your previous clipboard is put back as it was, without markers. Text you copy yourself from the history in Settings is not marked. Source: platform.rs, dictation.rs
When something is recording
- While the app dictates, captures computer audio, or a tab reported a meeting or screen recording, a dot shows next to the zerosoft icon in the macOS menu bar, and the icon's tooltip and menu say what is active (macOS and Windows). The app draws it from its own state. The page cannot switch it off and there is no setting that hides it. Source: tray.rs, privacy.rs
- Dictation shows a bar at the bottom of the screen with a timer for as long as the microphone is open. Source: hud.rs, dictation.rs
- Computer audio capture can start only from the front tab of the zerosoft window that has the focus: not from a background tab, a minimized or hidden window, or a window behind another app. Only the tab that started it can read the audio, restart or stop the capture. While it runs and that tab is not in front, a small floating indicator stays on top of other apps even if you turned the meeting indicator off; you can close it for that recording. The menu of the icon has "Stop capturing computer audio", and turning off "Let meeting notes capture the audio of this computer" stops it too. If the page stops reading the audio for 30 seconds, the capture stops on its own. Source: system_audio.rs, indicator.rs, commands.rs, tabs.rs
- Microphone, camera and screen used by the zerosoft page in a tab (meetings, calls, Rec) are opened by the webview, not by the native code. macOS shows its own orange or green dot. The app logs each time it hands the microphone or camera to the page, and marks a recording when the page reports one. Source: tabs.rs, rec_overlay.rs
What the app does not do
- The native app has no analytics, telemetry or crash reporting. Its only network requests are the ones in the table above. Source: api.rs, Cargo.toml
- It does not read window titles, the contents of your screen or text in other apps. The only thing it learns about another app is its name, for dictation, and only with that switch on. Source: platform.rs, system_audio.rs
- It does not record what you type. It receives only the shortcuts it registered. Source: dictation.rs
- It does not save or send what is on your clipboard. Source: clipboard.rs, dictation.rs
- It sends no device identifier, computer name or user name. Its own requests, update checks included, identify as "zerosoft-desktop" plus the version. Pages in tabs use the system webview's normal user agent; the Settings window adds "zerosoft-settings" plus the version. Source: api.rs, updater.rs, commands.rs
- It writes no log files. The activity log on this page is the only record it keeps of what it did. Source: Cargo.toml, lib.rs
- It stores nothing in the system keychain and has no password or token of its own. (Version 0.1.x did; see "Keychain key from the old app".) Source: auth.rs
Switches you control
- Send the name of the app in front with each dictationmacOS only. The server uses it to pick the tone (email, chat, note) and shows it in your history. Off: the app does not read it, sends the word "desktop" and the category "other". It also applies when a saved dictation is sent again. Source: dictation.rs, platform.rs
- Keep dictations that could not be sentSaves the audio on this computer, not encrypted, for up to 7 days so you can send it again. Off: a dictation that fails is lost. Source: dictation.rs, retry.rs
- Let meeting notes capture the audio of this computermacOS only. Off: the app refuses the capture, and turning it off stops a capture in progress. Source: commands.rs, system_audio.rs
- Put back what was on the clipboard after pastingOff: the app does not read your clipboard at all, and the dictated text stays on it. Source: clipboard.rs
- Reopen my windows and tabs when zerosoft startsOff: the paths and titles of your open tabs are not written to disk. Source: session.rs
- Open zerosoft when I log inAdds or removes the login item. Source: commands.rs
In the app: Settings, Privacy and data.
The activity log
The app keeps a local log of the events below: the last 500 or 30 days, whichever is less. It holds the event, the time, a duration, a size, the host and, if you allow it, the name of the app in front. It has no field for audio, text or clipboard contents. You can read it, export it and clear it in Settings. It is never sent.
- Dictation opened the microphone Source: dictation.rs
- Dictation closed the microphone Source: dictation.rs
- Computer audio capture started Source: system_audio.rs
- Computer audio capture stopped Source: system_audio.rs
- The zerosoft page in a tab was given the microphone or camera Source: tabs.rs
- A tab reported that a meeting recording started Source: commands.rs
- A tab reported that the meeting recording ended Source: commands.rs
- A tab reported that a Rec recording started Source: rec_overlay.rs
- A tab reported that the Rec recording ended Source: rec_overlay.rs
- Dictation audio sent for transcription Source: dictation.rs, api.rs
- Text put on the clipboard, and pasted if Accessibility allows Source: dictation.rs, clipboard.rs
- Checked for updates Source: updater.rs
- Signed in through the browser Source: auth.rs
- Signed out from the app Source: auth.rs
- Local data deleted Source: commands.rs
How the app is locked down
- The page in a tab can call 11 native commands and no others: app version, start sign-in, open Settings, show a notification, report a recording, tab actions, the Rec bar, and start, read and stop computer audio. Each one checks that the caller is a tab showing your server. Through the app it cannot start a dictation, read files or change these settings. Source: remote.json, commands.rs, lib.rs
- A tab only navigates to pages of your server. Any other address opens in your system browser instead. Source: nav.rs
- Settings, the dictation bar and the indicators are files inside the app, with a content security policy that allows only their own scripts. Only the local Settings page can change settings or delete data. Source: tauri.conf.json, local.json
- zerosoft:// links are checked field by field: they can open a page of the app or finish a sign-in that this app started, nothing else. Source: deeplink.rs
- Updates are installed only if signed with the zerosoft updater key. A server you configure can offer a package but cannot make the app install one it did not sign. Source: updater.rs, tauri.conf.json
- The app is open source (AGPL-3.0). Everything on this page can be checked against the code in the links. Source: README.md
What is not solved yet
- The Mac app is not notarized by Apple and the Windows installer is not signed with a code-signing certificate, so both systems warn the first time you open it. Source: README.md, desktop.yml
- Dictations that could not be sent are saved without encryption. Source: retry.rs
- The page of your server gets the microphone and camera without a prompt from the app each time. The app has no indicator of its own for how long the page keeps them open; it relies on the one macOS shows and on what the page reports. Source: tabs.rs
- Deleting website data on its own asks the webview to clear it, but the webview does not report when it has finished, so the app says "requested". "Delete all local data" removes the webview folders at the next launch instead. Source: commands.rs
Found something that does not match the code? Write to security@zerosoft.ai. /security