🗝️ SkullKey

🌐 EN · FR · DE · ES · IT · PT · NL · PL · RU

Klucz, który otwiera każdy sklep. Graj w swoje biblioteki Epic Games, GOG i Amazon Games bezpośrednio z trybu gry na SteamOS / Bazzite — logowanie, instalacja, uruchamianie. Bez trybu pulpitu.

Funkcje

• 🎮 100% tryb gry — przeglądaj, loguj się, instaluj i graj bez dotykania pulpitu
• 🏪 Cztery sklepy, za darmo — Epic Games (Legendary), GOG (gogdl), Amazon Games (nile) i miHoYo/HoYoverse
• ✨ Sklep miHoYo — Genshin Impact, Honkai: Star Rail, Zenless Zone Zero i Honkai Impact 3rd, instalowane z oficjalnego kanału sophon HoYoverse: równoległe pobieranie chunków (~100 MB/s), aktualizacje pobierające tylko zmienione pliki, wznawianie po restarcie, anty-cheat obsłużony automatycznie (jadeite) dla HI3/HSR
• 🩹 Dodatki miHoYo — aktualizacje delta (tylko różnica, ~4× mniejsze), wybór języka dubbingu, weryfikacja i naprawa integralności oraz automatycznie obsłużony anti-cheat Zenless Zone Zero
• 🏛️ Classics Reborn — 52 natywnych otwartych portów i rekompilacji klasyków (Zelda, Mario 64, Perfect Dark, Diablo, Fallout, Doom, C&C Generals, Morrowind, Sonic Unleashed, Unreal Tournament, Freespace 2, LEGO Island…), instalowanych z oficjalnych wydań każdego projektu, z jasnymi instrukcjami dla twoich oryginalnych plików gry (9 języków)
• ⛏️ Minecraft — Java Edition (przez Prism Launcher, wstępnie skonfigurowany: zaloguj się kontem Microsoft i graj), Bedrock Edition (przez mcpelauncher z Flathub, natywna obsługa pada) oraz modpacki z Modrinth jako skróty Steam za jednym kliknięciem (wyszukiwanie na żywo, przypinanie wersji lub codzienne auto-aktualizacje, automatyczne kopie światów przed każdą zmianą wersji)
• 🎯 Battle.net i Ubisoft Connect (eksperymentalne) — oficjalne klienty Windows działają każdy we wspólnym prefiksie Protona: logujesz się raz, twoje gry pojawiają się w SkullKey, Zainstaluj otwiera klienta na stronie gry (jedno naciśnięcie, by potwierdzić), Graj uruchamia grę bezpośrednio i zamyka klienta po wyjściu
• 👥 Osobna przestrzeń sklepów na konto Steam (multi-konto) — każdy użytkownik Steam na maszynie ma własne loginy i biblioteki Epic/GOG/Amazon; zmiana konta Steam przełącza wszystko automatycznie (istniejące loginy zostają przy koncie aktywnym przy pierwszym użyciu)
• 📦 Automatyczna aktualizacja gier — codzienny przebieg w tle utrzymuje wszystkie zainstalowane gry w aktualnej wersji, w każdym sklepie i dla każdego konta
• 💾 Kopia zapasowa i przywracanie zapisów — zrób kopię postępów gry z jej strony jedną akcją (przez ludusavi, instalowane automatycznie) i przywróć na żądanie — gry Epic, GOG i Amazon, kopie w ~/.local/share/skullkey-saves
• 📺 Media i aplikacje — dodatkowe sekcje TV i wideo, Muzyka, Granie w chmurze oraz Aplikacje i narzędzia (Netflix, Jellyfin, Kodi, Moonlight, Lutris… 34 wybrane aplikacje), automatycznie aktualizowane
• 🖼️ Natywnie wyglądające skróty — zainstalowane gry automatycznie otrzymują oficjalne grafiki Steam (pionowa kapsuła, hero, logo), z gamesdb GOG jako zapasem
• 📚 Kolekcje Steam — zainstalowane gry są grupowane według sklepu („Epic", „GOG", „Amazon") w twojej bibliotece
• ⚙️ Proton zarządzany przez Steam — prefiksy, ustawienia gier i limity FPS działają dokładnie jak w grach Steam
• 🔄 Automatyczne aktualizacje — nowe wersje instalują się cicho w tle (można wyłączyć w Ustawieniach)
• 🌐 9 języków — interfejs automatycznie podąża za językiem konsoli (EN/FR/DE/ES/IT/PT/NL/PL/RU)
• 🕹️ Szybki dostęp — kolorowe karty sklepów w QAM, opcjonalny skrót L3+R3 do otwierania sklepu w dowolnym miejscu
• 🐧 Kompatybilność — aktywnie pracujemy nad wsparciem każdego systemu zdolnego uruchomić Steam w trybie gry / Big Picture (na razie Linux): przenośna detekcja, brak założeń specyficznych dla dystrybucji Notatki dla dystrybucji: docs/OS-NOTES.md.

📸 Zrzuty ekranu

Instalacja

Przez Decky Loader, bez pulpitu:

1. Zainstaluj Decky Loader
2. Włącz tryb dewelopera w ustawieniach ogólnych Decky
3. Ustawienia Decky → Deweloper → Zainstaluj wtyczkę z URL: https://github.com/Necrosiak/SkullKey/releases/latest/download/SkullKey.zip

Albo zbuduj ze źródeł:

pnpm install && pnpm run build
sudo bash install-local.sh

Następnie otwórz wtyczkę i zainstaluj zależności sklepów w Ustawienia → Zależności.

Użytkowanie

1. Otwórz menu szybkiego dostępu (…) → SkullKey
2. Wybierz kartę sklepu (Epic / GOG / Amazon) i zaloguj się
3. Zainstaluj grę — trafi do twojej biblioteki Steam z grafikami, w kolekcji sklepu
4. Graj!

🐛 Issues i pomysły — śmiało!

Bug, coś zgrzyta, dziwne zachowanie na twojej dystrybucji? Masz pomysł? Otwórz issue — każde zgłoszenie bezpośrednio kształtuje to, co powstanie dalej, i żadne zgłoszenie nie jest za małe. Aby pomóc nam szybko to naprawić, podaj jeśli możesz:

• dystrybucję i wersję (Bazzite 42, CachyOS, Ubuntu 24.04…) oraz jak działa Steam (tryb gry / Big Picture / pulpit)
• wersję wtyczki (Ustawienia → O programie) i sklep/kartę, której to dotyczy
• co zrobiłeś, czego oczekiwałeś, co się stało zamiast tego
• logi: ~/homebrew/logs/SkullKey/ (problemy z zależnościami: ensure_deps.log)

Prośby o funkcje i zgłoszenia „działa!” na nietypowych konfiguracjach są równie cenne — mówią nam, co wspierać dalej.

Podziękowania

SkullKey to fork Junk-Store autorstwa Ebena Bruynsa (BSD-3-Clause) — dzięki za solidne fundamenty. Silniki sklepów: Legendary, heroic-gogdl i nile.

Niezależny projekt społeczności, niepowiązany z Junk-Store, Valve, Epic Games, GOG ani Amazon.

Licencja

BSD-3-Clause — zobacz LICENSE.

Informacja o AI

Przy tworzeniu tego projektu korzystano z AI (Claude od Anthropic i Codex od OpenAI) — do inżynierii wstecznej, programowania i dokumentacji. Nie do grafiki ani twórczego pisania. Wszystko, co publikowane, przechodzi przez człowieka, a za wynik odpowiadam ja. Jeśli ci to nie odpowiada, teraz już wiesz.

Wesprzyj rozwój

Jeśli ten projekt jest dla Ciebie przydatny, możesz wesprzeć jego dalszy rozwój na Ko-fi.