# josefadamcik/soflekeyboard

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/josefadamcik-soflekeyboard).**

2,475 stars · 342 forks · G-code · NOASSERTION

## Links

- GitHub: https://github.com/josefadamcik/SofleKeyboard
- Homepage: https://josefadamcik.github.io/SofleKeyboard/
- awesome-repositories: https://awesome-repositories.com/repository/josefadamcik-soflekeyboard.md

## Description

This project provides hardware specifications and configuration sets for building programmable split mechanical keyboards and macro pads. It focuses on column-staggered designs that utilize the QMK firmware framework to manage input behaviors and keymaps.

The hardware design emphasizes modularity and customization, featuring hotswap sockets for switch replacement without soldering, rotary encoders for specialized control, and low-profile switch options. Visual feedback is integrated through per-key RGB lighting and I2C-based OLED status displays.

The system covers a broad range of capabilities including matrix-based key scanning, real-time graphical keymap configuration, and the assembly of split-half architectures. Firmware is managed through USB-based bootloader flashing and custom installation processes.

## Tags

### Part of an Awesome List

- [Split Keyboard Hardware](https://awesome-repositories.com/f/awesome-lists/devtools/split-keyboard-hardware.md) — Provides open-source hardware designs and technical specifications for building ergonomic split keyboards.
- [Low Profile Designs](https://awesome-repositories.com/f/awesome-lists/devtools/split-keyboard-hardware/low-profile-designs.md) — Provides hardware specifications for constructing column-staggered split devices using low-profile switches. ([source](https://josefadamcik.github.io/SofleKeyboard/build_guide_choc.html))

### Hardware & IoT

- [Keyboard Firmware](https://awesome-repositories.com/f/hardware-iot/microcontroller-firmware-frameworks/keyboard-firmware.md) — Utilizes the QMK firmware framework to manage key scanning, debouncing, and keymap processing.
- [Hotswap Socket Implementations](https://awesome-repositories.com/f/hardware-iot/hotswap-socket-implementations.md) — Integrates hotswap sockets for solderless switch replacement and customization.
- [I2C Bus Interfaces](https://awesome-repositories.com/f/hardware-iot/i2c-bus-interfaces.md) — Uses I2C bus interfaces to connect OLED status displays and modules to the microcontroller.
- [Keyboard Matrix Scanning](https://awesome-repositories.com/f/hardware-iot/keyboard-matrix-scanning.md) — Implements matrix-based key scanning to detect presses by polling rows and columns of electrical switches.
- [Macro Pad Designs](https://awesome-repositories.com/f/hardware-iot/macro-pad-designs.md) — Provides hardware layouts for compact programmable macro pads featuring rotary encoders and per-key lighting.
- [Rotary Encoders](https://awesome-repositories.com/f/hardware-iot/rotary-encoders.md) — Integrates rotary encoders to provide specialized hardware controls for volume and scrolling. ([source](https://josefadamcik.github.io/SofleKeyboard/build_guide_choc.html))
- [Firmware Flashing](https://awesome-repositories.com/f/hardware-iot/connectivity-iot/hardware-communication/serial-device-communication/firmware-flashing.md) — Implements firmware flashing via USB for transferring compiled binaries to the microcontroller. ([source](https://josefadamcik.github.io/SofleKeyboard/build_guide_pico.html))
- [Graphical Keymap Configurators](https://awesome-repositories.com/f/hardware-iot/graphical-keymap-configurators.md) — Supports real-time modification of key assignments through a graphical application to avoid full firmware reflashes. ([source](https://josefadamcik.github.io/SofleKeyboard/build_guide_choc.html))
- [Peripheral Lighting Controllers](https://awesome-repositories.com/f/hardware-iot/peripheral-lighting-controllers.md) — Provides software interfaces for managing the visual effects and animations of integrated chassis RGB lighting. ([source](https://josefadamcik.github.io/SofleKeyboard/build_guide_rgb.html))
- [USB System Updaters](https://awesome-repositories.com/f/hardware-iot/usb-system-updaters.md) — Enables system software updates via USB-based bootloader flashing.

### User Interface & Experience

- [Rotary Encoder Input](https://awesome-repositories.com/f/user-interface-experience/input-handling/rotary-encoder-input.md) — Implements interrupt-driven firmware logic to translate physical knob rotations into keyboard commands.

### Development Tools & Productivity

- [Real-Time Runtime Updates](https://awesome-repositories.com/f/development-tools-productivity/configuration-updates/real-time-runtime-updates.md) — Allows on-the-fly modification of layout settings via a compatible interface without requiring a system restart. ([source](https://josefadamcik.github.io/SofleKeyboard/build_guide_pico.html))
- [Keyboard](https://awesome-repositories.com/f/development-tools-productivity/firmware-installers/keyboard.md) — Provides support for installing custom firmware to define keymaps and enable hardware features. ([source](https://josefadamcik.github.io/SofleKeyboard/build_guide_choc.html))

### Graphics & Multimedia

- [RGB Color Controllers](https://awesome-repositories.com/f/graphics-multimedia/graphics-engines-rendering/lighting-systems/lighting-control-systems/rgb-color-controllers.md) — Implements systems for managing multi-channel RGB color controllers for per-key lighting effects. ([source](https://josefadamcik.github.io/SofleKeyboard/))

### Operating Systems & Systems Programming

- [Addressable LED Drivers](https://awesome-repositories.com/f/operating-systems-systems-programming/kernel-core-internals/system-programming-primitives/system-programming/hardware-interfaces/led-controllers/addressable-led-drivers.md) — Provides drivers for addressable LEDs to create per-key RGB lighting effects and status indicators.

### System Administration & Monitoring

- [OLED Status Displays](https://awesome-repositories.com/f/system-administration-monitoring/status-monitors/oled-status-displays.md) — Integrates OLED status displays to show real-time information about keyboard layers, battery, and connectivity.