Skip to the content
2 layers100 × 30 mmSlide and twist, the printed circuit board in 3D

ESP32 midi controller over UDP network. Firmware is using AtomVM.

Size
100 × 30 mm
Copper layers
2
Thickness
1.6 mm
Parts
12
Nets
26
Pads
66
Tracks, vias
86, 0
Pours
1
Routed
Yes
KiCad
KiCad 9.0 (file 20241229)
Created
22 Nov 2025
Updated
23 Dec 2025

Overview

Slide and twist is an open-source printed circuit board by nanassound, from the nanassound/midimesh_esp32 repository on GitHub. It is a 2-layer board of 100 × 30 mm with 12 parts on 26 nets, routed with 86 tracks and 0 vias.

It is built around the PTL30-19G1-103B2. Its parts include 2 connectors, 1 resistor, 1 IC, 1 diode and 1 switch. It belongs with the audio and music boards and the ESP32 and RISC-V boards of this library.

Main components

1

README

README.md

midiMESH ESP32

Open-source modular MIDI devices ecosystem over WiFi using ESP32-C3 and AtomVM. Control your DAW and devices wirelessly with various hardware controllers.

Key Features:

  • MIDI CC messages over UDP/WiFi
  • Concurrent multi-knob support with Elixir processes
  • Operational in AP mode or STA mode
  • Modular hardware designs (Eurorack-compatible)
  • Runs AtomVM (Erlang VM) on ESP32-C3

Demos:

Project Structure

text
midimesh_esp32/
├── firmware/     # Elixir/AtomVM firmware for ESP32-C3
└── hardware/     # KiCad PCB design files for midiMESH devices

This repository contains both the firmware and hardware designs for the midiMESH ecosystem.

  • Firmware: See firmware/ for the Elixir code that runs on the ESP32-C3. Detailed build, flash, and configuration instructions are in firmware/README.md.
  • Hardware: See hardware/ for various midiMESH device designs. Each subdirectory contains KiCad design files for a specific controller.

Firmware

The firmware is written in Elixir and runs on AtomVM, a lightweight Erlang VM for embedded systems.

Features:

  • Supports multiple analog potentiometers with concurrent processing
  • Sends MIDI CC (Control Change) messages over UDP
  • LED indicator for WiFi connection status
  • Broadcasts to local network on port 4000
  • Modular architecture with separate modules for Knob, Switch, MIDI operations, and Config

Hardware pins (configurable in code):

  • Knob 1: GPIO 0
  • Knob 2: GPIO 1
  • LED: GPIO 8

For complete setup instructions, WiFi configuration, building, and flashing, see firmware/README.md.

Hardware

The midiMESH ecosystem includes various Eurorack-compatible MIDI controller designs, each tailored for different control needs.

Available Designs:

  • Slide & Twist: Controller with knobs and slide potentiometer
  • Control Voltage (coming soon): Wireless MIDI to CV for Eurorack modular synth

Design Files:

  • KiCad v9.0 schematics and PCB layouts
  • Location: hardware/
  • Each device has its own subdirectory with complete design files

For detailed component information and specifications for each controller, see hardware/README.md.

The design files are provided as-is for viewing, modification, and manufacturing.

Getting Started

Prerequisites

For Firmware:

For Hardware:

  • KiCad 9.0 or later to view/edit design files

Quick Start

  1. Flash firmware: Follow the detailed instructions in firmware/README.md to configure WiFi, build, and flash the ESP32-C3.
  2. View hardware designs: See hardware/README.md for available midiMESH devices. Open the KiCad project files to explore or modify the PCB designs.
  3. Receive MIDI: Use the companion midiMESH desktop receiver to receive UDP MIDI and forward it to a virtual MIDI port for use in your DAW.

Related Projects

  • midimesh_desktop_receiver: Desktop application that receives UDP MIDI messages from the ESP32 and forwards them to a virtual MIDI port (e.g., IAC Driver on macOS).

License

This project is dual-licensed:

Firmware License

The firmware (in firmware/) is licensed under the Apache 2.0 license.

See firmware/LICENSE.md for full license text.

Hardware License

The hardware design (in hardware/) is licensed under the CERN Open Hardware License v2 - Weakly Reciprocal (CERN-OHL-W).

See hardware/LICENSE.md for full license text.

Derivative Works Guidelines

