Kreator uruchomi się automatycznie
Przy pierwszym starcie HackerDeck wykrywa, czy Waydroid i zależności są zainstalowane. Jeśli nie — pojawia się kreator.
pkexec (wymaga hasła administratora).
pkexec.
Wszystkie narzędzia w jednym miejscu
Zaprojektowany z myślą o graczach, programistach i entuzjastach Androida na Linuksie.
Kreator instalacji
Automatyczna instalacja Waydroid, LXC, binder i GAPPS z paskiem postępu i logami w czasie rzeczywistym.
Sklep APK
Wbudowana biblioteka darmowych i open-source aplikacji: F-Droid, VLC, Termux, RetroArch i wiele innych.
Visual Keymapper
Przeciągane kółka mapują klawisze klawiatury na dotknięcia ekranu Waydroid. Prawy klik = usuń.
Mouse Steering (FPS)
Tryb FPS mapuje ruch myszy na swipe w Waydroid — idealne do PUBG, Free Fire, Call of Duty Mobile.
Multi-instancje
Twórz i przełączaj oddzielne środowiska Android (np. Gaming, Praca). Każda instancja to osobny katalog danych.
Dashboard
Szybki podgląd statusu, skróty do najważniejszych akcji, statystyki instancji i mappingów.
Uruchom HackerDeck
Na HackerOS instalacja i usuwanie HackerDeck odbywa się przez menadżer pakietów hacker:
hacker unpack hackerdeck
# Deinstalacja
hacker pack hackerdeck
🔧 Debian trixie / forky — instalacja ręczna kliknij aby rozwinąć
binder-control nie istnieje w Debianie trixie. HackerDeck używa modprobe binder_linux — wymaga kernela ≥ 5.12 z modułem binder.
-
Sprawdź kernel i moduł binder$ uname -r
$ modinfo binder_linux
# Jeśli brak modułu:
$ sudo apt install linux-image-extra-$(uname -r) -
Zainstaluj HackerDeck (plik .deb lub AppImage)$ sudo dpkg -i hackerdeck_4.0.deb
# lub AppImage:
$ chmod +x hackerdeck-4.0.AppImage && ./hackerdeck-4.0.AppImage -
Przy pierwszym uruchomieniu — kreator instalacji HackerDeck automatycznie wykryje brak Waydroid i uruchomi kreator: apt-update → LXC → modprobe binder_linux → repo waydroid → waydroid init GAPPS.
🛠️ Budowanie ze źródeł (Flutter) kliknij aby rozwinąć
Wymagany Flutter SDK ≥ 3.0. Kod źródłowy jest podzielony na pliki w lib/:
main.dart # entry point + bootstrap
home.dart # główna powłoka UI
models.dart # modele danych
theme.dart # motyw aplikacji
setup_wizard.dart # kreator instalacji
store_data.dart # katalog sklepu APK
keymapper_painter.dart # CustomPainter
pages/ # dashboard, apps, store…
$ flutter pub get
$ flutter build linux --release
$ ./build/linux/x64/release/bundle/hackerdeck
| Zależność Flutter | Wersja | Zastosowanie |
|---|---|---|
| process_run | ^1.0.0 | Uruchamianie procesów systemowych |
| file_picker | ^8.0.0 | Wybór pliku .apk |
| path_provider | ^2.1.3 | Katalogi systemowe (tmp, config) |
| window_manager | ^0.4.0 | Zarządzanie oknem desktopowym |
Mapuj klawisze wizualnie
Jak to działa?
Kółka na ekranie reprezentują mapowania klawiszy → dotknięć. Gdy naciśniesz zmapowany klawisz, HackerDeck wysyła waydroid shell input tap X Y do kontenera.
- 🖱️ Przeciągnij — przesuń kółko na właściwą pozycję
- 🖱️ Prawy klik — usuń mapping
- ➕ Przycisk Dodaj — nowe kółko po środku
- 💾 Auto-zapis — każda zmiana zapisuje się do
~/.config/hackerdeck/keymaps.json
[
{
"key": "w",
"type": "tap",
"x": 500,
"y": 300
},
{ "key": "s", "x": 500, "y": 700 },
{ "key": "a", "x": 300, "y": 500 },
{ "key": "d", "x": 700, "y": 500 }
]
Zainstaluj aplikacje jednym klikiem
HackerDeck zawiera wbudowany katalog sprawdzonych, darmowych aplikacji. Możesz też zainstalować dowolny plik .apk z dysku.
F-Droid / Aurora Store
Store Sklepy z aplikacjami Android. Aurora umożliwia pobieranie z Google Play bez konta.
RetroArch / PPSSPP
Emulacja Emulatory gier. RetroArch obsługuje wiele platform, PPSSPP specjalizuje się w PSP.
VLC / Kodi / NewPipe
Media Odtwarzacze multimedialne. NewPipe = YouTube bez reklam i śledzenia.
Termux
Narzędzia Terminal Linuksowy w Androidzie z pełnym menadżerem pakietów apt.
Signal / KeePassDX
Bezpieczeństwo Szyfrowany komunikator i menadżer haseł. Prywatność przede wszystkim.
Obsidian / LibreOffice
Produktywność Notatki Markdown i przeglądarka dokumentów biurowych.
Instalacja własnego APK
Przejdź do zakładki Aplikacje i kliknij „Zainstaluj APK". Wybierz plik .apk z dysku — HackerDeck uruchomi waydroid app install automatycznie.
Pełna lista skrótów
| Skrót | Działanie | Kontekst |
|---|---|---|
| F1 | Włącz / wyłącz tryb Mouse Steering (FPS) | Globalne |
| W A S D | Domyślne mapowania (dot. tap) — konfigurowalnie | Keymapper aktywny |
| PPM na kółku | Usuń mapping w Visual Keymapper | Zakładka Keymapper |
| Drag kółka | Przesuń mapping na nową pozycję | Zakładka Keymapper |
Komendy Waydroid (skróty w Dashboard)
| Akcja | Polecenie |
|---|---|
| Start kontenera | waydroid container start |
| Start sesji | waydroid session start |
| Stop wszystkiego | waydroid session stop |
| Pełny interfejs | waydroid show-full-ui |
| Lista aplikacji | waydroid app list |
| Instalacja APK | waydroid app install plik.apk |
| Uruchom aplikację | waydroid app launch com.package.name |
| Usuń aplikację | waydroid app remove com.package.name |
| Shell Androida | waydroid shell |
| Status | waydroid status |
Gdzie są dane?
~/.config/hackerdeck/
Główny katalog konfiguracyjny HackerDeck. Tworzony automatycznie przy pierwszym uruchomieniu.
instances.json
Lista instancji Waydroid: nazwa i ścieżka katalogu danych każdej instancji.
keymaps.json
Mapowania klawiszy: klawisz, typ (tap), współrzędne X/Y. Edytowalny ręcznie lub przez UI.
Logi (w UI)
Panel logów na dole okna. Przechowuje ostatnie 500 wpisów. Można zwinąć klikając w nagłówek „Logi".
FAQ
❓ Kreator się zatrzymał z błędem — co robić?
Sprawdź logi widoczne w oknie kreatora. Najczęstsze przyczyny: brak połączenia z internetem, brak pkexec (zainstaluj policykit-1) lub brak wsparcia binderu w kernelu. Kliknij „Spróbuj ponownie" po naprawieniu problemu.
❓ Waydroid jest zainstalowany, ale kreator nadal się pojawia
Kreator sprawdza czy w PATH jest dostępne polecenie waydroid i lxc-ls. Upewnij się, że /usr/bin/waydroid istnieje. Możesz kliknąć „Pomiń" w kreatorze, aby przejść bezpośrednio do interfejsu.
❓ Sklep APK nie pobiera pliku
Niektóre aplikacje linkują do stron releases (GitHub, F-Droid) zamiast bezpośrednio do pliku APK. W takim przypadku HackerDeck otworzy stronę w domyślnej przeglądarce. Pobierz APK ręcznie i użyj przycisku „Zainstaluj APK" w zakładce Aplikacje.
❓ Mouse Steering (FPS) działa wolno / kamera skacze
Tryb FPS wysyła komendy przez waydroid shell input swipe — istnieje naturalne opóźnienie zależne od wydajności systemu. Czułość (2.5x) można dostosować edytując wartość w kodzie _onMouseMove. W przyszłej wersji planowany jest slider czułości w UI.
❓ Jak dodać własną instancję Waydroid?
Przejdź do zakładki Instancje, kliknij „Nowa instancja" i wpisz nazwę. HackerDeck utworzy katalog /var/lib/waydroid_<nazwa>. Pamiętaj, że nowa instancja wymaga ręcznej inicjalizacji przez waydroid init (dostępne w zakładce Narzędzia).
❓ Jak wyeksportować/zaimportować keymapę?
Skopiuj plik ~/.config/hackerdeck/keymaps.json. To zwykły plik JSON — możesz go edytować tekstowo lub udostępniać innym graczom tej samej gry.