# Getting started with EspDesktop

[Original EspDesktop guide](https://espdesktop.com/screens/4848s040)

Pair your display with your Mac to open apps and folders or run shortcuts from your desk.

## Buy the screen

Buy the **4-inch Guition ESP32-S3 4848S040** from AliExpress. Once it arrives, follow the firmware installation steps below.

[AliExpress (US)](https://s.click.aliexpress.com/e/_c3IAOLXl)[AliExpress (Global)](https://s.click.aliexpress.com/e/_c4m73SzH)

![4-inch Guition 4848S040 on a desk stand, displaying a 3-by-3 grid of Mac app tiles](https://espdesktop.com/images/espdesktop-desk.jpg)

## Install firmware

Connect the screen with a **USB-C data cable**. In desktop Chrome or Edge, select **Install EspDesktop**.

[Open the browser-based firmware installer](https://espdesktop.com/screens/4848s040#flash-the-firmware)

Select the new USB port and leave the screen plugged in until it restarts.

Join the Wi-Fi hotspot shown on the screen and open the address it lists. Select your \*\*2.4 GHz Wi-Fi\*\* and save, then reconnect your computer to that network.

[Get help with Wi-Fi](https://espdesktop.com/getting-started/troubleshooting#wifi-setup-and-reset-recovery)

[![Configure your Wi-Fi screen showing the temporary hotspot name and the address to open in a browser](https://espdesktop.com/images/device-setup-wifi-screen.jpg)](https://espdesktop.com/images/device-setup-wifi-screen.jpg)

## Set up the Companion app

Use an **Apple silicon Mac with macOS 13 or newer** and install the Mac app and display firmware from the same release.

[Download for Mac](https://github.com/jtenniswood/espdesktop/releases/download/v1.3.1/EspDesktop-1.3.1.dmg)

[See all Mac downloads](https://espdesktop.com/download)

1.  Move EspDesktop to **Applications** and open it. Choose **Allow** if macOS asks for **Local Network** access.
2.  Select your display in the Mac app and choose **Continue**. The touchscreen shows a four-letter code.
3.  Enter that code in the Mac app and choose **Connect**. The code screen closes on the display when pairing succeeds.

You can also show the code by tapping **Pair** on the display’s Setup screen or **Unpaired** in its Settings. To copy the code from your browser, choose **Open pairing webpage** in the Mac app, then **Copy**.

A green dot in the EspDesktop menu shows that your display is connected. Choose **Add device** from the same menu to pair another screen.

If the display asks **Reset pairing?**, confirm on the touchscreen to disconnect the previous Mac and show the new code. If your Mac shows **Pairing Required**, see [how to re-pair the display](https://espdesktop.com/getting-started/troubleshooting#the-display-will-not-pair).

[Get pairing help](https://espdesktop.com/getting-started/troubleshooting#the-display-will-not-pair) · [Check for Mac app updates](https://espdesktop.com/settings/mac-app#check-for-mac-app-updates)

[![EspDesktop touchscreen showing four boxed letters and a Done button on the Pairing screen](https://espdesktop.com/images/device-pairing.jpg)](https://espdesktop.com/images/device-pairing.jpg)

## Set up your screen

When the Mac app shows **You’re connected**, choose **Configure Screen**. Your browser opens the display’s setup wizard, where you can choose which apps appear on your screen. To open the editor later, choose **Device** under **Mac Settings → Displays**.

[View setup wizard](https://espdesktop.com/features/first-run)

After setup, customise your [Home screen](https://espdesktop.com/features/home) and [subpages](https://espdesktop.com/features/subpages) with folders, website links, shortcuts, and more.

[Choosing between Mac controls and Home Assistant?](https://espdesktop.com/reference/espdesktop-or-espcontrol)

![Choose your apps step in the web editor, with a search field and switches to add up to eight apps](https://espdesktop.com/images/first-run-choose-apps.png)
