{"id":26654827,"url":"https://github.com/thenameiswiiwin/keyboard","last_synced_at":"2025-03-25T05:44:34.094Z","repository":{"id":283864556,"uuid":"953131851","full_name":"thenameiswiiwin/keyboard","owner":"thenameiswiiwin","description":"My Lilly58 keyboard QMK firmware configurations.","archived":false,"fork":false,"pushed_at":"2025-03-22T16:50:04.000Z","size":0,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-22T17:35:32.968Z","etag":null,"topics":["c","custom-keymaps","dev-tools","ergonomic-keyboard","keyboard-build","keyboard-firmware","keyboard-layout","keyboard-macros","keyboard-programming","keycaps","mechanical-keyboard","mechanical-switches","productivity","qmk-firmware","split-keyboards"],"latest_commit_sha":null,"homepage":"","language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/thenameiswiiwin.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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":"2025-03-22T16:35:26.000Z","updated_at":"2025-03-22T16:55:30.000Z","dependencies_parsed_at":"2025-03-22T17:35:34.713Z","dependency_job_id":"b28408d6-5a2a-4425-ac56-b23a49745a16","html_url":"https://github.com/thenameiswiiwin/keyboard","commit_stats":null,"previous_names":["thenameiswiiwin/keyboard"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thenameiswiiwin%2Fkeyboard","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thenameiswiiwin%2Fkeyboard/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thenameiswiiwin%2Fkeyboard/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thenameiswiiwin%2Fkeyboard/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/thenameiswiiwin","download_url":"https://codeload.github.com/thenameiswiiwin/keyboard/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245407754,"owners_count":20610232,"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":["c","custom-keymaps","dev-tools","ergonomic-keyboard","keyboard-build","keyboard-firmware","keyboard-layout","keyboard-macros","keyboard-programming","keycaps","mechanical-keyboard","mechanical-switches","productivity","qmk-firmware","split-keyboards"],"created_at":"2025-03-25T05:44:33.626Z","updated_at":"2025-03-25T05:44:34.071Z","avatar_url":"https://github.com/thenameiswiiwin.png","language":"C","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Lily58 Custom Keyboard Configuration\n\n## Overview\n\nThis repository contains my personal QMK firmware configuration for the Lily58 split ergonomic keyboard. The Lily58 is a 58-key split keyboard with a 6×4+4 column-staggered layout, designed for ergonomic typing and programming.\n\n### Features\n\n- **Custom Keymap**: Optimized layout for developers with intuitive access to symbols and navigation\n- **Advanced Tap Dance**: Multi-function keys for increased efficiency without additional layers\n- **OLED Support**: Custom OLED displays showing active layer and typing information\n- **Ergonomic Design**: Split layout minimizes wrist strain during extended typing sessions\n\n## Layout\n\nThe keymap is organized into four layers:\n\n1. **QWERTY**: Base typing layer with standard layout and strategic modifier placement\n2. **LOWER**: Numbers, navigation, and frequently used IDE shortcuts\n3. **RAISE**: Symbols, brackets, and special characters for coding\n4. **ADJUST**: Function keys, media controls, and keyboard settings\n\n### Layer Visualization\n\n**QWERTY Layer**\n\n```\n╭──────┬──────┬──────┬──────┬──────┬──────╮                ╭──────┬──────┬──────┬──────┬──────┬──────╮\n│      │      │      │      │      │      │                │      │      │      │      │      │      │\n├──────┼──────┼──────┼──────┼──────┼──────┤                ├──────┼──────┼──────┼──────┼──────┼──────┤\n│  TAB │   Q  │   W  │   E  │   R  │   T  │                │   Y  │   U  │   I  │   O  │   P  │   -  │\n├──────┼──────┼──────┼──────┼──────┼──────┤                ├──────┼──────┼──────┼──────┼──────┼──────┤\n│ SHIFT│   A  │   S  │   D  │   F  │   G  │                │   H  │   J  │   K  │   L  │   '  │   ;  │\n├──────┼──────┼──────┼──────┼──────┼──────┼──────╮  ╭──────┼──────┼──────┼──────┼──────┼──────┼──────┤\n│  ALT │   Z  │   X  │   C  │   V  │   B  │      │  │      │   N  │   M  │  TD1 │  TD2 │   /  │ ENTER│\n╰──────┴──────┴──────┼──────┼──────┼──────┼──────┤  ├──────┼──────┼──────┼──────┼──────┴──────┴──────╯\n                     │      │  GUI │LOWER │ SPACE│  │ CTRL │RAISE │ BSPC │      │\n                     ╰──────┴──────┴──────┴──────╯  ╰──────┴──────┴──────┴──────╯\n```\n\n## Special Features\n\n### Tap Dance Keys\n\nThis keymap uses QMK's tap dance feature to enable multi-function keys:\n\n- `TD1`: Single tap = `,` | Double tap = `\u003c`\n- `TD2`: Single tap = `.` | Double tap = `\u003e`\n\n### OLED Configuration\n\nThe OLED displays show:\n\n- Active layer indicator\n- Logo on the master side\n- Key press visualization\n- WPM counter\n\n## Installation\n\n### Prerequisites\n\n- [QMK Firmware](https://qmk.fm/)\n- [QMK MSYS](https://msys.qmk.fm/) (Windows) or QMK environment (macOS/Linux)\n\n### Steps\n\n1. Clone the QMK firmware repository:\n\n   ```bash\n   git clone https://github.com/qmk/qmk_firmware.git\n   cd qmk_firmware\n   ```\n\n2. Copy the custom files to your QMK directory:\n\n   ```bash\n   # Create your keymap directory if it doesn't exist\n   mkdir -p keyboards/lily58/keymaps/thenameiswiiwin\n\n   # Copy files from this repository\n   cp -r path/to/this/repo/keymaps/thenameiswiiwin/* keyboards/lily58/keymaps/thenameiswiiwin/\n   ```\n\n3. Compile the firmware:\n\n   ```bash\n   qmk compile -kb lily58 -km thenameiswiiwin\n   ```\n\n4. Flash the firmware to your keyboard:\n   ```bash\n   qmk flash -kb lily58 -km thenameiswiiwin\n   ```\n\n## Customization\n\n### Modifying Keymap\n\nEdit the `keymap.c` file to change your key layout. The file is organized by layers, with each layer defined in the `keymaps[][]` array.\n\n### Tap Dance Configuration\n\nModify the `dance.c` file to change or add tap dance definitions.\n\n### OLED Display\n\nCustomize the OLED display by editing the `oled.c` file.\n\n## Build Tips\n\n- Ensure both halves of the keyboard are connected when flashing\n- Reset the keyboard before flashing (press reset button or defined reset key)\n- If you encounter issues with OLED, ensure the OLED drivers are properly enabled in `rules.mk`\n\n## Hardware\n\nThis configuration is designed for the Lily58 Pro with:\n\n- Elite-C or Pro Micro controllers\n- 128x32 OLED displays\n- RGB underglow (optional)\n- Hot-swap sockets for MX-style switches\n\n## Resources\n\n- [Lily58 GitHub Repository](https://github.com/kata0510/Lily58)\n- [QMK Documentation](https://docs.qmk.fm/)\n- [QMK Configurator](https://config.qmk.fm/)\n- [Keyboard Layout Editor](http://www.keyboard-layout-editor.com/)\n\n---\n\n_\"Life is too short for bad keyboards.\"_\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthenameiswiiwin%2Fkeyboard","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fthenameiswiiwin%2Fkeyboard","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthenameiswiiwin%2Fkeyboard/lists"}