{"id":13451387,"url":"https://github.com/mattdibi/redox-keyboard","last_synced_at":"2025-05-15T12:00:30.763Z","repository":{"id":42961775,"uuid":"126579919","full_name":"mattdibi/redox-keyboard","owner":"mattdibi","description":"Ergonomic split mechanical keyboard","archived":false,"fork":false,"pushed_at":"2024-05-05T19:05:49.000Z","size":75157,"stargazers_count":1867,"open_issues_count":29,"forks_count":173,"subscribers_count":41,"default_branch":"master","last_synced_at":"2025-05-13T18:20:06.223Z","etag":null,"topics":["assembly","ergonomic-keyboard","guide","keyboard","mechanical-keyboard","pcb","redox","redox-handwire","redox-keyboard","split-keyboard"],"latest_commit_sha":null,"homepage":null,"language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mattdibi.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-03-24T08:25:47.000Z","updated_at":"2025-05-12T23:53:32.000Z","dependencies_parsed_at":"2024-05-05T20:36:59.452Z","dependency_job_id":null,"html_url":"https://github.com/mattdibi/redox-keyboard","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mattdibi%2Fredox-keyboard","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mattdibi%2Fredox-keyboard/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mattdibi%2Fredox-keyboard/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mattdibi%2Fredox-keyboard/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mattdibi","download_url":"https://codeload.github.com/mattdibi/redox-keyboard/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254337612,"owners_count":22054253,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["assembly","ergonomic-keyboard","guide","keyboard","mechanical-keyboard","pcb","redox","redox-handwire","redox-keyboard","split-keyboard"],"created_at":"2024-07-31T07:00:53.074Z","updated_at":"2025-05-15T12:00:25.707Z","avatar_url":"https://github.com/mattdibi.png","language":null,"funding_links":["https://www.paypal.me/MattiaDalBen"],"categories":["Others","Columnar Staggered Keyboards","Hardware"],"sub_categories":["KiCAD Part Libraries and Tools","Keyboards"],"readme":"\u003cp align=\"center\"\u003e\n\u003cimg src=\"img/redox-logo.png\" alt=\"Redox logo\" width=\"600\"/\u003e\n\u003cimg src=\"img/qmk-badge-dark.png\" alt=\"QMK\" width=\"145\"/\u003e\n\u003c/p\u003e\n\n\u003ch3 align=\"center\"\u003eThe Redox project repository\u003c/h3\u003e\n\n\u003cdiv align=\"center\"\u003e\n\n[![Status](https://img.shields.io/badge/status-active-success.svg)]()\n[![GitHub Issues](https://img.shields.io/github/issues/mattdibi/redox-keyboard.svg)](https://github.com/mattdibi/redox-keyboard/issues)\n[![GitHub Pull Requests](https://img.shields.io/github/issues-pr/mattdibi/redox-keyboard.svg)](https://github.com/mattdibi/redox-keyboard/pulls)\n[![License](https://img.shields.io/badge/license-MIT-blue.svg)](/LICENSE)\n\n\u003c/div\u003e\n\n---\n\nThe Redox project is an open-source, [QMK (Quantum Mechanical Keyboard Firmware)](https://github.com/qmk/qmk_firmware) powered, ergonomic split mechanical keyboard. This repository will be used to share information about the project and instruction on how to use and assemble the Redox keyboard.\n\n\u003cp align=\"center\"\u003e\n\u003cimg src=\"img/redox-1.jpg\" alt=\"Redox\" width=\"600\" style=\"border-radius:3%\"/\u003e\n\u003c/p\u003e\n\n**Designer's bio**: [Mattia Dal Ben (aka u/TiaMaT102)](mailto:matthewdibi@gmail.com) obtained a master's degree in Electrical Engineering with a specialization in Computer Science at the University of Udine. Currently works as a Software Engineer in R\u0026D department for a big IoT and Embedded Computers company. Mechanical keyboard enthusiast and maker, the Redox keyboard is the result of all of his passions.\n\n## Rationale\n\nThe Redox is a keyboard project designed with ergonomics in mind. It uses Cherry MX style mechanical switches laid out in a 7x5 columnar stagger layout with components that can easily be sourced.\n\nThe design was heavily inspired by the [Ergodox keyboard](https://www.ergodox.io/), and its main goal is to reduce the size without sacrificing too many keys, hence the name **Re**duced Ergo**dox**.\n\nAs an Ergodox user I couldn't ignore the few flaws of the original design and in a moment of arrogance I tried to fix them, thus the Redox features:\n- Easier to reach thumb cluster.\n- Additional easy-to-reach rotated 1.25u thumb key.\n- Reduced size.\n- Reduced costs (the Redox uses Arduino Pro Micro instead of the Teensy 2.0).\n- Either half can be plugged in to the PC since each half can act as the master.\n- Either half can work as a standalone keyboard to be used as a macropad/gaming keyboard.\n- RGB backlighting support.\n- 3D-printer friendly case.\n- Wireless [see section below](#wireless-implementations)\n- [VIA](https://caniusevia.com/) compatible (thanks to [Harshit Goel](https://github.com/harshitgoel96))\n- [ZMK firmware](https://zmk.dev/) compatible (thanks to [toddmok](https://github.com/toddmok))\n- [KMK firmware](http://kmkfw.io/) compatible\n\n## Related Projects\n\n- [**Redox handwire**](https://www.thingiverse.com/thing:2704567): The first incarnation of the Redox keyboard. It consists of a 3D-printed case and a handwired matrix.\n  - [Tilted Redox case](https://www.thingiverse.com/thing:2767216): tilted case for the Redox prototype by jschloer.\n    - [Tilted redox case pro micro](https://www.printables.com/model/382413-tilted-redox-case-for-micro-and-usbc): Remix of the tilted case to support pro micro and usb c instead of TRRS. \n\n  - [couscous-kbd](https://gitlab.com/cschalkwijk/couscous-kbd): Redox-inspired parametric OpenSCAD keyboard design.\n  - [Redox tenting kit](https://www.thingiverse.com/make:484843): modified base to support tenting, mini-USB for the interconnect, and a hole for microswitch for reset needed when uploading new firmware by [Lenbok](https://github.com/Lenbok).\n  - [Iris-inspired Redox case](https://github.com/Lenbok/scad-redox-case): a case inspired both by the Redox rev1.0 and the Iris designed with OpenSCAD by [Lenbok](https://github.com/Lenbok).\n  - [Redodactyl keyboard](https://www.reddit.com/r/MechanicalKeyboards/comments/9j5pw5/enter_the_redodactyl_first_build/): handwired 3D printed Dactyl-inspired Redox variant by u/darknao.\n- [**Redox Manuform**](https://www.thingiverse.com/thing:3503380): full rework of the Redox case inspired by the Dactyl Manuform. Designed by [Fosk\\_LL](https://www.thingiverse.com/Fosk_LL/about).\n- [**Redox rev1.0**](https://github.com/mattdibi/redox-keyboard/tree/master/redox): the Redox rev 1.0 is the first commercially available version of the Redox keyboard.\n\t- Rev1.0 PCBs: available at [Falbatech's store](https://falbatech.click/products/REDOX-PCB-Electrical-Boards-Set-of-2-p613836203)\n    - Firmware sources:\n        - [QMK firmware for Redox](https://github.com/mattdibi/qmk_firmware/tree/master/keyboards/redox)\n        - [KMK firmware for Redox](https://github.com/KMKfw/kmk_firmware/tree/master/boards/redox)\n\t- 3D-printable cases:\n        - [3D printable case](https://www.thingiverse.com/thing:2886662), freely available.\n        - [Redox keyboard case (high profile)](https://www.thingiverse.com/thing:3825752), by [Michele Ferri](https://www.thingiverse.com/sako83/about).\n        - [Travel-friendly Redox Keyboard case](https://www.thingiverse.com/thing:3607303), by [Fosk\\_LL](https://www.thingiverse.com/Fosk_LL/about).\n        - [Redox Neodox case](https://github.com/Pastitas/Redox-neodox-Case), by [Pastitas](https://github.com/Pastitas)\n        - [Redox big battery](https://github.com/marco-silvestri/redox-big-battery), by [Marco Silvestri](https://github.com/marco-silvestri).\n\t- Commercially available cases:\n\t\t- [Falbatech's bamboo cases with tilt kit](https://falbatech.click/products/REDOX-Standard-LIFT-Bamboo-Wood-Case-with-oil-finish-p613843480)\n\t\t- [Falbatech's fullhand bamboo cases](https://falbatech.click/products/search?keyword=redox%20fullhand%20bamboo)\n- [**Redox rev1.0W**](https://github.com/mattdibi/redox-keyboard/tree/master/redox-w): the Redox rev 1.0W is the wireless version of the Redox keyboard.\n    - Rev1.0W PCBs: gerbers available in [this repo](https://github.com/mattdibi/redox-keyboard/tree/master/redox-w/rev1.0W).\n    - Falbatech's Rev1.0W Hot-swap PCBs: available at [Falbatech's store](https://falbatech.click/products/REDOX-Wireless-PCB-Electrical-Boards-Set-of-2-receiver-PCB-p613839986) (Incompatible with the 3D-printable cases down below)\n    - Firmware sources:\n        - [QMK firmware for Redox wireless](https://github.com/mattdibi/qmk_firmware/tree/master/keyboards/redox_w)\n        - [Nordic MCUs firmware for Redox wireless](https://github.com/mattdibi/redox-w-firmware)\n\t- 3D-printable cases:\n        - [3D printed case](https://github.com/mattdibi/redox-keyboard/tree/master/redox-w/case), freely available.\n        - [Redox Neodox case](https://github.com/Pastitas/Redox-neodox-Case), by [Pastitas](https://github.com/Pastitas)\n    - Commercially available cases (only compatible with the Falbatech's store PCBs):\n        - [Falbatech's bamboo cases with tilt kit](https://falbatech.click/products/REDOX-Wireless-Standard-LIFT-Bamboo-Wood-Case-with-oil-finish-ver-1-p613842405)\n\t\t- [Falbatech's fullhand bamboo cases](https://falbatech.click/products/search?keyword=redox%20wireless%20bamboo%20fullhand)\n- [**Redox rev2.0WHS**](https://github.com/mattdibi/redox-keyboard/tree/master/redox-w): the Redox rev 2.0WHS is the wireless hot-swappable version of the Redox keyboard.\n    - Rev2.0WHS PCBs: gerber files available [here](https://github.com/mattdibi/redox-keyboard/tree/master/redox-w/rev2.0WHS/pcb)\n    - Firmware sources:\n        - [QMK firmware for Redox wireless](https://github.com/mattdibi/qmk_firmware/tree/master/keyboards/redox_w)\n        - [Nordic MCUs firmware for Redox wireless](https://github.com/mattdibi/redox-w-firmware)\n\t- 3D-printable case:\n        - [3D printed case](https://github.com/mattdibi/redox-keyboard/tree/master/redox-w/rev2.0WHS/case), freely available.\n\n## Wireless Implementations\n\nThe Redox keyboard uses three different wireless implementations, differentiated by firmware:\n - *QMK based*: Leveraging the [Gazel protocol](https://developer.nordicsemi.com/nRF5_SDK/nRF51_SDK_v5.x.x/doc/5.2.0/html/a00140.html). It needs its own PCB and a receiver dongle (see [Redox Wireless](https://github.com/mattdibi/redox-keyboard/tree/master/redox-w) for details) and needs three YJ-14015 MCUs + a Pro Micro compatible controller.\n - *ZMK based*: Leveraging the Bluetooth protocol. It is based on the [Redox wired PCB](https://github.com/mattdibi/redox-keyboard/tree/master/redox) and the [nice!nano](https://nicekeyboards.com/nice-nano/) controller.\n - *KMK based*: Adding [Bluetooth Split](http://kmkfw.io/docs/split_keyboards#bluetooth-split-aka-no-trrs-currently-in-testing) code to `boards/redox/main.py`. Combined with a [compatible](http://kmkfw.io/docs/Officially_Supported_Microcontrollers) wireless controller completes wireless configuration. Would advice adding [Bluetooth keycodes](http://kmkfw.io/docs/keycodes#bluetooth-keys) in keymap; `keyboard.keymap` element in `main.py`.\n\n The notable differences for the three implementations are as follows:\n - _Battery life_: QMK Redox Wireless uses two CR2032 coin cell batteries which last [approximately one year (YMMV)](https://github.com/mattdibi/redox-keyboard/tree/master/redox-w#battery-usage), while the nice!nano support LiPo rechargable batteries (you can choose the capacity you want but expect them to last for a [few weeks on a single charge](https://zmk.dev/power-profiler)).\n - _Flexibility_: The receiver dongle limits the flexibility of QMK Redox Wireless.\n - _Cost_: The 3x YJ-14015 + Pro Micro combo is cheaper than two wireless controllers required for ZMK and wireless KMK.\n - _Range_: Bluetooth implementations, of ZMK and KMK, should be more capable than what can be achieved with the QMK Redox Wireless (At this point in time, I lack the evidence to support these claims though).\n\n## Physical Key Layout\n\n\u003cp align=\"center\"\u003e\n\u003cimg src=\"img/redox-layout.png\" alt=\"Redox layout\" width=\"600\" style=\"border-radius:3%\"/\u003e\n\u003c/p\u003e\n\n### Keycaps\n\n| Size  | Qty |                                     Notes                                    |\n|-------|:---:|:----------------------------------------------------------------------------:|\n| 1.5u  |   6 |                                                                              |\n| 1.25u |  10 | You can get away with 8 if you use two 1u keycaps for the 1.25u rotated keys |\n| 1u    |  54 |                                                                              |\n\n\u003e :information_source: On [pimpmykeyboard.com](https://pimpmykeyboard.com/sa-1976-keyset-two-shot/) site you can find a SA 1976 keyset kit specifically made for the Redox keyboard: the \"Ergo Redox kit (12 keys)\".\n\n## Affiliations\n\nIn partnership with Falbatech you can now use the code \"**mattdibi05**\" on Falbatech's store for a 5% OFF special discount.\n\n## Donations\n\nIf you've read this far and found something useful, please consider donating to help me maintain and further develop this project.\n\n\u003cp align=\"center\"\u003e\n\u003ca href=\"https://www.paypal.me/MattiaDalBen\"\u003e\u003cimg src=\"img/donate-button.png\" alt=\"Donate button\" width=300/\u003e\u003c/a\u003e\n\u003c/p\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmattdibi%2Fredox-keyboard","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmattdibi%2Fredox-keyboard","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmattdibi%2Fredox-keyboard/lists"}