Skip to content

Add AliQ80's Reviung41 keymap with dual Arabic (PC/Mac) layers - #128

Open
precondition wants to merge 1 commit into
mainfrom
add-aliq80-reviung41-arabic-keymap
Open

precondition wants to merge 1 commit into
mainfrom
add-aliq80-reviung41-arabic-keymap

Conversation

@precondition

@precondition precondition commented Sep 20, 2026

Copy link
Copy Markdown
Owner

Summary

Adds a new keymap entry for @AliQ80's zmk-config: a Colemak-DH ZMK keymap for the Reviung41 with home row mods, combos, tap dance, and two dedicated Arabic layers ("Arabic" for the standard PC layout, "Arabic Mac" for macOS's differently-positioned Arabic layout)

About the keymap diagram

The keymap-drawer-generated SVG only shows raw ZMK keycodes (Q, W, E...) for the two Arabic layers, because ZMK never transmits Unicode — it only sends HID keycodes, and the actual Arabic letter depends entirely on which keyboard layout is active on the host OS at the time. I resolved the labels by cross-referencing xkeyboard-config's ara(basic) and ara(mac) symbol tables against the keymap's actual bindings (including the keep-mods semantics of the mod-morphs used in the Mac layer) and overlaid the results directly onto the diagram, replacing the Latin keycode with the resolved Arabic letter wherever a real letter results. The diff against the upstream image touches only <text> contents — no structural/layout changes.

@AliQ80 — could you sanity-check the Arabic labels?

Neither of us who worked on this PR reads Arabic, so I'd really appreciate your eyes on AliQ80.svg before it merges, especially the "Arabic Mac" layer's mod-morph shift-outputs, which required interpreting keep-mods behavior rather than reading it straight off the keymap:

Key (tap → shift) Resolved
E (ث) → Shift+A »
R (ق) → Shift+S «
T (ف) → Shift+E kasra (ـِ)
Y (غ) → Shift+R kasratan (ـٍ)
H (ا) → Shift+N إ
V → Shift+Y د → dammatan (ـٌ)
' → Shift+N ؛ → ر
` → Shift+Z ـ → ظ
] → Shift+X ة → ط
. → Shift+H (.) → آ
, → Shift+C ، → ذ

Also worth confirming: Sft+K and the tap side of Sft+L (slash_qmark) appear to resolve to nothing under macOS's Arabic layout (that shift-level is explicitly set to none) — left as their raw ZMK labels since there's no letter to show, but flagging in case that's not intentional on your end.

🤖 Generated with Claude Code

Colemak-DH base with home row mods, combos, and tap dance on a
one-piece split Reviung41 (ZMK). Includes a plain "Arabic" layer for
the standard PC Arabic layout and a separate "Arabic Mac" layer using
mod-morphs to reclaim letters macOS repositions differently.

The keymap-drawer SVG only shows raw ZMK keycodes for these two
layers (ZMK never transmits Unicode; the OS's active keyboard layout
decides the glyph), so the labels were resolved by cross-referencing
xkeyboard-config's ara(basic)/ara(mac) tables and overlaid onto the
diagram in place, replacing the Latin keycode with the resulting
Arabic letter wherever one exists. Diff against the upstream SVG
touches only <text> contents, no structural/layout changes.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant