{"id":18029855,"url":"https://github.com/zeioth/zeioth-zmk","last_synced_at":"2025-04-04T21:14:00.028Z","repository":{"id":85081882,"uuid":"571118431","full_name":"Zeioth/zeioth-zmk","owner":"Zeioth","description":"My wireless keyboard drivers","archived":false,"fork":false,"pushed_at":"2023-10-06T21:33:12.000Z","size":149,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-03-27T13:47:17.207Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"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/Zeioth.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","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},"funding":{"github":"Zeioth","patreon":null,"open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"otechie":null,"lfx_crowdfunding":null,"custom":null}},"created_at":"2022-11-27T08:10:12.000Z","updated_at":"2022-12-20T01:06:38.000Z","dependencies_parsed_at":null,"dependency_job_id":"37a8c3d5-354d-4e65-be0a-a4f7d04670b4","html_url":"https://github.com/Zeioth/zeioth-zmk","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Zeioth%2Fzeioth-zmk","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Zeioth%2Fzeioth-zmk/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Zeioth%2Fzeioth-zmk/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Zeioth%2Fzeioth-zmk/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Zeioth","download_url":"https://codeload.github.com/Zeioth/zeioth-zmk/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247249549,"owners_count":20908212,"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":[],"created_at":"2024-10-30T09:11:47.037Z","updated_at":"2025-04-04T21:14:00.008Z","avatar_url":"https://github.com/Zeioth.png","language":"C","funding_links":["https://github.com/sponsors/Zeioth"],"categories":[],"sub_categories":[],"readme":"# Zeioth zmk-config\n\nMy wireless keyboard firmware.\n\n## How to flash\n\n* Shortcut the pins grd/rst twice in \u003c 500ms to enter flash mode.\n  A blue led will turn on on the board.\n* A new device should have appeared in your computer.\n* Copy your FS2 file into it, and wait until it finishes.\n* Your file browser will close automatically. And the device will be unmounted.\n  This is normal, it means all is ok. You can now try to pair the device with\n  your phone.\n\nNote that FS2 files are currently generated using github actions, so you can\nfind them there.\n\n## Commands to re-flash the bootloader\n\nUnder normal circumstances this should not be necessary, but it can be done by\nentering bootloader mode and running\n\n    pip3 uninstall --user adafruit-nrfutil\n    sudo adafruit-nrfutil --verbose dfu serial --package nice_nano_bootloader-_current_version.zip -p /dev/ttyS0 -b 115200 --singlebank --touch 1200\n\nYou can find the latest version [here](https://nicekeyboards.com/docs/nice-nano/troubleshooting).\n\n## REQUIREMENTS\n\nThis firmware is for spanish. Your system's keyboard distribution must be\nspanish querty. The firmware will convert it in real time to spanish COLEMAK DH layout.\n\n## LAYERS\n\n* **Default**: Colemak-dh layout + spanish ñ + dedicated key for tilde.\n* **Super**: Full integration with I3/SWAY keybinds (default ones, and some extras).\n* **Lower**: Characters + numbers. Because all characters you can achieve with RALT\n         already exist in this layer, we don't have RALT key at all.\n* **Raise**: On the right side, Movement/pagination keys (also mouse keys when\n         implemented). On the left side VIM macros.\n* **Hyper**: Programs\n* **Arrow mode**: A mode that only has arrow keys in different positions.\n                  Comfortable for reading!\n* **Config**: Configures the keyboard. Currently, only has bluetooth profiles\n              and a shortcut to launch this firmware manual (and my vimrc's).\n* **Android**: Android doesn't allow customizing keyboard shortcuts (yet?), so\n               we need this layer to control it.\n\n## Troubleshooting\n\n* **I can't see my bluetooth keyboard from my device**: Well you should.\nZMK makes itselft available all the time without you needing to do anything.\nThat's why as security measurement, a profile cannot be re-paired  until\ncleared (see next point). Make sure your device or receiver support BLE technology.\n* **I can't re-pair the keyboard**: You must make the device forget about the\nkeyboard. And then in the keyboard config layer, you must choose the paired\nlayer and press the CLEAR key. Now you should be able to re-pair both.\n* **After I flash the firmware, if I reconnect the controller to the PC I only\nsee the default files**: Again, this is for security, so no one can modify your\nfirmware once flashed (easily).\n* **My file browser doesn't close automatically after copying the firmware**:\n  Try to copy the file a second time without resetting, it should auto-close\n  this time. Reported to happen in some versions of thunar.\n\n## Docs\n\n* https://docs.nicekeyboards.com/#/nice!nano/troubleshooting\n* https://zmk.dev/docs/user-setup\n\n## Credits\nThis firmware uses the helper [zmk-nodefree-config](https://github.com/urob/zmk-nodefree-config) by urob, to avoid boilerplate.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzeioth%2Fzeioth-zmk","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzeioth%2Fzeioth-zmk","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzeioth%2Fzeioth-zmk/lists"}