Skip to the content
2 layers70.8 × 32.8 mmVbox thumbs framework left, the printed circuit board in 3D

Vbox thumbs framework left

CarVac/vbox6

A rectangle controller for Melee with buttons arranged vertically instead of on a flat surface

Size
70.8 × 32.8 mm
Copper layers
2
Thickness
1.6 mm
Parts
3
Nets
16
Pads
36
Tracks, vias
7, 9
Pours
1
Routed
Yes
KiCad
KiCad 9.0 (file 20241229)
Created
23 Oct 2023
Updated
10 Jul 2026

Overview

Vbox thumbs framework left is an open-source printed circuit board by CarVac, from the CarVac/vbox repository on GitHub. It is a 2-layer board of 70.8 × 32.8 mm with 3 parts on 16 nets, routed with 7 tracks and 9 vias.

Its parts include 2 switches and 1 connector.

README

README.md

vbox

Overview of pcb and hand clusters

Angled view of hand clusters

A rectangle controller for Melee with buttons arranged vertically instead of on a flat surface.

It's intended to be highly modular and configurable to fit different people's button layout preferences and hand sizes.

The left- and right-hand finger clusters and thumb clusters are mirror images of each other, with shared daughterboard PCBs, each side having single-sided layouts.

The switches used are Omron D2LS-21(20M), which are easy to hand-solder. The SMD JST PH connector was chosen for its low profile and ease of hand soldering.

Any switch location can be omitted if desired, and the housing printed with a blank where it would go.

The motherboard is designed to be as narrow as possible, with 4 JST connectors for button cluster daughterboards and one FFC connector for the USB-C breakout board.

It is derived from the Rana Labs Tadpole motherboard but with extremely heavy layout changes.

License

This project is licensed under the CERN Open Hardware License Version 2 - Strongly Reciprocal

This license:

  • Allows use, reproduction, modification, distribution, and sale of the design
  • Requires distribution under the same terms and attribution to the original designer(s)
  • Does not grant trademark rights
  • May be terminated for non-compliance

If you are distributing vboxes or derivatives, you must provide a way for the recipient to access the source files (this repository or your fork if you modify it).

All of these files are posted as-is. This source is distributed WITHOUT ANY EXPRESS OR IMPLIED WARRANTY, INCLUDING OF MERCHANTABILITY, SATISFACTORY QUALITY, AND FITNESS FOR A PARTICULAR PURPOSE.

BOM

PCBs

  • Motherboard (with SMT assembly)
  • QuRB) (with SMT assembly) (USB-C breakout)
  • 2x finger daughterboards (for hand assembly)
  • 2x thumb daughterboards (for hand assembly)

Electrical Parts

  • 20x (or more) Omron D2LS-21(20M) mouse switches
  • 2x S6B-PH-SM4-TB 6-pin right-angle surface-mount JST PH
  • 2x S10B-PH-SM4-TB 10-pin right-angle surface-mount JST PH
  • 2x A06KR06KR26E152A 6-pin 6" JST KR (PH-compatible) cable assembly, reversed
  • 2x A10KR10KR26E102A 10-pin 4" JST KR (PH-compatible) cable assembly, reversed
  • 1x 12-pin 0.5mm pitch ribbon cable, Xmm long

Printed Parts

The housings may be customized to include or omit different button locations. Adjust the python file (which uses Build123D) where it says EDIT THESE TO REMOVE BUTTON HOLES and run the file to generate new STLs.

Print as many keycaps as necessary.

  • Left Finger Cluster Housing
  • Right Finger Cluster Housing
  • Left Thumb Cluster Housing
  • Right Thumb Cluster Housing
  • 17x (or more) Short Keycaps
  • 3x (or more) Tall Keycaps

Housing TBD; there may be a non-folding version and a folding version.

Using the Motherboard with Other Button Clusters

You can use the motherboard with other finger clusters as long as you design them properly. The motherboard JST pinout is listed following, according to standard OpenFrame1 button locations.

Pinout

