Hungarian QWERTZ keyboard layout for macOS – MX Keys HU

Windows-szerű magyar QWERTZ billentyűzetkiosztás macOS-hez. Használható MacBook, MacBook Air és MacBook Pro beépített magyar ISO billentyűzetén, Logitech MX Keys modelleken, valamint hagyományos magyar ISO USB- és Bluetooth-billentyűzeteken.

Azoknak készült, akik Macen felcserélt 0 és í billentyűt, rossz Y/Z sorrendet vagy hiányzó Windows/AltGr különleges karaktereket tapasztalnak.

Windows-style Hungarian QWERTZ keyboard layout for macOS and MacBook. Fixes swapped 0/í keys and provides familiar AltGr symbols such as \, |, [, ], @, { and } through Option.

Mit javít?

• a bal Shift melletti külön ISO billentyű í, Shifttel Í;
• az 1 előtti felső billentyű 0, Shifttel §;
• az Y és Z a magyar Windows-kiosztással azonos QWERTZ sorrendben van;
• az Option (Alt) réteg Windows/AltGr-szerű különleges karaktereket ad;
• a numerikus billentyűzet tizedesjele pont.

Kiosztás

Az alapréteg:

0  1  2  3  4  5  6  7  8  9  ö  ü  ó
   Q  W  E  R  T  Z  U  I  O  P  ő  ú
    A  S  D  F  G  H  J  K  L  é  á  ű
 í   Y  X  C  V  B  N  M  ,  .  -

A két könnyen összekeverhető fizikai billentyű:

Fizikai hely	Alap	Shift
Felső sor, közvetlenül az 1 előtt	0	§
Bal Shift és Y között	í	Í

A legfontosabb PC-s Option/Alt kombinációk:

Kombináció	Karakter
Option + Q	\
Option + W	|
Option + F / G	[ / ]
Option + V	@
Option + B / N	{ / }
Option + M	<
Option + .	>
Option + bal Shift melletti í	<

Telepítés

Egysoros webes telepítés:

curl -fsSL https://raw.githubusercontent.com/gudszent/mx-keys-hu-macos/main/web-install.sh | /bin/zsh

Ez alapértelmezetten rendszerszinten telepít ide:

/Library/Keyboard Layouts/MXKeysHU.bundle

Helyi rendszerszintű telepítéshez a projekt könyvtárában:

./install.sh

Az alapértelmezett rendszerszintű telepítés azért szükséges, mert a Microsoft Teams asztali kliense nem kezeli megbízhatóan a felhasználói ~/Library/Keyboard Layouts/ könyvtárból betöltött egyedi kiosztásokat. A Teams fókuszba kerülésekor visszaválthat a gyári kiosztásra, illetve megakadályozhatja az MX Keys HU kiválasztását. A /Library/Keyboard Layouts/ alá telepített példány működik a Teamsben.

Az installer a macOS beépített sudo és ditto parancsát használja, ezért a rendszer elkérheti az adminisztrátori jelszót. Nem módosít védett rendszerfájlokat.

Felhasználói telepítés – nem ajánlott

./install.sh --user

Webes telepítővel:

curl -fsSL https://raw.githubusercontent.com/gudszent/mx-keys-hu-macos/main/web-install.sh | /bin/zsh -s -- --user

Ez adminisztrátori jogosultság nélkül ide telepít:

~/Library/Keyboard Layouts/MXKeysHU.bundle

Ez a mód nem ajánlott, mert a Microsoft Teams asztali kliensében nem megbízható. A -user kapcsoló visszafelé kompatibilis alias.

A telepítés után jelentkezz ki a macOS-ből, majd jelentkezz vissza, és csak ezután add hozzá az MX Keys HU beviteli forrást.

Hozzáadás:

1. System Settings → Keyboard → Text Input → Edit
2. +
3. Others
4. MX Keys HU

Ha a System Settings már nyitva volt a telepítéskor, zárd be és nyisd meg újra, hogy frissítse a listát.

Kézi telepítéshez másold az MXKeysHU.bundle mappát a /Library/Keyboard Layouts/ könyvtárba.

Frissítés

A telepítő szándékosan nem ír felül meglévő bundle-t. Frissítéshez:

./uninstall.sh
./install.sh

Ezután szükség esetén nyisd meg újra a Text Input beállításait, és add hozzá az MX Keys HU forrást.

A kiosztás technikai neve MXKeysHU, a megjelenített neve MX Keys HU. A layout group értéke 126, numerikus azonosítója -28677.

Támogatott billentyűzetek

A kiosztás magyar ISO fizikai billentyűzethez készült, többek között:

