Installation

Requirements

• A supported device:
  • Guition ESP32-S3 4848S040 (4")
  • Guition ESP32-P4 JC8012P4A1 (10.1")
• Home Assistant with at least one media_player entity
• Google Chrome or Microsoft Edge (for the web installer)
• A USB-C cable

Flash firmware

Select your device and click Install to flash the firmware directly from your browser. No ESPHome dashboard or YAML required.

Device:Guition ESP32-S3 4848S040 (4")Guition ESP32-P4 JC8012P4A1 (10.1")

TIP

If you prefer to install via the ESPHome dashboard, see ESPHome Config.

Connect to Wi-Fi

After flashing, the device creates a Wi-Fi hotspot called esphome-media-player. Connect to it from your phone or laptop and enter your home Wi-Fi credentials. The device will reboot and join your network.

Add to Home Assistant

1. Home Assistant should automatically discover the device under Settings → Devices & Services. Click Configure to add it.

   

2. Once added, find the device under Settings → Devices & Services → ESPHome.

   

3. Open the device page and set the Media Player Entity field to the media_player entity you want to control (e.g. media_player.living_room_speaker).

   

4. Enable the media player controls for the entity if prompted.

   

That's it — the screen should start showing now-playing info from your selected media player.

Next steps

• Firmware Updates — automatic over-the-air updates
• Settings — configure brightness, timeouts, and display options
• Speaker Grouping — set up multi-room speaker control
• Source Inputs — show media info from a TV or Line-in input
• Troubleshooting — common issues and fixes