Software

The Desktop App

Configure layouts, map hotkeys, and manage settings using the companion application.

Wdeck App Interface
v1.0.14 Application Version
250k Serial Baud Rate
5x3 Hotkey Grid Layout

How it works

Control settings and customize buttons in the app.

Smart Profiles

Wdeck detects which app you're using and automatically switches the icons and macros on the fly.

Shortcut & key mapping

Map hotkeys, volume adjustments, or custom scripts to any screen button. Actions respond over USB without delay.

Real-time Sync

The hardware and software stay in sync. Any change you make in the app shows up on the display immediately.

Feature Deep Dive

Everything the Wdeck app is capable of, in detail.

Macro Engine Setup

01. Desktop App

The companion desktop app makes it easy to configure your console. Use the clean visual editor to set up buttons, map custom shortcuts, and update settings on the fly.

  • Visual button editor
  • Automatic application profiles
  • Built-in firmware flasher

02. Automatic profiles

The app tracks which program you are using and automatically switches the touch screen layout to match.

  • Focus-based auto switching
  • Unlimited pages and folders
  • Deep Windows integration
Smart Profiles
Media and Hardware Sync

03. System controls

Change volume, mute your microphone, or trigger OBS Studio actions directly from your desk. Any changes you save in the app update the screen instantly.

  • Audio adjustments & mutes
  • Screen brightness control
  • Icon and image uploads

04. Built-in firmware flasher

Connect your ESP32 via USB and click 'Flash' inside the app. No need to install Arduino IDE or compile code.

  • Connect over USB
  • One-click installation
  • Auto COM port scanning

05. On-screen preview

Customize the preview casing and stripe colors inside the app to match your physical 3D-printed console.

  • Customize casing color
  • Personalize accent stripes
  • Saved automatically
Casing Color Picker Customizer

Software Setup

Get your Wdeck workstation up and running in minutes.

01

Download & Install

Download the Wdeck installer for Windows. Run the setup, and we recommend launching the app as an Administrator so it can manage system volume, launch applications, and send global hotkeys smoothly.

GET WDECK APP
Download Wdeck
02

Connect & Flash

Plug your Wdeck console into your computer via a USB cable. Open the flashing menu directly inside the Wdeck app, select your device, and click 'Flash' to load the latest software automatically.

Flash Firmware
03

Customize & Enjoy

Your macro pad is ready! Create layout profiles, customize your button colors, map volume controls, and assign keys or actions. The changes will show up on your screen instantly.

Customize UI

Project Files

Everything you need to build, customize, or contribute to the project.

Wdeck App

Executable (EXE)

The main control application for Windows. Includes the flash tool, profile manager, and studio console.

Download Latest

ESP32 Firmware

Arduino Source (.zip)

The open-source firmware for the ESP32. Fully compatible with ILI9488 displays and EC11 encoders.

Source Code

Arduino Libs

Library Bundle (.zip)

Pre-packaged bundle of all required libraries (TFT_eSPI, Touch, etc.) for a smooth compilation.

Libraries Pack

App Source

Python/Flask Source

Explore or modify the Wdeck desktop application. Built with Python 3.11, Flask, and SocketIO.

App Source

Common Questions

Troubleshooting and general information for your setup.

Is this free?

Yes, the code and design files are open. You just need to buy the hardware components.

Do I need Arduino software to flash the firmware?

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.

Which OS is supported?

Right now it's for Windows. Mac support is on the roadmap but not ready yet.

Ready to build the hardware?

The app is only half the story. Check out the hardware guide or follow the step-by-step tutorial.

Hardware Guide Full Tutorial