• MacBook, MacBook Air és MacBook Pro beépített magyar billentyűzet;
• Logitech MX Keys, MX Keys Mini és MX Keys S;
• Apple Magic Keyboard magyar ISO változat;
• általános magyar ISO USB- és Bluetooth-billentyűzetek.

Az MX Keys karakterkiosztása Mac és Windows hardvermódban azonos. A mód az alsó sor módosítóbillentyűinek jelentését befolyásolja:

• Mac módban a Mac feliratokat használd;
• Windows módban az Alt felel meg az Option, a Windows billentyű pedig a Command billentyűnek;
• a módosítóbillentyűk eszközönként átállíthatók itt: System Settings → Keyboard → Keyboard Shortcuts → Modifier Keys.

Az Fn sor, az Easy-Switch gombok és az alkalmazásspecifikus funkciók működését a billentyűzet firmware-e, illetve a Logi Options+ kezeli. Ezeket egy macOS .keylayout nem módosítja.

Gyors ellenőrzés

A projekt ellenőrző tesztje:

./tests/verify.sh

Sikeres eredmény:

OK: MXKeysHU technikai név, MX Keys HU megjelenítés, QWERTZ, 0/í és PC-s Option karakterek ellenőrizve.

Telepítés után gyors kézi ellenőrzés:

felső bal:        0  §
bal Shift mellett: í  Í
felső/alsó sor:   z  y
Option+Q/W:       \  |
Option+F/G:       [  ]
Option+V/B/N:     @  {  }

Hibaelhárítás

Nem jelenik meg a listában

• Ellenőrizd, hogy létezik-e: /Library/Keyboard Layouts/MXKeysHU.bundle.
• Zárd be, majd nyisd meg újra a System Settings alkalmazást.
• Jelentkezz ki a macOS-ből, majd jelentkezz vissza.
• Futtasd újra a ./tests/verify.sh ellenőrzést.
• Ne másold az új bundle tartalmát egy régi bundle-be; tiszta frissítéshez használd az uninstall.sh, majd az install.sh scriptet.

Megjelenik, de nem választható

Távolítsd el a korábbi változatot, majd telepítsd tisztán. A működő csomag egyetlen .keylayout fájlt tartalmaz, belső azonosítója -28677, csoportja pedig 126. A teszt ezeket külön ellenőrzi.

Microsoft Teams visszavált másik kiosztásra

Ellenőrizd, hogy az MX Keys HU rendszerszinten van-e telepítve:

/Library/Keyboard Layouts/MXKeysHU.bundle

A felhasználói ~/Library/Keyboard Layouts/ telepítés a Teams asztali kliensében nem megbízható. Távolítsd el a felhasználói példányt az ./uninstall.sh --user paranccsal, majd telepítsd rendszerszinten az ./install.sh paranccsal, és jelentkezz ki, majd vissza.

Fel van cserélve a 0 és az í

Győződj meg róla, hogy az MX Keys HU forrás aktív, nem a macOS beépített Hungarian kiosztása vagy egy korábbi tesztváltozat. A végleges hozzárendelés:

key code 10 → 0 / §
key code 50 → í / Í

Az ikon nem magyar zászló

A bundle saját MXKeysHU.icns magyar zászló ikont tartalmaz. Ellenőrizd, hogy az MXKeysHU.bundle teljes tartalma került-e a Keyboard Layouts könyvtárba.

Eltávolítás

Előbb válts másik beviteli forrásra, majd:

./uninstall.sh

A script alapértelmezetten véglegesen törli a /Library/Keyboard Layouts/MXKeysHU.bundle csomagot. A rendszer kérheti az adminisztrátori jelszót.

Ha inkább a Kukába szeretnéd mozgatni:

./uninstall.sh --trash

A nem ajánlott felhasználói telepítés eltávolítása:

./uninstall.sh --user

Megvalósítás és ellenőrzés

A bundle minden szinten egységes saját technikai nevet használ:

• bundle neve: MXKeysHU;
• belső kiosztásnév: MXKeysHU;
• keyboard group: 126;
• keyboard layout ID: -28677;
• bundle ID: com.apple.keyboardlayout.unicode;
• telepítési útvonal: MXKeysHU.bundle;
• keylayout erőforrás: MXKeysHU.keylayout;
• ikon erőforrás: MXKeysHU.icns.

A karaktertérkép QWERTZ alap-, Shift-, Caps Lock-, Control-, Option és Shift+Option réteget tartalmaz. A részletes ellenőrzési jegyzőkönyv: docs/VALIDATION.md.

Licenc

A projekt az MIT licenc alatt használható.