forked from zmkfirmware/zmk
-
Notifications
You must be signed in to change notification settings - Fork 35
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
1 parent
75e1c34
commit ed4311a
Showing
1 changed file
with
52 additions
and
8 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,13 +1,57 @@ | ||
# Zephyr™ Mechanical Keyboard (ZMK) Firmware | ||
# ZMK Firmware: Fork of urob's fork | ||
|
||
[![Discord](https://img.shields.io/discord/719497620560543766)](https://zmk.dev/community/discord/invite) | ||
[![Build](https://github.com/zmkfirmware/zmk/workflows/Build/badge.svg)](https://github.com/zmkfirmware/zmk/actions) | ||
[![Contributor Covenant](https://img.shields.io/badge/Contributor%20Covenant-v2.0%20adopted-ff69b4.svg)](CODE_OF_CONDUCT.md) | ||
This is my fork of urob's personal ZMK fork containing various experimental features. ~~It is regularly rebased | ||
onto the latest upstream.~~ | ||
|
||
[ZMK Firmware](https://zmk.dev/) is an open source ([MIT](LICENSE)) keyboard firmware built on the [Zephyr™ Project](https://www.zephyrproject.org/) Real Time Operating System (RTOS). ZMK's goal is to provide a modern, wireless, and powerful firmware free of licensing issues. | ||
I made this fork while we wait for urob to update his. | ||
|
||
Check out the website to learn more: https://zmk.dev/. | ||
This is rebased with zmk/main as of 2024-01-06. | ||
|
||
You can also come join our [ZMK Discord Server](https://zmk.dev/community/discord/invite). | ||
## Included features and PRs... | ||
|
||
To review features, check out the [feature overview](https://zmk.dev/docs/). ZMK is under active development, and new features are listed with the [enhancement label](https://github.com/zmkfirmware/zmk/issues?q=is%3Aissue+is%3Aopen+label%3Aenhancement) in GitHub. Please feel free to add 👍 to the issue description of any requests to upvote the feature. | ||
Below is a list of features currently included in the `main` branch _on top of_ | ||
the official ZMK master branch. | ||
|
||
|
||
> **Attention** | ||
> | ||
> This branch does not include the popular mouse keys PR. | ||
> | ||
> If you do want mouse key support, you can use the [urob/mouse branch](https://github.com/infused-kim/zmk/tree/urob/mouse), but it uses the highly experimental and potentially unstable zephyr 3.5 update. | ||
- ~~**mouse** (PR [#778](https://github.com/zmkfirmware/zmk/pull/778)) - official PR + ftc's update + [update to Zephyr 3.2](https://github.com/urob/zmk/tree/mouse-3.2) + some safeguards + enforce hog device fix~~ | ||
- **swapper** (PR [#1366](https://github.com/zmkfirmware/zmk/pull/1366)) - official PR + fixes needed for Zephyr 3.2 | ||
- **smart-word** (PR [#1451](https://github.com/zmkfirmware/zmk/pull/1451)) - official PR, updated to Zephyr-3.2 | ||
- **fix-key-repeat** - fix [key-repeat rolling issue](https://github.com/zmkfirmware/zmk/issues/1207) | ||
- **on-release-for-tap-preferred** - [on-release option for tap-preferred](https://github.com/celejewski/zmk/commit/d7a8482712d87963e59b74238667346221199293) by Andrzej | ||
- **adv360pro** (PR [#1454](https://github.com/zmkfirmware/zmk/pull/1454)) - offical PR | ||
- **zen-tweaks** - [display & battery improvements](https://github.com/caksoylar/zmk/tree/caksoylar/zen-v1%2Bv2) by Cem Aksoylar | ||
|
||
Thanks to caksoylar for figuring out the changes needed for the swapper PR. | ||
|
||
And of course to urob for his amazing fork. | ||
|
||
## How to use it | ||
|
||
### Github Actions | ||
|
||
In order to use this branch with Github Actions, replace the contents of `west.yml` in | ||
your `zmk-config/config` directory with the following contents: | ||
|
||
``` | ||
manifest: | ||
remotes: | ||
- name: zmkfirmware | ||
url-base: https://github.com/zmkfirmware | ||
- name: urob | ||
url-base: https://github.com/urob | ||
- name: infused-kim | ||
url-base: https://github.com/infused-kim | ||
projects: | ||
- name: zmk | ||
remote: infused-kim | ||
revision: urob/no-mouse | ||
import: app/west.yml | ||
self: | ||
path: config | ||
``` |