Programowalna klawiatura QMK/VIA – czym jest i jak ją skonfigurować krok po kroku

Programowalna klawiatura QMK/VIA to klawiatura, której mikrokontroler działa na otwartym firmware QMK, a jego ustawienia możesz zmieniać graficznie w aplikacji VIA. Każdy klawisz da się przypisać na nowo, dodać warstwy (np. strzałki pod literami), makra i klawisze o podwójnej funkcji — a wszystko zapisuje się w samej klawiaturze, więc działa na każdym komputerze bez sterowników.

Krótko: QMK to „mózg” klawiatury, VIA to wygodny panel do jego ustawiania. Poniżej wyjaśniam, jak te elementy ze sobą współpracują, jak skonfigurować klawiaturę w VIA i w QMK Configuratorze oraz kiedy trzeba sięgnąć po kompilację własnego firmware.

Czym jest klawiatura programowalna i co daje QMK

Zwykła klawiatura ma zaszyty na sztywno układ: wciśnięcie klawisza w danym miejscu matrycy zawsze wysyła ten sam kod. Klawiatura programowalna pozwala to zmienić. Część producentów robi to przez własną aplikację, która musi działać w tle na komputerze. QMK idzie inną drogą: logika jest w firmware, czyli w mikrokontrolerze klawiatury.

QMK (Quantum Mechanical Keyboard) to projekt open source rozwijany na GitHubie, obsługujący popularne mikrokontrolery, m.in. ATmega32U4, układy STM32 i RP2040. To te same rodziny układów, które spotkasz w Arduino (ATmega32U4 w Leonardo i Pro Micro), Raspberry Pi Pico (RP2040) czy w projektach robotyki — np. przy sterowaniu silnikiem bezszczotkowym na STM32. Z poziomu firmware możesz ustawić:

• dowolne przypisanie klawiszy, łącznie z klawiszami multimedialnymi i sterowaniem myszą,
• warstwy — dodatkowe układy aktywowane klawiszem funkcyjnym (QMK obsługuje do 32 warstw),
• Mod-Tap — klawisz, który przy stuknięciu wysyła literę, a przytrzymany działa jak Ctrl lub Shift (tak powstają popularne „home row mods”),
• Tap Dance — różne akcje dla pojedynczego, podwójnego i potrójnego stuknięcia,
• Combos — akcja po jednoczesnym wciśnięciu dwóch lub więcej klawiszy,
• makra, Leader key, Caps Word, Auto Shift, obsługę enkoderów (pokręteł) i podświetlenia RGB.

Ponieważ ustawienia siedzą w klawiaturze, przenosisz ją na laptop służbowy, Linuksa czy Maca i wszystko działa tak samo. Nie potrzebujesz uprawnień administratora ani instalowania czegokolwiek.

QMK, VIA i Vial — czym się różnią

Te trzy nazwy często pojawiają się razem, ale oznaczają różne rzeczy.

VIA działa tylko wtedy, gdy w klawiaturze jest firmware QMK skompilowany z obsługą VIA. W praktyce większość producentów, którzy reklamują „QMK/VIA” (m.in. Keychron, NuPhy, wiele marek z segmentu custom), wgrywa właśnie taki firmware fabrycznie. Vial jest popularny w zestawach DIY i u osób, które chcą Tap Dance albo Combos bez kompilowania kodu.

Ważne: Klawiatury bezprzewodowe są osobnym przypadkiem. Oficjalne QMK nie ma pełnej obsługi Bluetooth, dlatego producenci klawiatur wireless używają własnych forków QMK, a w świecie DIY popularny jest firmware ZMK. Przed zakupem sprawdź, czy konfiguracja przez VIA działa także w trybie bezprzewodowym, czy tylko po kablu.

Jak skonfigurować klawiaturę w VIA

VIA od wersji 3 działa jako aplikacja webowa. Korzysta z interfejsu WebHID, więc potrzebujesz przeglądarki opartej na Chromium: Chrome, Edge, Opera lub Brave. Firefox i Safari nie obsługują WebHID.

1. Podłącz klawiaturę kablem USB (nawet jeśli jest bezprzewodowa).
2. Otwórz stronę usevia.app.
3. Kliknij Authorize device i wybierz klawiaturę z listy, którą pokaże przeglądarka.
4. Jeśli klawiatura jest w bazie VIA, pojawi się jej układ. W zakładce Configure klikasz klawisz na wizualizacji, a potem wybierasz nową funkcję z dolnego panelu (Basic, Media, Macro, Layers, Special itd.).
5. Warstwy przełączasz numerami nad klawiaturą (domyślnie 0–3). Aby dostać się do warstwy 1, przypisz gdzieś klawisz MO(1) z zakładki Layers — działa tylko przytrzymany.
6. Zmiany zapisują się w klawiaturze natychmiast, nie ma przycisku „Zapisz”.

W tej samej aplikacji znajdziesz zakładkę Key Tester do sprawdzenia, czy wszystkie przełączniki rejestrują wciśnięcia, a w ustawieniach VIA możesz zapisać i wczytać kopię układu jako plik JSON.

Gdy VIA nie widzi klawiatury

• Klawiatury nie ma w bazie VIA. Producent powinien udostępnić plik JSON z definicją. Włącz w ustawieniach VIA opcję Show Design tab, przejdź do zakładki Design i wczytaj plik. Definicja jest pamiętana tylko w tej przeglądarce.
• Firmware bez VIA. Wtedy aplikacja nic nie pokaże, nawet z poprawnym JSON-em. Trzeba wgrać firmware z obsługą VIA od producenta.
• Linux. Przeglądarka potrzebuje uprawnień do urządzenia hidraw. Dodaj regułę udev z identyfikatorem producenta swojej klawiatury (sprawdzisz go poleceniem lsusb), a potem przeładuj reguły i podłącz klawiaturę ponownie.

# zamień 3434 na idVendor swojej klawiatury
echo 'KERNEL=="hidraw*", SUBSYSTEM=="hidraw", ATTRS{idVendor}=="3434", MODE="0660", TAG+="uaccess"' | sudo tee /etc/udev/rules.d/99-via.rules
sudo udevadm control --reload-rules && sudo udevadm trigger

Jeśli nie znasz jeszcze podstaw pracy w terminalu, przyda się zestaw 20 poleceń Linuksa, które warto znać.

QMK Configurator i QMK Toolbox — konfiguracja bez VIA

Jeśli klawiatura ma QMK, ale bez VIA, albo chcesz wgrać zupełnie nowy układ, skorzystaj z oficjalnych narzędzi QMK. Nie musisz niczego kompilować lokalnie.

1. Wejdź na config.qmk.fm i wybierz swój model z listy Keyboard oraz układ fizyczny z listy Layout.
2. Przeciągnij kody klawiszy z dolnej części strony na wizualizację klawiatury. Kolejne warstwy wybierasz po lewej stronie.
3. Kliknij Compile — serwer QMK zbuduje firmware.
4. Pobierz plik firmware (.hex lub .bin, zależnie od mikrokontrolera). Warto też zapisać keymapę jako JSON, żeby móc ją później wczytać i edytować.
5. Zainstaluj QMK Toolbox (Windows lub macOS), otwórz w nim pobrany plik i zaznacz Auto-Flash.
6. Wprowadź klawiaturę w tryb bootloadera — Toolbox wykryje ją i wgra firmware.

Do trybu bootloadera wchodzisz zwykle na jeden z trzech sposobów: przyciskiem reset na płytce PCB (czasem trzeba go zewrzeć pęsetą), przytrzymując klawisz Esc (lewy górny klawisz matrycy) podczas podłączania kabla — to tzw. Bootmagic — albo naciskając klawisz z przypisanym kodem QK_BOOT. Dokładną metodę dla Twojego modelu podaje producent.

Uwaga: Wgrywaj wyłącznie firmware przeznaczony dla Twojego modelu i rewizji płytki. Plik dla innej wersji PCB może sprawić, że część klawiszy przestanie działać. Klawiatura z bootloaderem prawie zawsze da się przywrócić, ale miej pod ręką oryginalny firmware od producenta.

Kompilacja własnego firmware QMK — dla zaawansowanych

Pełnię możliwości QMK (Tap Dance, Combos, Leader key, własny kod w C) dostajesz dopiero przy samodzielnej kompilacji. Kod źródłowy jest w repozytorium qmk/qmk_firmware na GitHubie — jeśli nie korzystałeś wcześniej z tego typu narzędzi, zobacz, czym różni się Git od GitHuba.

Na Windows najprościej zainstalować pakiet QMK MSYS ze strony projektu. Na Linuksie i macOS instalujesz QMK CLI przez pip lub Homebrew, a potem uruchamiasz konfigurację środowiska:

python3 -m pip install --user qmk
qmk setup
# utwórz własną keymapę na bazie domyślnej
qmk new-keymap -kb <nazwa_klawiatury> -km mojaklawiatura
# skompiluj i wgraj (klawiatura musi być w trybie bootloadera)
qmk compile -kb <nazwa_klawiatury> -km mojaklawiatura
qmk flash -kb <nazwa_klawiatury> -km mojaklawiatura

Układ edytujesz w pliku keymap.c, a funkcje włączasz w rules.mk, np. TAP_DANCE_ENABLE = yes albo COMBO_ENABLE = yes. Jeśli chcesz zachować możliwość edycji w VIA, dodaj VIA_ENABLE = yes. Keymapy z obsługą VIA dla wielu klawiatur są utrzymywane w osobnym repozytorium projektu VIA (the-via/qmk_userspace_via), a nie w głównym repozytorium QMK.

Przykład klawisza Mod-Tap w keymap.c: LCTL_T(KC_ESC) wysyła Escape przy stuknięciu i działa jak lewy Ctrl przy przytrzymaniu — świetne zastąpienie mało używanego Caps Locka.

Polskie znaki i inne praktyczne ustawienia

QMK wysyła do komputera kody klawiszy, a nie znaki. To, jaka litera pojawi się na ekranie, zależy od układu klawiatury w systemie. Przy układzie „Polski (programisty)” polskie znaki działają tak jak zawsze: prawy Alt (KC_RALT, czyli AltGr) plus litera. Pilnuj tylko, żeby po przemapowaniu prawy Alt nadal był prawym Altem, a nie lewym — lewy Alt nie da „ą” ani „ś”.

Kilka sprawdzonych pomysłów na warstwy i makra:

• Strzałki i nawigacja pod literami — warstwa 1 aktywowana przytrzymaniem spacji (LT(1, KC_SPC)), na której H/J/K/L lub I/J/K/L działają jak strzałki, a U/O jako Home/End.
• Klawiatura 60% bez kompromisów — klawisze F1–F12 na rzędzie cyfr w warstwie Fn, Delete pod Backspace.
• Makra tekstowe — w VIA w zakładce Macros wpiszesz sekwencję, np. adres e-mail lub często używaną komendę. Pamiętaj, że makro jest zapisane w klawiaturze jawnym tekstem, więc nie wpisuj tam haseł.
• Skróty systemowe — jeden klawisz z kombinacją Win+Shift+S do zrzutów ekranu. Gdzie trafiają potem pliki, opisuję w tekście o tym, gdzie zapisuje się zrzut ekranu.

Jak wybrać klawiaturę z QMK/VIA

Przy zakupie zwróć uwagę na kilka rzeczy, które realnie wpływają na komfort konfiguracji:

1. Oficjalna obsługa VIA lub Vial w specyfikacji producenta — to gwarancja, że zmienisz układ bez kompilowania czegokolwiek.
2. Dostępność firmware i pliku JSON do pobrania na stronie producenta. Przyda się, gdy coś pójdzie nie tak albo VIA nie rozpozna modelu.
3. Hot-swap — gniazda pozwalające wymienić przełączniki bez lutowania. Nie jest wymagany do QMK, ale ułatwia eksperymenty z przełącznikami liniowymi, taktylnymi i klikającymi.
4. Tryb bezprzewodowy — jeśli go potrzebujesz, upewnij się, jak działa konfiguracja (często tylko po kablu) i czy producent publikuje kod swojego forka QMK.
5. Układ — 60%, 65%, 75%, TKL czy pełny. Im mniejsza klawiatura, tym bardziej skorzystasz z warstw.

Programowalność to nie tylko gadżet dla graczy, choć ci też docenią makra i szybkie przełączanie profili — podobnie jak w przypadku myszy, którą opisaliśmy w recenzji Logitech G PRO X2 Superstrike. Najwięcej zyskują osoby, które dużo piszą i programują: dobrze ustawione warstwy pozwalają pracować bez odrywania dłoni od rzędu podstawowego.

Od czego zacząć, jeśli dopiero kupiłeś klawiaturę QMK/VIA

Zacznij od VIA: otwórz usevia.app, zrób kopię domyślnego układu i zmień jedną rzecz — na przykład Caps Lock na Escape lub Ctrl. Po tygodniu dodaj warstwę z nawigacją. Gdy zabraknie Ci funkcji takich jak Tap Dance czy Combos, wtedy sięgnij po Vial albo kompilację własnego firmware w QMK. Taka kolejność pozwala uczyć się stopniowo i w każdej chwili wrócić do ustawień fabrycznych.

Więcej poradników o peryferiach i podzespołach znajdziesz w kategorii Sprzęt.