Repository navigation
Releases
v1.3.1
EspDesktop v1.3.1
Changes since v1.3.0.
What changed?
- User-facing features: 7 changes. Notable: Update ChatGPT Desktop shortcut presets; Rename Folder card to Finder Folder.
Update guidance
- Recommended for users who want the latest firmware, setup page, device fixes, or documented behavior.
- Affected devices: All supported displays may be affected because shared firmware, setup, or build files changed.
Known issues
- No release-specific known issues are listed automatically for this release.
- Check open GitHub issues before updating devices you rely on every day.
Summary
- 7 user-facing changes are included in this release.
- Release range:
v1.3.0tov1.3.1.
User-facing changes
User-facing features
- Update ChatGPT Desktop shortcut presets (#498)
- Rename Folder card to Finder Folder (#500)
- Clarify the Applications card subtitle (#501)
- Remove duplicate ChatGPT New Chat shortcut (#499)
- Show app shortcut presets in a searchable list (#502)
- Focus the selected app before sending shortcut presets (#503)
- Add Brave Browser shortcuts and app subpage (#511)
Mac verification
Confirmed the installed Mac app from build run 43854808602 with fingerprint 3bffa12cecdc2052b7b1b2f97e60712b02b26a93c0c01491a9d2b3806d6b4e8c.
v1.3.0
EspDesktop v1.3.0
Changes since v1.2.6.
What changed?
- User-facing features: 11 changes. Notable: Consolidate the 4848S040 setup guides; Place display picker actions side by side.
- User-facing bug fixes: 1 change. Notable: Fix clipped card picker tiles on hover.
Update guidance
- Recommended for users who want the latest firmware, setup page, device fixes, or documented behavior.
- Affected devices: All supported displays may be affected because shared firmware, setup, or build files changed.
Known issues
- No release-specific known issues are listed automatically for this release.
- Check open GitHub issues before updating devices you rely on every day.
Summary
- 12 user-facing changes are included in this release.
- Release range:
v1.2.6tov1.3.0.
User-facing changes
User-facing features
- Consolidate the 4848S040 setup guides (#447)
- Place display picker actions side by side (#446)
- Validate artwork formats for ESPHome 2026.11 (#463)
- Show device pairing codes and open setup after pairing (#467)
- Make the Configure Screen button blue (#472)
- Open EspDesktop from the setup wizard (#473)
- Expand the Mac application shortcut catalog (#468)
- Show all shortcuts in the app subpage editor (#485)
- Add a way back from the editor demo (#491)
- Add OpenCode Desktop shortcut template (#495)
- Expose EspDesktop cards as Home Assistant buttons (#487)
User-facing bug fixes
- Fix clipped card picker tiles on hover (#494)
Mac verification
Confirmed the installed Mac app from build run 43640770007 with fingerprint f49ba06dda3856d98421a4c436b07921a5308df8565895d7addb1498e2b39324.
v1.2.6
EspDesktop v1.2.6
Changes since v1.2.5.
What changed?
- User-facing features: 4 changes. Notable: Use the device name or MAC suffix in web editor tab titles; Simplify release testing to one Mac confirmation.
Update guidance
- Recommended for users who want the latest firmware, setup page, device fixes, or documented behavior.
- Affected devices: All supported displays may be affected because shared firmware, setup, or build files changed.
Known issues
- No release-specific known issues are listed automatically for this release.
- Check open GitHub issues before updating devices you rely on every day.
Summary
- 5 user-facing changes are included in this release.
- Release range:
v1.2.5tov1.2.6.
User-facing changes
User-facing features
- Use the device name or MAC suffix in web editor tab titles (#440)
- Simplify release testing to one Mac confirmation (#441)
- Restore firmware rollback in the display editor (#439)
- Refresh the device name field after restoring a backup (#444)
Mac app
- Connect to and manage multiple displays independently from Mac Settings or the menu bar. Existing pairings carry over. (#443)
Mac verification
Confirmed the installed Mac app from build run 43208475137 with fingerprint 0409a8c9bb4738c233dee46a1f7a39d02c029558b6d394f23a475489fa481a6d.
v1.2.5
EspDesktop v1.2.5
Changes since v1.2.4.
What changed?
- User-facing features: 11 changes. Notable: Tell users when the display needs a newer Mac app; Use the blue fingerprint as the Mac app icon.
- User-facing bug fixes: 2 changes. Notable: Keep app shortcut cards enabled in the web editor; Keep the backlight on during Wi-Fi setup.
Update guidance
- Recommended for users who want the latest firmware, setup page, device fixes, or documented behavior.
- Affected devices: All supported displays may be affected because shared firmware, setup, or build files changed.
Known issues
- No release-specific known issues are listed automatically for this release.
- Check open GitHub issues before updating devices you rely on every day.
Summary
- 13 user-facing changes are included in this release.
- Release range:
v1.2.4tov1.2.5.
User-facing changes
User-facing features
- Tell users when the display needs a newer Mac app (#393)
- Use the blue fingerprint as the Mac app icon (#402)
- Use the blue fingerprint as the favicon (#404)
- Add Mac pairing to the setup wizard (#408)
- Guide unpaired displays to the Companion app (#412)
- Default setup to adding shortcut pages (#409)
- Show the first card after setup and disable Night Schedule by default (#411)
- Hide the Wi-Fi icon on the Setup screen (#422)
- Use a pill selector for shortcut type (#426)
- Match the fingerprint icon to Dock height (#425)
- Refresh pairing instructions only on the setup screen (#431)
User-facing bug fixes
- Keep app shortcut cards enabled in the web editor (#403)
- Keep the backlight on during Wi-Fi setup (#406)
Device verification
The Guition 4848S040 ran a shortcut on the paired Mac and reconnected to it after reboot.
Tested build run 43101175276 with fingerprint 90271f04bd255f99f669c36937dbbf199443fc3684a8bc8a2b65d813e56189b2.
v1.2.4
EspDesktop v1.2.4
Changes since v1.2.1.
What changed?
- User-facing features: 3 changes. Notable: Build around the S3 Mac control surface; Add touchscreen and web editor demos to the website.
- User-facing bug fixes: 1 change. Notable: Fix Mac app updates and add Check for Updates to the app menu.
Update guidance
-
Recommended for users who want the latest firmware, setup page, device fixes, or documented behavior.
-
Affected devices: All supported displays may be affected because shared firmware, setup, or build files changed.
-
On Apple silicon, install the Mac app with
brew install --cask jtenniswood/tap/espdesktop.
Known issues
- No release-specific known issues are listed automatically for this release.
- Check open GitHub issues before updating devices you rely on every day.
Summary
- 4 user-facing changes are included in this release.
- Release range:
v1.2.1tov1.2.4.
User-facing changes
User-facing features
- Build around the S3 Mac control surface (#384)
- Add touchscreen and web editor demos to the website (#389)
- Improve the keyboard shortcut setup and app catalogue (#394)
User-facing bug fixes
- Fix Mac app updates and add Check for Updates to the app menu (#388)
Device verification
The Guition 4848S040 ran a shortcut on the paired Mac and reconnected to it after reboot.
Tested build run 43028454237 with fingerprint 016795171bc27e4165e40a84c17d21ac58766686dcd8bb925e6d0c085145d7c9.
v1.2.1
Firmware patch for the Guition ESP32-S3 4848S040. This update includes fixes for saving card changes and display settings, and improves how the display follows a paired Mac’s sleep and wake while locked.
The firmware passed automated release checks. The on-device release test was skipped. This release contains firmware downloads only.
v1.2.0
EspDesktop v1.2.0
Changes since v1.1.2.
What changed?
- User-facing features: 18 changes. Notable: Expand Figma keyboard shortcut presets; Expand ChatGPT Desktop shortcut presets.
Update guidance
- Recommended for users who want the latest firmware, setup page, device fixes, or documented behavior.
- Affected devices: All supported displays may be affected because shared firmware, setup, or build files changed.
Known issues
- No release-specific known issues are listed automatically for this release.
- Check open GitHub issues before updating devices you rely on every day.
Summary
- 18 user-facing changes are included in this release.
- Release range:
v1.1.2tov1.2.0.
User-facing changes
User-facing features
- Expand Figma keyboard shortcut presets (#340)
- Expand ChatGPT Desktop shortcut presets (#341)
- Expand Safari and installed web app shortcuts (#337)
- Expand Claude Desktop Code shortcuts (#339)
- Default card curves and app icons to Large (#343)
- Polish Mac Companion pairing controls (#342)
- Remove the idle return-home setting (#345)
- First Run Setup (#262)
- Remove touchscreen PIN protection (#346)
- Give Mac Lock its own card type (#347)
- Erase only flash sectors needed for layout saves (#351)
- Enable the Night Schedule by default (#352)
- Move Window Control cards out of the stable build (#348)
- Remove App Subpages info banner (#344)
- Remove the Cover Art Screen Saver (#350)
- Support ESPHome 2026.11 firmware builds (#353)
- Test the complete native layout and editor update (#360)
- Update Companion card picker text (#362)