Skip to main content
Advanced engineering
Deckmatics Academy article cover: What is OpenDeck and how can it build a DJ controller?
Credits: Deckmatics

Deckmatics

Deckmatics vector SVG generated on this page.

Deckmatics Academy article cover: What is OpenDeck and how can it build a DJ controller?
MIDI mapping, mods and homebrew · Intermediate · 5 min read

What is OpenDeck and how can it build a DJ controller?

OpenDeck combines a board, firmware and web configurator for building a MIDI controller without circuit design or programming: driver-free USB MIDI.

Building a MIDI controller nearly always stalls at the same point, and it is not the buttons. Before one control works, you must solve two tasks unrelated to DJing: designing the circuit reading components and writing firmware translating readings into MIDI. Weeks of work invisible in the final result.

OpenDeck removes those tasks. It combines a board, firmware and web configurator so you handle what adds value: which controls you want, where they go and what each does.

What problem OpenDeck solves

Underneath, a MIDI controller has two layers. Electronics reads buttons, knobs, faders and encoders and switches LEDs. Logic decides which MIDI message matches each reading and how outputs behave.

Starting from scratch makes both layers yours. They are precisely the least interesting tasks when you want a control unavailable commercially: a stems block, specific FX or a layout no manufacturer offers.

OpenDeck handles both. Connect components to the board; the platform reads them, sends MIDI and manages feedback. You move from an “electronics project” to a “controller project”.

Be precise about its boundaries. OpenDeck is not a mapping: assigning software functions is a later layer. Nor is it a mod or alternative firmware: you alter nobody else’s hardware, replace no manufacturer’s firmware and bypass no protection. Building on an open platform with your own hardware avoids mod-related warranty, lockout and lost-setting risks.

How OpenDeck works

The board is central. Every controller component connects to it and it communicates with the computer. It turns loose controls into a controller.

Platform firmware runs on the board, doing three things: reading button presses, turns or fader movement; translating them into MIDI; and managing outputs such as LEDs reflecting software’s real state.

Behaviour is configured rather than programmed. A web configurator describes each control and output instead of requiring code writing and compilation. The computer sees a MIDI device rather than proprietary hardware requiring mandatory middleware.

OpenDeck's parts and their jobs
Part What it does What it saves
Board The platform's centre, receiving every controller component.Designing and manufacturing your own circuit
Firmware Reads inputs, sends MIDI and manages controller outputs.Programming logic from scratch
Web configurator Defines each control and output's behaviour.Writing code for every change
Driver-free USB MIDI Sends MIDI over USB without the system installing a driver.Driver installation and compatibility checks
Components Buttons, knobs, faders, encoders and LEDs you choose and connect.Nothing: you decide here, and this adds value

You design or program none of these platform parts. Choosing components and their functions remains yours.

What connects to an OpenDeck board

The platform does not decide your controls: that is your job and the real value. Choose their number, types and layout.

Types match commercial controllers: buttons and pads for discrete actions, knobs and faders for continuous parameters, encoders for endless controls and LEDs for feedback. Finalise the list before buying anything: the guide to building a MIDI controller for stems or FX covers that work.

The web configurator: configure without programming

The biggest daily difference: scratch-built development requires code changes, compilation and firmware reloading for every adjustment; the web configurator lets you describe and apply behaviour.

Change a control’s message, MIDI channel or output response without a code editor: iteration becomes a configuration adjustment rather than a development cycle.

Do not confuse “no programming” with “no decisions”. The configurator saves firmware writing, not thinking: each component’s message, channel and LED feedback remain your choices.

Why it works without drivers across systems

Understand where compatibility comes from: it avoids custom hardware working only on the test computer.

Official documentation is explicit: features include “USB MIDI — No drivers required” and “Universally supported — Windows, macOS, Linux, Android, iOS”. In practice, connect the controller and the system recognises it without installation or waiting for a manufacturer driver for your OS version.

The effect is twofold. The controller appears as a MIDI device on any listed system and works with any software accepting MIDI input without the program knowing or partnering with the platform. This distinguishes hardware needing manufacturer support from hardware speaking the common language.

HID or proprietary protocols take the opposite route: compatibility depends on each application implementing them. The standard enables today’s program and tomorrow’s alternative.

What else the platform handles

The capability list matters because these features would otherwise require firmware development.

Inputs include buttons, potentiometers, FSR sensors and encoders. Outputs include single-colour and RGB LEDs. Nextion touchscreens are supported when a project needs a display. Other labour-saving functions include up to 10 presets, 14-bit pitch bend, high-resolution control messages and NRPN, plus DIN MIDI and BLE MIDI on selected boards.

