Skip to content
WDECK Download ↓
A/00 Desktop app · Windows

The editor behind the keys.

Build layouts, assign actions and flash firmware from one app. It runs in the background and keeps the screen in sync over USB.

Download v1.1.0 ↓ Features ↓

Drag an action onto a key and the device follows along.

  • PlatformWindows (macOS planned)
  • Versionv1.1.0
  • LinkUSB serial, up to 921,600 baud
  • Grid5 × 3 keys per page
  • Built withPython 3.11, Flask, Socket.IO
The Wdeck app: actions on the left, the key grid in the middle and the settings of the selected key below
Main console — toolbox, key grid, key propertiesv1.1.0

Run the app as Administrator. Sending global hotkeys, changing per-app volume and launching programs all need it on Windows.

A/01 Features

What the app does.

Five parts of the app, each shown as it looks today.

01 — Editor

Visual key editor

Drag actions from the toolbox onto the grid, then set a label, colour and icon for each key. The device follows along as you edit.

  • Colour and custom image per key
  • Icon gallery and uploads
  • Pages and folders
The weather key selected: its icon, frame colour and city
02 — Profiles

Automatic profiles

The app watches which window has focus and loads the matching layout on the device, so the keys always belong to what is in front of you.

  • Focus-based switching
  • Unlimited pages and folders
  • Per-application profiles
Pages linked to OBS, Blender, Discord and Premiere Pro
03 — System

System and media controls

Volume, microphone mute, screen brightness and media keys, plus OBS triggers — all without leaving what you are doing.

  • Audio levels and mutes
  • Brightness control
  • Media playback keys
Media, widget and app volume actions next to keys with volume bars
04 — Firmware

Built-in flasher

Pick the display controller and panel type, then press Build & upload. The app finds the COM ports and uploads the build — no Arduino IDE anywhere in sight.

  • ILI9488, ST7796, ST7789, ILI9341
  • Automatic COM port detection
  • Build log you can copy
Or flash in the browser →
Install firmware: display controller, panel type, USB port and Build & upload
05 — Preview

Case colour preview

Set the on-screen casing and stripe colour so the preview in the app matches the printed deck on your desk.

  • Casing colour
  • Accent stripe colour
  • Saved automatically
Style menu with casing and stripe colour, the preview in blue with an orange stripe
A/02 Actions

27 actions,
in five groups.

Every action sits in the app's toolbox. Drag one onto a key, adjust its label and icon, and it is ready to use.

Global control · 12
  • Folder
  • Multi-action
  • Hotkey
  • Launch app
  • Website
  • Volume up
  • Volume down
  • Mute
  • Sleep
  • Shutdown
  • Audio output
  • Toggle

The basics: shortcuts, programs, websites, system volume and power. A multi-action runs several steps in a row.

OBS Studio · 4
  • Scene
  • Record
  • Stream
  • Mute source

Talks to OBS through its built-in WebSocket, so the keys show whether you are live or recording.

Discord · 4
  • Mic mute
  • Deafen
  • Voice chat
  • Leave call

Linked to the Discord app, so the mute key turns red the moment you are muted.

Media · 3
  • Back
  • Play / pause
  • Next

Uses the system media keys, so it works with whatever is playing.

App volume · 4
  • App vol up
  • App vol down
  • App mute
  • App vol status

Pick one running program; the key shows its icon and current volume.

Pages

Fifteen keys fit on a page. Folders open more pages, and a Back key is added to each one automatically.

Short videos in the build guide: Hotkey, Folder, Launch app, Web / URL, App volume, Discord.

A/03 Setup

Running in three steps.

Once the hardware is assembled, the software side takes a few minutes.

01

Download and install

Unzip the package and start the app as Administrator.

Download ↓
The Wdeck app with the actions list and the key grid
02

Connect and flash

Plug the deck in over USB, open Install firmware, choose your display and press Flash.

Install firmware screen
03

Build your first layout

Create a profile, drop actions on keys and pick colours. The screen updates as you edit.

Editing keys and seeing them on the device
A/04 Files

Downloads & source.

Everything is open. Fork it, change it, send a pull request.

.zipWindows

Wdeck app

Editor, profile manager and firmware flasher.

Download↓ .zipArduino

ESP32 firmware

Source for the device, for ILI9488 and compatible panels.

Download↓ .zipLibraries

Arduino libraries

TFT_eSPI, touch and the rest, pinned for a clean compile.

Download↓ .zipPython

App source

Python 3.11, Flask and Socket.IO.

Download↓
A/05 Questions

Common questions.

Is it free?
Yes. The app, firmware and case files are open. You only pay for the hardware.
Do I need the Arduino IDE to flash?
No. The flasher is built into the app — plug in the ESP32, open Install firmware and press Build & upload. Without the app, use the web flasher in Chrome or Edge.
Which operating systems are supported?
Windows today. macOS is planned but not ready yet.
Why does it need Administrator rights?
Sending global hotkeys to other programs, changing per-app volume and launching applications all require elevated permissions on Windows.