Skip to the content
2 layers67 × 46.5 mmVbox thumbs, the printed circuit board in 3D

Vbox thumbs

CarVac/vbox6

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

Size
67 × 46.5 mm
Copper layers
2
Thickness
1.6 mm
Parts
12
Nets
11
Pads
46
Tracks, vias
45, 20
Pours
2
Routed
Yes
KiCad
KiCad 7 (file 20221018)
Created
23 Oct 2023
Updated
10 Jul 2026

Overview

Vbox thumbs is an open-source printed circuit board by CarVac, from the CarVac/vbox repository on GitHub. It is a 2-layer board of 67 × 46.5 mm with 12 parts on 11 nets, routed with 45 tracks and 20 vias.

Its parts include 10 switches and 2 connectors.

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

12
QtyValueFootprintReferences
5SW_Push_45degButtons:VboxSW1, SW2, SW3, SW4, SW5
5SW_Push_45degButtons:Vbox_1SW6, SW7, SW8, SW9, SW10
2Conn_01x06Connector_JST:JST_PH_S6B-PH-SM4-TB_1x06-1MP_P2.00mm_HorizontalJ1, J2

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 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
  • 2 layers70.8 × 32.8 mmVbox thumbs framework left, the printed circuit board in 3D

    Vbox thumbs framework left

    CarVac/vbox

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

    3 parts6

Similar boards

  • 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
  • 2 layers25.4 × 70.4 mmTpmsniffer, the printed circuit board in 3D

    Tpmsniffer

    stacksmashing/pico-tpmsniffer

    A simple, very experimental TPM sniffer for LPC bus

    12 parts696

Questions

How big is the Vbox thumbs PCB?

It measures 67 × 46.5 mm and has 2 copper layers, 1.6 mm thick.

What parts does the Vbox thumbs use?

12 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 KiCad files?

From the CarVac/vbox repository on GitHub, at the commit this page was made from: the board is KiCad/thumbs/Vbox_thumbs.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 design in my own project?

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