Ultimate Documentation

Build & Master Your Wdeck.

Learn how to assemble the hardware and explore every feature of the Wdeck Studio application across two comprehensive step-by-step journeys.

WORK IN PROGRESS

This tutorial is not completely finished yet! I will be working on the details and the full guide in the coming days.
DO NOT follow this tutorial yet.

Step 02

Bill of Materials

Everything you need on your desk before starting the build.

ESP32 Core

WROOM-32 DevKit V1

1x Module

BUY MODULE

3.5" Touchscreen

ILI9488 SPI TFT (Capacitive)

1x Display

BUY DISPLAY

M3 Hardware

5x M3x14mm Countersunk

Fasteners

LOCAL STORE

3D Printed Parts

Enclosure STL Files

3D Geometry

PRINTABLES

Step 03

Tools & Workspace

Prepare your workbench with these essential tools for a smooth assembly.

Soldering Iron

Handheld or Station

320°C Opt.

Screwdriver

Manual Phillips Head

Step 09 - 10

Connecting Wires

Insulated or Solid Core

Misc. Lengths

USB Data Cable

USB-C or Micro-USB

To PC / Hub

Step 04

Case Printing

Quality starts with the base. Print the provided STL files using PETG for superior heat resistance and durability.

Layer Height: 0.2mm
Infill: 20% Gyroid
Supports: Build plate only

GET STLs ON PRINTABLES

Step 05

Wiring Checklist

Bridge the ESP32 and display. Follow our checklist to ensure every pin is in the right place.

3.3V / 5V → VCC

GND → GND

GPIO 15 → CS

GPIO 4 → RESET

GPIO 2 → DC / RS

GPIO 23 → MOSI & T_DIN

GPIO 18 → SCK & T_CLK

GPIO 32 → LED

GPIO 21 → T_CS

GPIO 19 → T_DO

GPIO 27 → T_IRQ

Step 06

Soldering Pins

Connect header pins to the display and ESP32. Use 320°C to prevent lifting the pads.

VIDEO: Soldering Technique

Step 07

Internals

Mount the ESP32 cradle into the back housing. Ensure its orientation matches the USB exit port.

VIDEO: Internal Component Layout

Step 08

Bezel Mounting

Slide the display into the front bezel. It should click into place securely.

VIDEO: Bezel Assembly

Step 09

Cable Routing

Tuck the wires away neatly using internal channels to avoid pinching during closure.

VIDEO: Cable Management

Step 10

Enclosure

Screw the front and back together using 5x M3x14mm screws for the final fit.

VIDEO: Secure Enclosure

Step 11

Calibration

The first boot will trigger touch calibration. Follow the screen prompts to align the panel.

VIDEO: Touchscreen Calibration

Step 12

Studio Installation

Download the latest Wdeck Studio installer for Windows. The application handles all hardware communication.

DOWNLOAD WDECK STUDIO

IMPORTANT: Run the installer and the app as Administrator to enable global hotkey support and audio routing.

Step 13

Dynamic Profiles

Wdeck detects your active window and switches layout automatically for smooth workflow.

VIDEO: Profile Switching

Step 14

Grid Composer

Visual grid editor for designing your 15-key layout with drag-and-drop actions.

VIDEO: Grid Editor

Step 15

Macro Engine

Chain keyboard shortcuts and system commands with precise delay timing.

VIDEO: Macro Builder

Step 16

Hardware Sync

Adjust brightness and monitor hardware health directly from the desktop application.

VIDEO: Brightness & Sync

Step 17

Audio Master

Switch default audio devices or control per-app volume levels with a single touch.

VIDEO: Audio Control

Step 18

API Hooks

Native integrations for Spotify and professional Chat Apps to control media and voice status.

VIDEO: API Integrations

Step 19

Updates

Flash the latest firmware safely without ever leaving the Wdeck Studio app.

VIDEO: Firmware Flash

Build Complete

You're Ready to Roll.

Your Wdeck is assembled and your Studio is configured. Now it's time to bridge your hardware with infinite automation.

BACK TO HOME