Skip to the content
2 layers303.8 × 94.2 mmAryess, the printed circuit board in 3D

Custom mechanical keyboard

Size
303.8 × 94.2 mm
Copper layers
2
Thickness
1.6 mm
Parts
238
Nets
185
Pads
1,179
Tracks, vias
1,600, 221
Pours
839
Routed
Yes
KiCad
KiCad 9.0 (file 20241229)
Created
30 May 2025
Updated
3 Jul 2025

Overview

Aryess is an open-source printed circuit board by pioz, from the pioz/aryess_keyboard repository on GitHub, published under the MIT licence. It is a 2-layer board of 303.8 × 94.2 mm with 238 parts on 185 nets, routed with 1,600 tracks and 221 vias.

It is built around the RP2040 and SK6812MINI-E. Its parts include 134 diodes, 62 switches, 17 capacitors, 6 resistors and 4 connectors. It belongs with the keyboards and input boards and the RP2040 boards of this library.

Main components

2

README

README.md

Aryess Keyboard

Aryess

Aryess is a custom mechanical keyboard designed and built from the ground up by pioz. It features a completely custom PCB and a wide range of modern features for both productivity and aesthetics.

Features

  • RP2040 Pro Micro
  • 65% ANSI layout
  • Rotary encoder (knob)
  • Unified Daughterboard support
  • RGB Matrix LEDs (per-key RGB lighting)
  • Underglow LED strip
  • Configurable physical toggle switch
  • OLED display
  • O-ring gasket mount (Friction fit)
  • PCB compatible with Bakeneko case
  • Built-in Pomodoro Timer
  • Fully open source

Built it yourself

You can build your own Aryess keyboard by following these steps.

Order the PCB and Plate

The PCB and plate production files are ready for you. You only need to upload them to JLCPCB:

  • PCB Production File: pcb/production/aryess_2.zip
  • Plate Production File: plate/production/aryess_plate_2.zip

Go to https://jlcpcb.com/, and upload both files.

When ordering the PCB:

  • Select the PCB Assembly option.
  • JLCPCB will take care of soldering the components for you.
  • Minimum order quantity is 5 units.

You will receive fully assembled PCBs at home.

Order the Case

For the case, upload the file case/Aryess Case.step to a 3D printing service.

I personally used Weerg with these settings:

  • Material: Nylon PA12, MJF
  • The result is a very durable, professional-quality case.

You can use any other 3D printing service if you prefer.

Purchase the Extra Components

You will need some additional components. Here is the full list with purchase links:

ComponentDescriptionPurchase Link
OLED DisplaySSD1306 OLED 128 x 32Buy on Amazon
JST Cables3x JST 4-pin 1mm pitch cables
1x JST 3-pin 1mm pitch cable
Rubber FeetRound 20mm diameter rubber feetBuy on Amazon
Rotary EncoderRotary encorder (EC11 compatible)Buy on Amazon
KnobMetal knob for rotary encoderBuy on Amazon
LED StripAPA102-compatible LED strip, ~27.5cmBuy on Amazon
StabilizersMX compatible keyboard stabilizersBuy on Amazon
Toggle SwitchOn/Off switchBuy on Amazon
Unified DaughterboardUSB-C daughterboardBuy on 42keebs
O-Ring GasketVMQ-50 (Silicone 50 duro), AS568-264Buy on Amazon
Foam SheetFoam for case/PCB dampeningBuy on Amazon

Some items can be found from different sellers depending on your country.

Assembly

Once you have received the PCB, plate, case, and all components, you can start assembling your Aryess keyboard.

Compile the Firmware

sh
qmk compile -kb aryess -km default

This command compiles the firmware for the Aryess keyboard using the default keymap.


Flash the Firmware

To flash the firmware, you must enter boot mode on the PCB.

Entering Boot Mode

  • If no firmware is present, connecting the board via USB will automatically enter boot mode.

  • If firmware is already flashed:

    • Hold the BOOT button located underneath the PCB, then plug in the USB cable. Release the button once connected.
    • Alternatively, if this firmware is already running, press the key combination: FN2 + ENTER.

Flashing

Once in boot mode, your computer should detect a new USB mass storage device named something like RPI-RP2.

Copy the compiled .uf2 file (e.g., aryess_default.uf2) directly into the root of that device. The board will automatically flash and reboot with the new firmware.

Parts