Left Hand Fingers

  1. GND
  2. Upper Row Index Finger (optional, GPIO 11)
  3. Upper Row Ring Finger (optional, GPIO 23)
  4. Upper Row Pinky Finger (optional, GPIO 25)
  5. L
  6. Analog Stick Left
  7. Analog Stick Down
  8. Analog Stick Right
  9. Upper Row Middle Finger (optional, GPIO 1)
  10. Start

Right Hand Fingers

  1. GND
  2. Right Hand Start (optional, GPIO 29)
  3. R
  4. B
  5. Y
  6. X
  7. Lightshield
  8. Z
  9. Midshield
  10. Analog Stick Up

Left Hand Thumbs

  1. GND
  2. Modifier 5 (optional, GPIO 10) (mirrored location of C-Stick Right)
  3. Modifier 4 (optional, GPIO 9) (mirrored location of C-Stick Up)
  4. Modifier 3 (optional, GPIO 8) (mirrored location of C-Stick Left)
  5. ModY (mirrored location of C-Stick Down)
  6. ModX (mirrored location of A)

Right Hand Thumbs

  1. GND
  2. C-Stick Right
  3. C-Stick Down
  4. A
  5. C-Stick Left
  6. C-Stick Up

Modifications

You may use as many or as few buttons as you would like, but keep in mind that if you are intending this for melee you should at least populate the standard 20 OpenFrame1 buttons.

When the JSTs of the button clusters are mounted on the top side of the outer edges of the PCBs (as in the reference design) or the bottom side of the inner edges of the PCBs, the pinout should be the same as on the motherboard, and you must use "reversed" cable assemblies which map pin 1 to pin 1 and pin N to pin N.

When the JSTs of the button clusters are mounted on the bottom side of the outer edges of the PCBs or the top side of the inner edges of the PCBs, the pinout should be reversed relative to the motherboard (1 to 10 and 10 to 1 for the fingers, and 1 to 6 and 6 to 1 for the thumb clusters) and you must use "non-reversed" (they simply omit the word reversed) cable assemblies that connect pin 1 to pin N. The correct cable assemblies are listed below:

  • 2x A06KR06KR26E152B 6-pin 6" JST KR (PH-compatible) cable assembly, non-reversed
  • 2x A10KR10KR26E102B 10-pin 4" JST KR (PH-compatible) cable assembly, non-reversed

Parts

3
QtyValueFootprintReferences
2~Framework:One Key ModuleSW1, SW2
1Conn_01x06Connector_JST:JST_PH_S6B-PH-SM4-TB_1x06-1MP_P2.00mm_HorizontalJ1

More from CarVac/vbox

12
  • 2 layers33.1 × 114.3 mmVbox mobo, the printed circuit board in 3D

    Vbox mobo

    CarVac/vbox

    A rectangle controller for Melee with buttons arranged vertically instead of on a flat surface

    74 parts6
  • 2 layers109 × 55 mmVbox fingers, the printed circuit board in 3D

    Vbox fingers

    CarVac/vbox

    A rectangle controller for Melee with buttons arranged vertically instead of on a flat surface

    20 parts6
  • 2 layers67 × 46.5 mmVbox thumbs, the printed circuit board in 3D

    Vbox thumbs

    CarVac/vbox

    A rectangle controller for Melee with buttons arranged vertically instead of on a flat surface

    12 parts6
  • 2 layers89.6 × 56 mmVbox fingers choc2 right, the printed circuit board in 3D

    Vbox fingers choc2 right

    CarVac/vbox

    A rectangle controller for Melee with buttons arranged vertically instead of on a flat surface

    9 parts6
  • 2 layers93.4 × 59.7 mmVbox fingers framework right, the printed circuit board in 3D

    Vbox fingers framework right

    CarVac/vbox

    A rectangle controller for Melee with buttons arranged vertically instead of on a flat surface

    9 parts6
  • 2 layers89.6 × 56 mmVbox fingers mx right, the printed circuit board in 3D

    Vbox fingers mx right

    CarVac/vbox

    A rectangle controller for Melee with buttons arranged vertically instead of on a flat surface

    9 parts6
  • 2 layers112.6 × 56 mmVbox fingers choc2 left, the printed circuit board in 3D

    Vbox fingers choc2 left

    CarVac/vbox

    A rectangle controller for Melee with buttons arranged vertically instead of on a flat surface

    7 parts6
  • 2 layers116.6 × 60.2 mmVbox fingers framework left, the printed circuit board in 3D

    Vbox fingers framework left

    CarVac/vbox

    A rectangle controller for Melee with buttons arranged vertically instead of on a flat surface

    7 parts6
  • 2 layers112.6 × 56 mmVbox fingers mx left, the printed circuit board in 3D

    Vbox fingers mx left

    CarVac/vbox

    A rectangle controller for Melee with buttons arranged vertically instead of on a flat surface

    7 parts6
  • 2 layers70.6 × 47.5 mmVbox thumbs choc2 left, the printed circuit board in 3D

    Vbox thumbs choc2 left

    CarVac/vbox

    A rectangle controller for Melee with buttons arranged vertically instead of on a flat surface

    6 parts6
  • 2 layers73.8 × 52.4 mmVbox thumbs framework right, the printed circuit board in 3D

    Vbox thumbs framework right

    CarVac/vbox

    A rectangle controller for Melee with buttons arranged vertically instead of on a flat surface

    6 parts6
  • 2 layers70.6 × 47.5 mmVbox thumbs mx right, the printed circuit board in 3D

    Vbox thumbs mx right

    CarVac/vbox

    A rectangle controller for Melee with buttons arranged vertically instead of on a flat surface

    6 parts6

