Privacy policy
Effective date: November 8, 2026
EspDesktop is a source-available, non-commercial touchscreen control panel project maintained by jtenniswood. This policy explains what information may be involved when you use the EspDesktop documentation website, firmware, or built-in web configuration interface.
The short version
EspDesktop does not operate an account system, advertising service, analytics platform, or central service that collects your smart-home data. The firmware is designed to communicate with a paired Mac on your local network and with network services you choose to configure. Your device configuration is stored on your device or in your own backups.
The EspDesktop firmware and device
The firmware exchanges Mac controls, system statistics, app information, and Mac lock state with the Mac you pair. While the Mac is locked, the app also reports whether its displays are awake. Saved configurations and backups may retain identifiers and other fields from older cards so you can identify and replace them.
Firmware and asset downloads
Firmware with EspDesktop's update checker enabled periodically requests public version metadata and, when an update is installed, firmware files from the EspDesktop GitHub Pages site. These requests contain normal network request information, such as the device's IP address and request time, as observed by the hosting provider. They are not intended to include your saved card data or pairing credentials.
Current 4848S040 firmware serves the bundled editor directly from the display. Older firmware may first request the editor from the hosted EspDesktop site. That request includes the display model and firmware version along with normal browser connection metadata. Firmware update checks are separate.
Networked standard builds automatically synchronize time with the public NTP pool at 0.pool.ntp.org, 1.pool.ntp.org, and 2.pool.ntp.org. DNS and NTP requests may disclose normal connection metadata to the pool operators. This traffic occurs even when no optional cards or services are configured and the EspDesktop update checker is disabled.
EspDesktop macOS app
EspDesktop connects to the display you pair on your local network. It stores connection preferences and approved-folder bookmarks locally on the Mac, and stores the pairing credential in macOS Keychain. Folder paths remain on the Mac; the display receives names and opaque identifiers for approved applications and folders. EspDesktop can also share the focused application for its cards. System statistics are shared automatically with your paired display while connected; they contain overall resource usage and network throughput, not network contents.
Opening the display’s Companion setup page starts pairing on an unpaired display and shows a temporary code. This uses the display’s configured web authentication; without a web password, anyone who can reach that page can start pairing. The Mac stores the paired credential in Keychain and pins the display certificate. Forget in Settings → Displays removes the saved pairing values for the selected display.
Folder access is granted through the native folder picker. Finder automation can identify an approved folder in the frontmost Finder window; optional Accessibility access enables requested keyboard shortcuts. Remove approved folders in EspDesktop or revoke permissions in macOS System Settings. Removing the application may leave preferences or Keychain items behind, so forget the display before uninstalling when you want to remove its pairing. EspDesktop does not send these local card data to an analytics service.
The Mac app fetches public catalogues, including shortcut presets, from GitHub. The packaged app also checks the EspDesktop update feed when automatic checks are enabled or you check manually. The hosting providers may receive ordinary request information such as IP address and time. You can change automatic update settings in the Mac app’s Updates tab.
Information you provide to the project
If you open a GitHub issue, pull request, or discussion, GitHub processes your GitHub account information and the content you submit. Issue descriptions, logs, screenshots, and configuration snippets may be public. Remove passwords, tokens, Wi-Fi credentials, private URLs, and other sensitive information before posting. Do not use a public issue to send a privacy request or other confidential information.
Retention and sharing
The project maintainer does not operate a database of EspDesktop users and does not sell or rent personal information. Information submitted through GitHub is retained and handled according to GitHub's policies and the project's public repository settings. Information handled by Buy Me a Coffee, GitHub Pages, or another service you choose is governed by that service's policy and retention practices.
Your choices and privacy requests
You can choose whether to use automatic firmware updates, visit external links, or submit information to GitHub. To remove local device settings, use a full flash erase or another verified factory-reset procedure that clears the device's storage. A normal reset or firmware re-flash may preserve saved configuration, including entity IDs and credentials saved by older firmware. This does not remove copies you have made elsewhere.
For a question about this policy or a request concerning information directly controlled by the project maintainer, contact jtenniswood through GitHub. Please do not include private information in a public issue. Requests about GitHub or another third-party service should be directed to that service.
Changes to this policy
This policy may be updated when EspDesktop's data practices or the services it uses change. The effective date at the top of this page indicates when the current version was published.
