Display Rotation

Supported devices can rotate the display for different mounting orientations (for example to change which side the power cable exits from). Set display_rotation to rotate both the screen and touch input.

WARNING

ESPHome 2026.4 and newer handle rotation through LVGL (lvgl.rotation), including touch input. Older examples that set touch_swap_xy, touch_mirror_x, or touch_mirror_y are no longer needed.

ESP32-S3 4848S040

The 480×480 square display supports all four rotations.

display_rotation
"0" (default)
"90"
"180"
"270"

Example: 90-degree rotation

substitutions:
  name: "music-dashboard"
  friendly_name: "Music Dashboard"
  display_rotation: "90"

wifi:
  ssid: !secret wifi_ssid
  password: !secret wifi_password

packages:
  music_dashboard:
    url: https://github.com/jtenniswood/esphome-media-player
    files: [devices/guition-esp32-s3-4848s040/packages.yaml]
    ref: main
    refresh: 1s

Example: 270-degree rotation

substitutions:
  name: "music-dashboard"
  friendly_name: "Music Dashboard"
  display_rotation: "270"

wifi:
  ssid: !secret wifi_ssid
  password: !secret wifi_password

packages:
  music_dashboard:
    url: https://github.com/jtenniswood/esphome-media-player
    files: [devices/guition-esp32-s3-4848s040/packages.yaml]
    ref: main
    refresh: 1s

ESP32-P4 86 Panel

The 720x720 square display supports the same four rotations as the S3 square display.

display_rotation
"0"
"90"
"180"
"270"

Example:

substitutions:
  display_rotation: "90"

packages:
  music_dashboard:
    url: https://github.com/jtenniswood/esphome-media-player
    files: [devices/esp32-p4-86-panel/packages.yaml]
    ref: main
    refresh: 1s

ESP32-P4 JC8012P4A1

The rectangular display defaults to landscape orientation and supports all four rotations. The layout changes automatically: landscape uses artwork on the left with track details on the right, while portrait uses artwork at the top with track details underneath.

display_rotation
"0"
"90" (default)
"180"
"270"

The device also exposes Screen Rotation in Home Assistant as a dropdown with 0, 90, 180, and 270 options.

Example: portrait rotation

substitutions:
  name: "music-dashboard-10inch"
  friendly_name: "Music Dashboard 10inch"
  display_rotation: "0"

wifi:
  ssid: !secret wifi_ssid
  password: !secret wifi_password

packages:
  music_dashboard:
    url: https://github.com/jtenniswood/esphome-media-player
    files: [devices/guition-esp32-p4-jc8012p4a1/packages.yaml]
    ref: main
    refresh: 1s

ESP32-P4 JC1060P470

The 1024x600 display defaults to landscape orientation. Use "180" if you want the same landscape layout flipped upside down. Use "90" or "270" for portrait mounting.

display_rotation
"0" (default)
"90"
"180"
"270"

The device also exposes Screen Rotation in Home Assistant as a dropdown with 0, 90, 180, and 270 options.

Example: 180-degree rotation

substitutions:
  name: "music-dashboard-7inch"
  friendly_name: "Music Dashboard 7inch"
  display_rotation: "180"

wifi:
  ssid: !secret wifi_ssid
  password: !secret wifi_password

packages:
  music_dashboard:
    url: https://github.com/jtenniswood/esphome-media-player
    files: [devices/guition-esp32-p4-jc1060p470/packages.yaml]
    ref: main
    refresh: 1s

ESP32-P4 JC4880P443

The 4.3-inch display defaults to the landscape layout package, using an 800x480 canvas with artwork on the left and track details on the right. Use "270" if you want the same landscape layout flipped upside down. For portrait mounts, use packages.yaml instead of packages-90.yaml.

display_rotation
"90" (default)
"180"
"270"
"0"

The device also exposes Screen Rotation in Home Assistant as a dropdown with 0, 90, 180, and 270 options.

Example: landscape package

substitutions:
  name: "music-dashboard-43inch"
  friendly_name: "Music Dashboard 4.3inch"
  display_rotation: "90"

wifi:
  ssid: !secret wifi_ssid
  password: !secret wifi_password

packages:
  music_dashboard:
    url: https://github.com/jtenniswood/esphome-media-player
    files: [devices/guition-esp32-p4-jc4880p443/packages-90.yaml]
    ref: main
    refresh: 1s