diff --git a/.pics/hekate.png b/.pics/hekate.png deleted file mode 100644 index 481a420..0000000 Binary files a/.pics/hekate.png and /dev/null differ diff --git a/.pics/preview.gif b/.pics/preview.gif new file mode 100644 index 0000000..2b0e49a Binary files /dev/null and b/.pics/preview.gif differ diff --git a/README.md b/README.md index 76cbfee..c271a64 100644 --- a/README.md +++ b/README.md @@ -6,8 +6,10 @@ OmniNX ist ein vollständiges Custom-Firmware-Setup für die Nintendo Switch, verfügbar in drei Varianten mit Fokus auf Flexibilität und Modularität. +Vollständige Schritt-für-Schritt-Anleitungen (Varianten, Voraussetzungen, emuMMC, Updates): **[NiklasCFW Docs – OmniNX Setup](https://docs.niklascfw.de/switch/omninx/einfuehrung/)** + ## Hekate Vorschau -![](.pics/hekate.png) +![](.pics/preview.gif) ## Features von OmniNX @@ -15,7 +17,7 @@ OmniNX ist ein vollständiges Custom-Firmware-Setup für die Nintendo Switch, ve * **Vollständiges CFW-Setup** – Sofort einsatzbereit mit Atmosphere, Hekate und wichtigen Tools * **Modernes Homebrew-Menü** – Sphaira mit OmniNX-Theme und FTP-/MTP-Unterstützung * **Ultrahand Reload** – Overlay-Menü und Package-System (Alchemist, RAM Patcher, OmniNX Downloader) -* **Vorkonfigurierte Payloads** – Lockpick RCM (Pro), TegraExplorer, Modchip-Toolboxen +* **Vorkonfigurierte Payloads** – u. a. APL (Recovery), Lockpick RCM & Pro, TegraExplorer, **[modchip_toolbox](https://github.com/DefenderOfHyrule/modchip-toolbox)**, OmniNX Installer * **Sicherheit und Patches** – sys-patch, DNS-MitM, USB 3.0 Force * **Modulare Struktur** – Build-Skripte für einfaches Erstellen der Packs * **RAM-Patcher-Packages** – Optionale Speicher-Konfigurationen (Default, RAM Patch, 4GB Kip, etc.) @@ -33,35 +35,33 @@ OmniNX ist ein vollständiges Custom-Firmware-Setup für die Nintendo Switch, ve ### **1. Kern-CFW-Komponenten** 1. **[Atmosphere](https://github.com/Atmosphere-NX/Atmosphere)** – Custom Firmware für Nintendo Switch -2. **[Hekate](https://github.com/CTCaer/hekate)** – Bootloader mit grafischer Oberfläche und Nyx -3. **[sys-patch](https://github.com/impeeza/sys-patch)** – System-Patches für unsigned Software -4. **[Ultrahand Reload](https://github.com/ppkantorski/Ultrahand-Overlay)** – Overlay-Menü und Package-System +2. **[Hekate](https://github.com/CTCaer/hekate)** – Bootloader mit grafischer Oberfläche (Nyx) +3. **[sys-patch](https://github.com/borntohonk/sys-patch)** – System-Patches für unsigned Software +4. **[Ultrahand](https://github.com/ppkantorski/Ultrahand-Overlay)** – Overlay-Menü und Package-System ### **2. Payloads** -* **[Lockpick RCM](https://github.com/saneki/Lockpick_RCM)** – Konsolen-Key-Extraktion +* **[AllgemeinerProblemLoeser (APL)](https://git.niklascfw.de/OmniNX/AllgemeinerProblemLoeser)** – Recovery & Problembehebung ohne PC *(Fork von Common Problem Resolver; u. a. Sysmodule/Themes, Archiv-Bit, Mac-Ordner, Mariko-Warmboot/Sleep)* +* **[Lockpick RCM](https://gbatemp.net/download/lockpick_rcm-zoria-decscot.39752/)** – Konsolen-Key-Extraktion +* **[Lockpick RCM Pro](https://github.com/sthetix/Lockpick_RCM_Pro)** – Konsolen-Key-Extraktion *(u. a. PRODINFO-Backup)* * **[TegraExplorer](https://github.com/suchmememanyskill/TegraExplorer)** – Low-Level-Dateimanager -* **[hwfly_toolbox](https://github.com/hwfly-nx/hwfly-toolbox)** – hwfly-Modchip-Toolbox -* **[Instinct_toolbox](https://github.com/Xnopyt/HWFLY-Instinct)** – Instinct-Modchip-Toolbox -* **[PicoFly_Toolbox](https://github.com/Ansem-SoD/Picofly)** – PicoFly-Modchip-Toolbox -* **[OmniNX Installer](https://github.com/OmniNX/OmniNX-Installer-Payload)** – Pack-Installer-Payload (Staging) +* **[modchip_toolbox](https://github.com/DefenderOfHyrule/modchip-toolbox)** – Modchip-Toolbox *(All-in-one für HWFLY & PicoFly)* +* **[OmniNX Installer](https://github.com/OmniNX/OmniNX-Installer-Payload)** – Pack-Installer-Payload (Staging / Updates) -### **3. Homebrew-Apps (Standard / OC; Light hat eine Teilmenge)** +### **3. Homebrew-Apps** -> **Hinweis:** Nicht jede `.nro` liegt direkt im ZIP. Apps wie **Chiaki-ng** oder **Tinwoo** können über den **OmniNX Downloader** nachinstalliert werden (siehe `switch/.packages/OmniNX Downloader/`). +> **Hinweis:** **Light** enthält nur eine **Teilmenge**; Einträge mit **(Standard)** liegen erst ab der **Standard**-Variante im Pack. Übersichtstabelle: **[NiklasCFW Docs](https://docs.niklascfw.de/switch/omninx/einfuehrung/)** * **[Sphaira](https://github.com/ITotalJustice/sphaira)** – Modernes Homebrew-Menü (Standard-Launcher) * **[DBI](https://github.com/rashevskyv/DBI)** – Dateimanager, Save-Manager, Installer * **[Daybreak](https://github.com/Atmosphere-NX/Atmosphere)** – HOS-Update-Tool * **[JKSV](https://github.com/J-D-K/JKSV)** – Save-Manager * **[Linkalho](https://github.com/impeeza/linkalho)** – Account-Verknüpfung -* **[Chiaki-ng](https://github.com/streetpea/chiaki-ng)** – PlayStation Remote Play (typischerweise per OmniNX Downloader) -* **[SimpleModDownloader](https://github.com/PoloNX/SimpleModDownloader)** – Mod-Downloader -* **[SimpleModAlchemist](https://github.com/ppkantorski/Alchemist)** – Mod-Manager -* **[Switch Theme Installer](https://github.com/exelix11/SwitchThemeInjector)** – Theme-Installer -* **[ThemezerNX](https://github.com/suchmememanyskill/themezer-nx)** – Themezer-Client -* **[Tinwoo](https://github.com/mrdude2478/Tinwoo-Release)** – Installer (typischerweise per OmniNX Downloader) -* **[NXGallery](https://github.com/iUltimateLP/NXGallery)** – Medien-Galerie -* **[Breeze](https://github.com/tomvita/Breeze-Beta)** – Cheat-Manager +* **[SimpleModDownloader](https://github.com/PoloNX/SimpleModDownloader)** – Mod-Downloader (Standard) +* **[SimpleModAlchemist](https://github.com/ppkantorski/Alchemist)** – Mod-Manager (Standard) +* **[NXThemesInstaller](https://github.com/exelix11/SwitchThemeInjector)** – Theme-Installer (Standard) +* **[ThemezerNX](https://github.com/suchmememanyskill/themezer-nx)** – Themezer-Client (Standard) +* **[NXGallery](https://github.com/iUltimateLP/NXGallery)** – Medien-Galerie (Standard) +* **[Breeze](https://github.com/tomvita/Breeze-Beta)** – Cheat-Manager (Standard) * **[DNS_mitm Tester](https://github.com/meganukebmp/Switch_90DNS_tester)** – DNS-Test-Tool * **[CyberFoil](https://github.com/luketanti/CyberFoil)** – Installer für NSP, NSZ, XCI, XCZ (Standard) * **[cheats-updater](https://github.com/HamletDuFromage/switch-cheats-updater)** – Cheat-Pakete aktualisieren (Standard) @@ -69,7 +69,7 @@ OmniNX ist ein vollständiges Custom-Firmware-Setup für die Nintendo Switch, ve ### **4. Overlays und Packages** * **nx-ovlloader** – Overlay-Loader für Tesla-artiges Menü * **Ultrahand Reload** – Overlay-System und Packages: - - **[Status Monitor](https://github.com/masagrator/Status-Monitor-Overlay)** – Echtzeit-Systemüberwachung + - **[Status Monitor (HOC)](https://github.com/Horizon-OC/Horizon-OC)** – Echtzeit-Systemüberwachung - **sys-patch Overlay** – Patch-Verwaltung - **EdiZon Overlay** – Cheats - **sysmodules** – Modul-Verwaltung @@ -80,14 +80,14 @@ OmniNX ist ein vollständiges Custom-Firmware-Setup für die Nintendo Switch, ve * **Alchemist** – pchtxt- und Contents-Verwaltung * **OmniNX Downloader** – Apps, Overlays, Sysmodules, OS, Updater * **[sys-ticon](https://github.com/masagrator/sys-ticon)** (Standard; OC-Pack enthält Standard-Inhalt) – Sysmodule für qlaunch: Icons, Titel, Publisher und `display_version` pro Titel-ID (`atmosphere/contents//`, `config.ini`, optional `icon.jpg` / `icon174.jpg`) -* **[Horizon OC](https://github.com/Horizon-OC/Horizon-OC)** (OC-Variante) – Open-Source-Overclocking für Atmosphere (KIP, Overlay, Konfiguration) -* **[FPSLocker](https://github.com/masagrator/FPSLocker)** (OC, Overlay) – FPS-Ziele und Spiel-Patches (mit SaltyNX / NX-FPS) -* **[ReverseNX-RT](https://github.com/masagrator/ReverseNX-RT)** (OC, Overlay) – Docked-/Handheld-Verhalten steuern ### **5. OC: SaltyNX, SaltySD und OmniNX-Tools** Zusätzlich zum **Standard**-Inhalt liefert die **OC**-Variante u. a.: +* **[Horizon OC](https://github.com/Horizon-OC/Horizon-OC)** – Open-Source-Overclocking für Atmosphere (KIP, Overlay, Konfiguration) +* **[FPSLocker](https://github.com/masagrator/FPSLocker)** (Overlay) – FPS-Ziele und Spiel-Patches (mit SaltyNX / NX-FPS) +* **[ReverseNX-RT](https://github.com/masagrator/ReverseNX-RT)** (Overlay) – Docked-/Handheld-Verhalten steuern * **[SaltyNX](https://github.com/masagrator/SaltyNX)** – Sysmodule für Plugins und Laufzeit-Anpassungen (Grundlage u. a. für FPSLocker) * **SaltySD** – SD-Pfad für Patches und Plug-ins (z. B. FPSLocker; im Pack u. a. `SaltySD/exceptions.txt`) * **[PatchExtractor](https://git.niklascfw.de/OmniNX/PatchExtractor)** – entpackt `sd:/SaltySD/plugins/FPSLocker/patches.zip` (Hilfs-Homebrew, siehe Projekt-README) @@ -97,13 +97,14 @@ Zusätzlich zum **Standard**-Inhalt liefert die **OC**-Variante u. a.: ### **6. Konfiguration und Themes** * **OmniNX-Theme** – Sphaira-Theme (`/config/sphaira/themes/omninx.ini`) in allen Varianten * **Boot-Logos** – Einheitliches CFW-Boot-Logo (`bootlogo_cfw.bmp`) +* **HorizonOS-Boot-Logo** – IPS-Patch für das Nintendo-Startlogo (`variants/light/atmosphere/exefs_patches/logo` → auf der SD `atmosphere/exefs_patches/logo`); Erstellung eigener Logos: **[switch-logo-patcher](https://github.com/friedkeenan/switch-logo-patcher)** * **Hekate** – Vorkonfigurierte Boot-Einträge (CFW-EmuMMC, OFW, Payloads) * **Nyx** – Theming und UI (z. B. `themecolor=197`) ### **7. Sicherheit und System** * **DNS-MitM** – DNS-Weiterleitung und Blocking * **sys-patch** – Automatische System-Patches -* **USB 3.0 Force** – Verbesserte USB-Performance +* **USB 3.0 Force** – USB-3.0-Superspeed für Homebrew (u. a. `exosphere.ini`, Hekate, `system_settings.ini`) * **exosphere.ini** – Optionale Exosphere-Konfiguration pro Variante ## Repository-Struktur @@ -144,27 +145,34 @@ Die Version wird aus der Datei `VERSION` gelesen und in `manifest.ini` sowie die ## Installation -1. **SD-Karte vorbereiten** – Als FAT32 formatieren -2. **Dateien kopieren** – Gewünschtes Varianten-ZIP auf die SD-Root entpacken -3. **Installation** – Beim start vom Hekate OmniNX Installer Payload auswählen und Anweisungen befolgen +> **Hinweis:** Ausführlichere Schritt-für-Schritt-Guides (Voraussetzungen, Download, emuMMC, Einrichtung, Updates) lassen sich in den **[NiklasCFW Docs – OmniNX Setup](https://docs.niklascfw.de/switch/omninx/einfuehrung/)** übersichtlicher nachverfolgen als diese Kurzliste. + +1. **SD-Karte vorbereiten** – Als **FAT32** formatieren, falls nötig (neue microSD oder noch kein FAT32). +2. **Dateien kopieren** – **Nur den Inhalt** des gewünschten **Varianten-ZIPs** auf die **microSD-Root** entpacken; wenn der Entpacker zum **Überschreiben** vorhandener Dateien auffordert, bestätigen. **Wechsel von einem anderen Pack** zu OmniNX: die microSD **nicht** leerformatieren – nur die ZIP-Inhalte wie beschrieben aufspielen und Überschreiben zulassen. +3. **Installation** – Beim Start vom Hekate OmniNX Installer Payload auswählen und Anweisungen befolgen ## Verwendung -### Boot-Optionen (Hekate-Launch) +### Hekate: Boot-Einträge und Payloads - **CFW-EmuMMC** – Custom Firmware mit EmuMMC - **OFW** – Original-Firmware -- **TegraExplorer** – Dateisystem-Explorer -- **Lockpick RCM** – Key-Extraktion +- **OmniNX Installer** – Pack-Installation / Staging (siehe Installation) +- **TegraExplorer** – Dateisystem-Explorer (RCM-Payload) +- **Lockpick RCM** / **Lockpick RCM Pro** – Key-Extraktion (Pro: u. a. PRODINFO) +- **AllgemeinerProblemLoeser (APL)** – Recovery ohne PC +- **modchip_toolbox** – HWFLY & PicoFly (siehe Abschnitt 2) -### Overlay-Menü -- **L + R + PLUS** – Ultrahand-Reload-Overlay öffnen +Vollständige Payload-Liste: Abschnitt **„2. Payloads“** oben. + +### Packages und Overlays +- **L + R + PLUS** – Ultrahand-Overlay öffnen ### Homebrew-Menü - **Album** – Sphaira starten (OmniNX-Theme) ## Lizenz -Die verwendeten Projekte unterliegen ihren jeweiligen Lizenzen. Das OmniNX-Pack selbst steht unter der MIT-Lizenz. +Die verwendeten Projekte unterliegen ihren jeweiligen Lizenzen; maßgeblich sind die Lizenzdateien der jeweiligen Upstream-Repositories. Das OmniNX-Pack selbst steht unter der MIT-Lizenz. **[GPL 2.0](https://github.com/Atmosphere-NX/Atmosphere/blob/master/LICENSE):** * [Atmosphere](https://github.com/Atmosphere-NX/Atmosphere) @@ -173,11 +181,13 @@ Die verwendeten Projekte unterliegen ihren jeweiligen Lizenzen. Das OmniNX-Pack * **Atmosphere Team** – Custom Firmware * **CTCaer** – Hekate Bootloader -* **ppkantorski** – Ultrahand Overlay & sys-clk -* **ITotalJustice** – Sphaira, DNS_mitm Tester, Modchip-Toolboxen und mehr +* **ppkantorski** – Ultrahand Overlay +* **ITotalJustice** – Sphaira, DNS_mitm Tester und mehr +* **DefenderOfHyrule** – [modchip_toolbox](https://github.com/DefenderOfHyrule/modchip-toolbox) * **WerWolv** – Tesla-Menü & EdiZon * **Sthetix** – Lockpick RCM Pro * **MasaGratoR (masagrator)** – [sys-ticon](https://github.com/masagrator/sys-ticon), [SaltyNX](https://github.com/masagrator/SaltyNX), [FPSLocker](https://github.com/masagrator/FPSLocker), [Status Monitor](https://github.com/masagrator/Status-Monitor-Overlay), [ReverseNX-RT](https://github.com/masagrator/ReverseNX-RT) +* **Horizon-OC** – [Horizon OC](https://github.com/Horizon-OC/Horizon-OC) (Overclocking, KIP, OC-Overlay) * **luketanti** – [CyberFoil](https://github.com/luketanti/CyberFoil) * **NiklasCFW** & **Woody-NX** – OmniNX-Pack; [PatchExtractor](https://git.niklascfw.de/OmniNX/PatchExtractor), [swr-ini-tool](https://git.niklascfw.de/OmniNX/swr-ini-tool); Vorgänger NiklasCFW Pack