Both licenses allow you to freely use, study, modify, and distribute this project and create derivative works.

Important: You must NOT use the "Nanas Sound" name, logo, or any other Nanas Sound identifiers in your derivative works. Nanas Sound is a business name of Nanas Sound OÜ.

Examples of acceptable naming:

  • Correct: "Strawberry Field - MIDIYummy"
  • Incorrect: "Nanas Sound's midiMESH" or "Based on Nanas Sound midiMESH"

We encourage you to create and share your own versions of this project while respecting our trademark.

Contributing

Contributions, issues, and feature requests are welcome. Feel free to open an issue or submit a pull request.


Copyright 2025 Nanas Sound OÜ

Parts

12
QtyValueFootprintReferences
49mm_NoDet_10k_DShaft4ms_Potentiometer:Pot_9mm_DShaftPOT1, POT2, POT3, POT4
1220ΩResistor_THT:R_Box_L13.0mm_W4.0mm_P9.00mmR1
1Conn_01x024ms_Connector:Pins_1x02_2.54mm_THJ1
1ESP32-C3_SUPERMINI_THESP32-C3_SUPERMINI_TH:MODULE_ESP32-C3_SUPERMINI_THU2
1Eurorack_Power_16pin_Shrouded4ms_Connector:Pins_2x08_2.54mm_TH_EuroPower_ShroudedJ2
1LEDLED_THT:LED_D3.0mm_FlatTopD1
1LOGOnanassound:logo_nanasG***
1PTL30-19G1-103B2Bourne-PTL30-19G1-103B2:PTL3019G1103B2VR1
1Toggle_SPDT_SubMini_2posTestPoint:TestPoint_2Pads_Pitch2.54mm_Drill0.8mmSW1

Similar boards

  • 2 layers61 × 111.8 mmProfane geometry jackboard, the printed circuit board in 3D

    Profane geometry jackboard

    hearthsinger/profane-geometry

    Digitally controlled triangle-core VCO with 4 individual waveshapes, plus one mix output with per-wave attenuation

    23 parts
  • 2 layersNrf bga, the printed circuit board in 3D

    Nrf bga

    github-linguist/linguist

    Language Savant. If your repository's language is being reported incorrectly, send us a pull request!

    12 parts14kMIT
  • 2 layers66.9 × 74.5 mmDeskHop, the printed circuit board in 3D

    DeskHop

    hrvach/deskhop

    Fast Desktop Switching Device

    12 parts7.9kGPL-3.0
  • 2 layers40 × 15 mmSensors, the printed circuit board in 3D

    Sensors

    google/mozc-devices

    Circuit diagrams and firmware source code for Gboard DIY keyboards

    12 parts3kApache-2.0
  • 2 layers42.7 × 56.5 mmTle6240 driver, the printed circuit board in 3D

    Tle6240 driver

    rusefi/rusefi

    rusefi - GPL internal combustion engine control unit

    12 parts1.2k
  • 2 layers49 × 25 mm5v boost regulator, the printed circuit board in 3D

    5v boost regulator

    hackclub/OnBoard

    💡 Join 1,000 teenagers and make your first PCB with a $100 grant!

    12 parts915
  • 2 layers28.3 × 10.3 mmTap Photosensor PCB, the printed circuit board in 3D

    Tap Photosensor PCB

    VoronDesign/Voron-Tap

    Tap is a nozzle-based z-probe for the V2 and Trident printer designs. The entire toolhead moves to trigger an optical switch. Tap offers many advantages:

    12 parts716GPL-3.0

Questions

How big is the Slide and twist PCB?

It measures 100 × 30 mm and has 2 copper layers, 1.6 mm thick.

What parts does the Slide and twist use?

12 parts, built around the PTL30-19G1-103B2. The full list of its parts is on this page, with links to each part's symbol and footprint where PCBKit's library has them.

Where can I download the Slide and twist KiCad files?

From the nanassound/midimesh_esp32 repository on GitHub, at the commit this page was made from: the board is hardware/slide_and_twist/slide_and_twist.kicad_pcb and its schematic hardware/slide_and_twist/slide_and_twist.kicad_sch. PCBKit opens the board in the browser, with nothing to install.

Can I use the Slide and twist design in my own project?

Its repository states no licence, so its author keeps all rights: ask nanassound before reusing the design.