Wdeck Ultimate is an open-source audio-macro console project. It gives you physical control over your system, stream, and tools using a custom ESP32-powered device with a large touchscreen.
Learn more about the vision behind the Wdeck project.
This project started because I wanted a better way to control my PC. Wdeck is a bridge between physical hardware and digital actions.
It’s built on the ESP32 and replaces software shortcuts with tactile and touch controls. Since it's open-source, you can see how it works, build it yourself, or tweak it to your needs.
Everything you need for a perfect workflow.
Wdeck detects which app you're using and automatically switches the icons and macros on the fly.
Execute actions instantly. The optimized connection ensures that when you press a button or touch the screen, the PC reacts without any noticeable lag.
The hardware and software stay in sync. Any change you make in the app shows up on the display immediately.
Everything you can map, route, and configure inside the Wdeck desktop application.
Bind complex keyboard combinations, trigger external scripts, or open applications instantly. The drag-and-drop workflow makes setting up actions over all screens incredibly simple.
Why use the same layout for every app? Wdeck detects which Windows application is currently in focus and automatically switches your macro pages to the matching profile without touching a button.
Change volume, switch audio devices, or control OBS Studio smoothly. Any icon or connection you establish in the desktop app synchronizes to your physical hardware in real time with ultra-low latency.
Everything you need to build your own Wdeck Ultimate station.
480x320 SPI TFT (ILI9488). Must have Capacitive or Resistive touch layer, otherwise touch will not work!
1x Display
M3x14mm countersunk screws
5x ScrewsBuild your own Wdeck. The hardware is completely under your control.
Follow these steps to build your custom Wdeck station from scratch.
First, gather all your electronic and 3D printed components. Having everything organized on your workbench—from the ESP32 to the final screws—is essential for a smooth and successful assembly process.
Follow the wiring diagram to connect the ESP32 to the ILI9488 display. Accuracy is crucial here—verify all pinouts and double-check your soldering to ensure a stable and responsive station.
We've prepared a comprehensive text-based assembly guide to see the entire build process. This tutorial covers everything from 3D printing tips to final hardware mounting, ensuring your Wdeck is built to professional standards.
VIEW TEXT TUTORIALCurrently in production
Keep your iron around 320°C for the ESP32 pins to avoid damaging the pads.
Print the case with 0.2mm layer height and PETG for better durability and thermal resistance.
Get your Wdeck workstation up and running in minutes.
Download the latest Wdeck installer for Windows. We highly recommend running the application as an Administrator to ensure all background services, audio drivers, and hotkeys function correctly within your system.
GET WDECK APP
Once launched, connect your Wdeck via USB. The application will automatically detect the hardware. Hit the 'Flash' button to upload the latest firmware and start customizing your macro profiles immediately.
Just open the Flash Menu directly inside the Wdeck App. Connect your ESP32 via USB and flash the firmware with one click—straight from the interface.
Everything you need to build, customize, or contribute to the project.
Executable (EXE)
The main control application for Windows. Includes the flash tool, profile manager, and studio console.
Download LatestArduino Source (.zip)
The open-source firmware for the ESP32. Fully compatible with ILI9488 displays and EC11 encoders.
Source CodeLibrary Bundle (.zip)
Pre-packaged bundle of all required libraries (TFT_eSPI, Touch, etc.) for a smooth compilation.
Libraries PackPython/Flask Source
Explore or modify the Wdeck desktop application. Built with Python 3.11, Flask, and SocketIO.
App SourceSTL (Official Repo)
Ready-to-print housing parts for your printer. Includes official updates and community makes on Printables.
Get on PrintablesTroubleshooting and general information for your build.
Yes, the code and design files are open. You just need to buy the hardware components.
No. I’ve integrated a flashing tool directly into the Wdeck App. Just plug in your ESP32, open the flash menu, and it’s done in seconds. No coding or IDE setup required.
Right now it's for Windows. Mac support is on the roadmap but not ready yet.
