mac-keymap

Repozytorium do synchronizacji mojej konfiguracji klawiatury na macOS:

• Right ⌘ → Option (⌥) -- prawy Command działa jak AltGr (polskie znaki).
• PC‑owe skróty Ctrl -- Ctrl+C/V/Z/A/X/S/F/T/W mapowane na ⌘... w aplikacjach GUI.
• F5 = wycinanie screenshotu -- F5 uruchamia ⇧⌘4.

---

Struktura repo

mac-keymap/
├─ scripts/
│  ├─ 01-rightcmd-as-option.sh
│  └─ 02-install-karabiner-rules.sh
├─ json/
│  ├─ pc-ctrl-shortcuts-except-terminal.json
│  └─ f5-screenshot-selection.json
└─ README.md

---

Co dokładnie robi konfiguracja

1) Right ⌘ → Right ⌥

• realizowane przez hidutil + LaunchAgent
• działa po każdym logowaniu
• wymaga układu klawiatury Polski -- Pro

2) Ctrl jak w Windows (Karabiner‑Elements)

• Ctrl+C/V/X/Z/A/S/F/T/W → ⌘...
• Terminal.app i iTerm2 są wykluczone (Ctrl+C dalej przerywa proces)

3) F5 = screenshot z zaznaczeniem

• F5 = ⇧⌘4

---

Instalacja na nowym Macu

Krok 0 --- klon repo

git clone <URL_REPO> mac-keymap
cd mac-keymap

---

Krok 1 --- Right ⌘ jako Option

chmod +x scripts/01-rightcmd-as-option.sh
./scripts/01-rightcmd-as-option.sh

---

Krok 2 --- Karabiner + reguły

chmod +x scripts/02-install-karabiner-rules.sh
./scripts/02-install-karabiner-rules.sh

Skrypt: - kopiuje JSON do ~/.config/karabiner/assets/complex_modifications - uruchamia Karabiner‑Elements

---

OBOWIĄZKOWE KROKI W GUI (macOS)

macOS wymaga ręcznego zatwierdzenia narzędzi przechwytujących klawiaturę.

1) Uprawnienia prywatności

System Settings → Privacy & Security

Włącz:

• Input Monitoring → Karabiner‑Elements
• Accessibility → Karabiner‑Elements

Na dole strony:

• kliknij Allow dla pqrs.org / Karabiner system extension
• jeśli poprosi → restart macOS

---

2) Włączenie reguł

Otwórz Karabiner‑Elements:

• Complex Modifications → Add rule → Enable:
  • PC‑style Ctrl shortcuts → Command shortcuts (except Terminal)
  • F5 → Screenshot selection

---

Testy

Polskie znaki

• ustaw źródło wejścia: Polski -- Pro
• prawy ⌘ + a → ą

Ctrl+C / Ctrl+V

• testuj w Notatkach/TextEdit/IDE
• w Terminalu NIE działa (celowo)

F5

• F5 → wycinanie obszaru

---

Wyłączanie konfiguracji

Cofnięcie Right ⌘ → ⌥

launchctl unload -w ~/Library/LaunchAgents/local.userkeymapping.plist
hidutil property --set '{"UserKeyMapping":[{}]}'

Wyłączenie reguł Karabinera

• Karabiner‑Elements → Complex Modifications → disable rules
• usuń pliki z: ~/.config/karabiner/assets/complex_modifications

---

Notatki

• Jeśli F5 nie działa, ustaw: System Settings → Keyboard → Use F1, F2, etc. as standard function keys
• albo używaj Fn+F5