238
QtyValueFootprintReferences
67DDiode_SMD:D_SOD-323D1, D2, D10, D11, D12, D13, D14, D15, D16, D17, D18, D19, D20, D21, D22, D23 +51
67SK6812MINI-EPCM_marbastlib-various:LED_6028RLED1, LED2, LED10, LED11, LED12, LED13, LED14, LED15, LED16, LED17, LED18, LED19, LED20, LED21, LED22, LED23 +51
11100nfCapacitor_SMD:C_0805_2012MetricC1, C2, C3, C4, C5, C6, C7, C8, C9, C10, C11
41ufCapacitor_SMD:C_0805_2012MetricC12, C13, C16, C17
310kResistor_SMD:R_0805_2012MetricR1, R4, R5
3Stabilizer 2uPCM_marbastlib-mx:STAB_MX_2uH1, H2, H3
222pfCapacitor_SMD:C_0805_2012MetricC14, C15
227Resistor_SMD:R_0805_2012MetricR2, R3
1'PCM_marbastlib-mx:SW_MX_HS_CPG151101S11_1uSW42
1,PCM_marbastlib-mx:SW_MX_HS_CPG151101S11_1uSW53
1-PCM_marbastlib-mx:SW_MX_HS_CPG151101S11_1uSW12
1.PCM_marbastlib-mx:SW_MX_HS_CPG151101S11_1uSW54
1/PCM_marbastlib-mx:SW_MX_HS_CPG151101S11_1uSW55
10PCM_marbastlib-mx:SW_MX_HS_CPG151101S11_1uSW11
11PCM_marbastlib-mx:SW_MX_HS_CPG151101S11_1uSW2
11kResistor_SMD:R_0805_2012MetricR6
12PCM_marbastlib-mx:SW_MX_HS_CPG151101S11_1uSW3
13PCM_marbastlib-mx:SW_MX_HS_CPG151101S11_1uSW4
14PCM_marbastlib-mx:SW_MX_HS_CPG151101S11_1uSW5
15PCM_marbastlib-mx:SW_MX_HS_CPG151101S11_1uSW6
16PCM_marbastlib-mx:SW_MX_HS_CPG151101S11_1uSW7
17PCM_marbastlib-mx:SW_MX_HS_CPG151101S11_1uSW8
18PCM_marbastlib-mx:SW_MX_HS_CPG151101S11_1uSW9
19PCM_marbastlib-mx:SW_MX_HS_CPG151101S11_1uSW10
1;PCM_marbastlib-mx:SW_MX_HS_CPG151101S11_1uSW41
1=PCM_marbastlib-mx:SW_MX_HS_CPG151101S11_1uSW13
1APCM_marbastlib-mx:SW_MX_HS_CPG151101S11_1uSW32
1ALTPCM_marbastlib-mx:SW_MX_HS_CPG151101S11_1uSW61
1BPCM_marbastlib-mx:SW_MX_HS_CPG151101S11_1uSW50
1BACKPCM_marbastlib-mx:SW_MX_HS_CPG151101S11_1uSW14
1BOOTButton_Switch_SMD:SW_SPST_TL3342SW69
1CPCM_marbastlib-mx:SW_MX_HS_CPG151101S11_1uSW48
1CAPSPCM_marbastlib-mx:SW_MX_HS_CPG151101S11_1uSW31
1CTRLPCM_marbastlib-mx:SW_MX_HS_CPG151101S11_1uSW59
1CrystalCrystal:Crystal_SMD_3225-4Pin_3.2x2.5mmY1
1DPCM_marbastlib-mx:SW_MX_HS_CPG151101S11_1uSW34
1DOWNPCM_marbastlib-mx:SW_MX_HS_CPG151101S11_1uSW66
1EPCM_marbastlib-mx:SW_MX_HS_CPG151101S11_1uSW19
1ENTERPCM_marbastlib-mx:SW_MX_HS_CPG151101S11_1uSW43
1ESCPCM_marbastlib-mx:SW_MX_HS_CPG151101S11_1uSW1
1FPCM_marbastlib-mx:SW_MX_HS_CPG151101S11_1uSW35
1FN1PCM_marbastlib-mx:SW_MX_HS_CPG151101S11_1uSW64
1FN2PCM_marbastlib-mx:SW_MX_HS_CPG151101S11_1uSW63
1FlashPackage_SON:WSON-8-1EP_8x6mm_P1.27mm_EP3.4x4.3mmU1
1GPCM_marbastlib-mx:SW_MX_HS_CPG151101S11_1uSW36
1HPCM_marbastlib-mx:SW_MX_HS_CPG151101S11_1uSW37
1HOMEPCM_marbastlib-mx:SW_MX_HS_CPG151101S11_1uSW58
1IPCM_marbastlib-mx:SW_MX_HS_CPG151101S11_1uSW24
1JPCM_marbastlib-mx:SW_MX_HS_CPG151101S11_1uSW38
1KPCM_marbastlib-mx:SW_MX_HS_CPG151101S11_1uSW39
1LPCM_marbastlib-mx:SW_MX_HS_CPG151101S11_1uSW40
1LEDsConnector_JST:JST_SH_SM04B-SRSS-TB_1x04-1MP_P1.00mm_HorizontalJ3
1LEFTPCM_marbastlib-mx:SW_MX_HS_CPG151101S11_1uSW65
1LSHIFTPCM_marbastlib-mx:SW_MX_HS_CPG151101S11_1uSW45
1MPCM_marbastlib-mx:SW_MX_HS_CPG151101S11_1uSW52
1NPCM_marbastlib-mx:SW_MX_HS_CPG151101S11_1uSW51
1OPCM_marbastlib-mx:SW_MX_HS_CPG151101S11_1uSW25
1OLEDConnector_JST:JST_SH_SM04B-SRSS-TB_1x04-1MP_P1.00mm_HorizontalJ2
1PPCM_marbastlib-mx:SW_MX_HS_CPG151101S11_1uSW26
1PgDnPCM_marbastlib-mx:SW_MX_HS_CPG151101S11_1uSW44
1PgUpPCM_marbastlib-mx:SW_MX_HS_CPG151101S11_1uSW30
1QPCM_marbastlib-mx:SW_MX_HS_CPG151101S11_1uSW17
1RPCM_marbastlib-mx:SW_MX_HS_CPG151101S11_1uSW20
1RESETButton_Switch_SMD:SW_SPST_TL3342SW68
1RIGHTPCM_marbastlib-mx:SW_MX_HS_CPG151101S11_1uSW67
1ROTARYPCM_marbastlib-various:ROT_Alps_EC11E-SwitchSW15
1RP2040Package_DFN_QFN:QFN-56-1EP_7x7mm_P0.4mm_EP3.2x3.2mmU3
1RSHIFTPCM_marbastlib-mx:SW_MX_HS_CPG151101S11_1uSW56
1SPCM_marbastlib-mx:SW_MX_HS_CPG151101S11_1uSW33
1SPACEPCM_marbastlib-mx:SW_MX_HS_CPG151101S11_1uSW62
1SUPERPCM_marbastlib-mx:SW_MX_HS_CPG151101S11_1uSW60
1Stabilizer 6.25uPCM_marbastlib-mx:STAB_MX_6.25uH4
1SwitchConnector_JST:JST_SH_SM03B-SRSS-TB_1x03-1MP_P1.00mm_HorizontalJ4
1TPCM_marbastlib-mx:SW_MX_HS_CPG151101S11_1uSW21
1TABPCM_marbastlib-mx:SW_MX_HS_CPG151101S11_1uSW16
1UPCM_marbastlib-mx:SW_MX_HS_CPG151101S11_1uSW23
1UDConnector_JST:JST_SH_SM04B-SRSS-TB_1x04-1MP_P1.00mm_HorizontalJ1
1UPPCM_marbastlib-mx:SW_MX_HS_CPG151101S11_1uSW57
1VPCM_marbastlib-mx:SW_MX_HS_CPG151101S11_1uSW49
1V RegPackage_TO_SOT_SMD:SOT-23-5U2

