Home

Guition JC3636K718C - ESPHome Voice Assistant Wiki

A full-featured Home Assistant Voice Assistant on the Guition JC3636K718C - a 1.8" round 360×360 touch display with a rotary knob, speaker, microphone and an addressable LED ring, driven by ESPHome.

You keep one thin YAML locally (guition-va.yaml); it pulls the firmware core and a set of optional screens from this repo at compile time, so updates are a re-pull and you choose which screens get compiled in.

➡️ Code & releases: esphome-guition-jc3636k718c-va

Pages

• Hardware - board specs, full pinout, what to buy on AliExpress
• Installation - requirements, first flash (USB), OTA, generating the sounds
• Usage - gestures, screens, the settings menu, the LED ring
• Configuration - entities, control tiles, choosing screens, wake word, run without Music Assistant
• Troubleshooting - known issues (battery %, GPIO0 strapping, performance, the knob, timezone)
• Claude Code skill - install the skill so Claude knows this board
• Changelog - release history

What it does

• Voice assistant - on-device wake word ("Alexa") or press-and-hold the screen (toggleable), full HA Assist pipeline, wake beep + music ducking.
• Boot splash - a short "HELLO!" greeting with a spinning ring on startup, then the clock.
• Music player - speaker media player in HA / Music Assistant: album art, title/artist, transport, progress.
• Timers - set by knob or voice; big countdown with a depleting ring, pause/stop, alarm on finish.
• Control tiles - swipe up for four configurable tiles toggling any HA entity (light/switch/...), each with its own icon and label.
• Home screen - clock, date, battery, weather + room temp/humidity.
• Weather screen - today plus a 7-day radial dial; the knob scrolls days, with a °C/°F toggle.
• Thermostat screen - a dial for a climate.* entity; the knob sets the target, tap toggles on/off.
• LED ring - HA-controllable light and reactive (assistant / timer / alarm / volume), each toggleable.
• Two arcade games - a lane racer and a vertical shooter.
• Modular screens - player, timer, games, weather and a commented demo are optional packages; pick which compile in and their order.

Quick start

1. Copy secrets.example.yaml → secrets.yaml, fill in Wi-Fi.
2. Copy guition-va.yaml and partitions.csv together; edit substitutions: (HA URL + your entities + the four control tiles).
3. Everything else - the firmware core, the screens, fonts, images and sounds - is pulled from GitHub at compile time, so guition-va.yaml + partitions.csv + secrets.yaml are all you keep locally.
4. First flash over USB (16 MB partition table can't be set via OTA), then OTA.
5. In Home Assistant, assign an Assist pipeline to the new device.

See Installation for the full walkthrough.

Working on this with Claude Code? Install the Claude Code skill so the assistant knows this board's pinout and gotchas.