The configurator works online and offline; firmware updates run in the browser.

The platform is hardware-independent too, supporting several microcontroller families and boards: Blackpill, nRF52840 DK, Pico, Pico2, STM32F4Discovery, Teensy 4, Teensy 4.1 and WS405R. Board choice does not lock you in; the same design can move between them.

The standard behind each message

Configuring controls means making decisions within MIDI, with two details to remember.

First, the range. Continuous-control messages carry 0 to 127 values, seven bits. Enough for volume, filters or FX sends, explaining a continuous control’s 128 positions. If you notice steps, it is the standard rather than the platform.

Second, reserved control numbers. Numbers 120 to 127 are reserved for Channel Mode Messages, so are poor candidates for controls. Choose outside that range and distribute MIDI channels carefully to avoid common collisions between controllers.

OpenDeck does not decide this: these are configuration choices documented by the standard.

Projects it suits and projects it does not

It suits known missing controls unavailable in the desired form: stems blocks, custom FX or highly specific workflows. It suits prototyping layouts without committing to manufacturing. It also suits compatibility requirements: working with any software and system without drivers.

It does not suit missing software functions. Mapping solves those, not hardware: a program not exposing a function cannot gain it through another control. It is not a finished product with factory casing and finish; mechanics and assembly remain yours. It also does not process audio: it sends and receives MIDI, which carries no sound.

Rule out one final mismatch: a commercial device lacking a feature belongs to mods and alternative firmware, with their risks and limits. OpenDeck starts from scratch with your hardware.

Next step

This closes the custom-hardware block. The platform takes electronics and firmware, returning the job of deciding which controller you want.

Continue in reverse order: first finalise design decisions—control count, types, LEDs and display. Then return to the cluster foundation, MIDI mapping, because your controller is useless until messages are assigned to real software functions. If luminous feedback is included, learn software LED control last: a separate layer from input.

Frequently asked questions

Is OpenDeck a finished controller?

No. It is a platform: board and firmware handle electronics, but you choose and connect components and decide what each does.

Do I need to program the firmware?

No. Platform firmware already implements the logic, and you adjust each control's behaviour through the web configurator without writing or compiling code.

Does it need drivers?

No. Official documentation states driver-free USB MIDI and support for Windows, macOS, Linux, Android and iOS, so the system recognises it without installation.

Is this a mod or alternative firmware?

No. You modify no manufacturer's hardware or replace its firmware: you build equipment on an open platform. Warranty and lockout risks associated with mods do not arise here.

Does OpenDeck process audio?

No. It is a control platform sending and receiving MIDI messages, which carry no sound. Audio continues through your interface, mixer or software.

Continue learning

Sources

  1. OpenDeck — Wiki Official documentation Shantea Controls · accessed on

    Presents the platform for prototyping and developing MIDI controllers with a web configurator. Its core is the board receiving components. This page does not document detailed USB MIDI compatibility; that information comes from the official product page and repository README.

  2. Shantea Controls — An Easy Way to Build MIDI Controllers Official documentation Shantea Controls · accessed on

    Practical proposition, quoted verbatim: “Instead of spending time on circuit design, programming, and solving lots of unnecessary problems, simply connect the components of your MIDI controller to an OpenDeck board and you're done. The web configurator allows for unparalleled customization of every aspect of your MIDI controller.” Features include “USB MIDI — No drivers required” and “Universally supported — Windows, macOS, Linux, Android, iOS”. Also documents an online configurator without installation, browser firmware updates, inputs (buttons, potentiometers, FSR, encoders), outputs (single-colour and RGB LEDs), Nextion touchscreens, up to 10 presets, 14-bit support for pitch bend, high-resolution CC and NRPN, and DIN MIDI/BLE MIDI on selected boards.

  3. OpenDeck (repositorio) Official documentation Shantea Controls · accessed on

    Project repository: entry point for platform documentation and firmware. README states “no firmware development required” and “hardware-independent - supports multiple MCU families and development boards”, because it “lets you focus on hardware and interaction design rather than tweaking and debugging firmware”. Configurator supports online/offline use and boards Blackpill, nRF52840 DK, Pico, Pico2, STM32F4Discovery, Teensy 4, Teensy 4.1 and WS405R.

  4. MIDI 1.0 Control Change Messages (Data Bytes) Technical standard MIDI Association (MMA) · accessed on

    Context for the MIDI standard underlying controller messages: control messages and their 0–127 range, with control numbers 120–127 reserved for Channel Mode Messages.

Last technical review: 29/09/2026. Please report any errors so they can be corrected.