The 231 most common of 238 parts.

Similar boards

  • 4 layers180.8 × 300.3 mmDilemma, the printed circuit board in 3D

    Dilemma

    Bastardkb/Dilemma

    The Dilemma is a vertical stagger low-profile keyboard with mods.

    383 parts590
  • 4 layers48 × 32 mmFlatSat, the printed circuit board in 3D

    FlatSat

    Pwnsat/FlatSat

    Flatsat v1.0 is a hardware based platform for aerospace cybersecurity research

    106 parts575GPL-2.0
  • 2 layers33.8 × 131 mmMicrocontrollerInputModule, the printed circuit board in 3D

    MicrocontrollerInputModule

    FrameworkComputer/InputModules

    Reference designs and documentation for the Input Module system in the Framework Laptop 16

    47 parts245
  • 2 layers232.3 × 84.8 mmQazikat, the printed circuit board in 3D

    Qazikat

    weteor/Qazikat

    qaz-like keyboard with offset space, arrow cluster and ISO-enter

    236 parts88CERN-OHL-P-2.0
  • 2 layers291.8 × 134.6 mmMegaXE keyboard, the printed circuit board in 3D

    MegaXE keyboard

    bleroy/3d-junkyard

    Random 3D models

    359 parts69
  • 4 layers137 × 141 mmPcb panel, the printed circuit board in 3D

    Pcb panel

    0xCB-dev/0xCB-1337

    Mechanical macropad with OLED running QMK

    485 parts61
  • 2 layers84.2 × 100 mmFabpack out v5 8, the printed circuit board in 3D

    Fabpack out v5 8

    yuz207/agentpad13

    agentpad13 — open-source 13-key macropad for agentic work (RP2040, vial-qmk, planar joystick, Raw HID agent-status protocol)

    126 parts41
  • 2 layers151.8 × 78.3 mmMinigeki, the printed circuit board in 3D

    Minigeki

    defvs/minigeki

    A portable implementation of an ONGEKI controller, with all necessary buttons, two macros, RGB LED support, USB-C.

    68 parts22GPL-3.0

Questions

How big is the Aryess PCB?

It measures 303.8 × 94.2 mm and has 2 copper layers, 1.6 mm thick.

What parts does the Aryess use?

238 parts, built around the RP2040 and SK6812MINI-E. 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 Aryess KiCad files?

From the pioz/aryess_keyboard repository on GitHub, at the commit this page was made from: the board is pcb/aryess.kicad_pcb and its schematic pcb/aryess.kicad_sch. PCBKit opens the board in the browser, with nothing to install.

Can I use the Aryess design in my own project?

Its repository publishes it under the MIT licence: you may reuse it on that licence's terms (keep the author's notice, and for a copyleft licence share your changes alike).