# Mac control FAQ

[Original EspDesktop guide](https://espdesktop.com/reference/faq)

## Setup and pairing

### Which display works with Mac controls?

Mac Companion currently works with the **4-inch Guition ESP32-S3 4848S040**. See [Supported Display](https://espdesktop.com/screens/4848s040) for the model and [Install](https://espdesktop.com/screens/4848s040#install) for the firmware steps.

### Which Macs does EspDesktop support?

The EspDesktop Mac app requires **Apple silicon and macOS 13 or newer**. Intel Macs are unsupported, including 2019 Intel MacBook Pro and iMac models. Follow the [Mac app setup guide](https://espdesktop.com/screens/4848s040#download) to download it and pair your display.

### Does EspDesktop need Home Assistant?

EspDesktop runs Mac controls over your local network without Home Assistant. Use USB for the firmware installation, then connect the display to 2.4 GHz Wi-Fi for Mac control. For a touchscreen that controls Home Assistant devices, see the [EspDesktop and EspControl comparison](https://espdesktop.com/reference/espdesktop-or-espcontrol).

### Can I use EspDesktop over USB without Wi-Fi?

Use a USB-C data cable to install firmware on the Guition 4848S040. For Mac controls, the display needs 2.4 GHz Wi-Fi and must be on the same local network as your Mac. See [Wi-Fi setup and recovery](https://espdesktop.com/getting-started/troubleshooting#wifi-setup-and-reset-recovery).

### Can I use several EspDesktop displays with one Mac?

EspDesktop v1.2.6 supports multiple Guition 4848S040 displays connected to one Mac. Open **Settings → Displays → Add Display** and pair each one with its own code. You can connect or disconnect one display while the others stay available. See [Mac app settings](https://espdesktop.com/settings/mac-app).

### Why can't I see my display in the Mac app?

Confirm that the Mac and display are on the same local network and allow EspDesktop local-network access if macOS asks. Some guest WiFi or network-isolation settings prevent discovery. Choose **Enter address manually** in the app and enter the display's IP address or `.local` name if needed.

### Do the Mac app and display firmware need to match?

Use the Mac app and display firmware from the same EspDesktop release. A newer development build may use Companion features that an older release app does not understand.

## Mac controls

### Why don't keyboard shortcuts work?

Enable EspDesktop in **System Settings → Privacy & Security → Accessibility**. See [Mac Companion permissions](https://espdesktop.com/mac-controls/security) for the controls that use it.

### Why can't the display open an app or folder?

The app or folder must be approved in EspDesktop. Open **Apps** or **Folders** in the Mac app and confirm the item is still available. Removing it from the app disables its associated cards.

### How do I replace a display or reset pairing?

In **Settings → Displays**, choose **Forget** beside the display you’re replacing. To reuse a previously paired display, tap **Paired** in the touchscreen’s Settings and confirm **Reset pairing**. Enter the new code in the Mac app.

## More help

See [Troubleshooting](https://espdesktop.com/getting-started/troubleshooting) or [report a problem](https://github.com/jtenniswood/espdesktop/issues).

[Next · Compatibility](https://espdesktop.com/reference/companion-compatibility)