Similar boards

  • 2 layers40 × 30 mmBlinky, the printed circuit board in 3D

    Blinky

    earthtojake/text-to-cad

    Design physical products with AI

    3 parts26kMIT
  • 2 layers51.9 × 16 mmPassive2-rpi non standard adapter, the printed circuit board in 3D

    Passive2-rpi non standard adapter

    hzeller/rpi-rgb-led-matrix

    Controlling up to three chains of 64x64, 32x32, 16x32 or similar RGB LED displays using Raspberry Pi GPIO

    3 parts4.4kGPL-2.0
  • 2 layers16.3 × 16.3 mmSensor, the printed circuit board in 3D

    Sensor

    scottbez1/splitflap

    DIY split-flap display

    3 parts4.2k
  • 2 layersSub, the printed circuit board in 3D

    Sub

    atopile/atopile

    Design circuit boards with code! ✨ Get software-like design reuse 🚀, validation, version control and collaboration in hardware; starting with electronics ⚡️

    3 parts4kMIT
  • 2 layers85 × 30 mmDual stomp, the printed circuit board in 3D

    Dual stomp

    torvalds/GuitarPedal

    Linus learns analog circuits

    3 parts2.5kGPL-2.0
  • 2 layers124.5 × 33.7 mm172319-1 connector, the printed circuit board in 3D

    172319-1 connector

    rusefi/rusefi

    rusefi - GPL internal combustion engine control unit

    3 parts1.2k
  • 2 layers10.5 × 83 mmProgrammingAdapter, the printed circuit board in 3D

    ProgrammingAdapter

    stuartpittaway/diyBMSv4

    Version 4 of the diyBMS

    3 parts1.1k
  • 2 layers21.2 × 51.3 mmPico reset, the printed circuit board in 3D

    Pico reset

    hackclub/sprig

    🍃 Learn to code by making games in a JavaScript web-based game editor.

    3 parts1.1kMIT

Questions

How big is the Vbox thumbs framework left PCB?

It measures 70.8 × 32.8 mm and has 2 copper layers, 1.6 mm thick.

What parts does the Vbox thumbs framework left use?

3 parts. 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 Vbox thumbs framework left KiCad files?

From the CarVac/vbox repository on GitHub, at the commit this page was made from: the board is KiCad/thumbs_framework_left/Vbox_thumbs_framework_left.kicad_pcb and its schematic KiCad/fingers/Vbox_fingers.kicad_sch. PCBKit opens the board in the browser, with nothing to install.

Can I use the Vbox thumbs framework left design in my own project?

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