forked from Mirrors/OmniNX
202 lines
8.2 KiB
Markdown
202 lines
8.2 KiB
Markdown
# OmniNX CFW Pack
|
||
|
||
|
||
|
||
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.
|
||
|
||
## Features von OmniNX
|
||
|
||
* **Drei Varianten** – Standard (voll), Light (minimal) und OC (Overclocking + SaltySD)
|
||
* **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
|
||
* **Sicherheit und Patches** – sys-patch, DNS-MitM, USB 3.0 Force
|
||
* **Modulare Struktur** – Build-Skripte und Git LFS für überschaubare Repo-Größe
|
||
* **RAM-Patcher-Packages** – Optionale Speicher-Konfigurationen (Default, RAM Patch, 4GB Kip, etc.)
|
||
|
||
## Varianten
|
||
|
||
| Variante | Beschreibung |
|
||
|----------|---------------|
|
||
| **Standard** | Volles Pack: alle Homebrew-Apps, Overlays, Themes und Packages |
|
||
| **Light** | Minimales Pack: nur Kern-Apps und Overlays (Daybreak, DBI, JKSV, Sphaira, Ultrahand, etc.) |
|
||
| **OC** | Volles Pack plus Overclocking: OC Toolkit, sys-clk EOS, SaltySD-Integration |
|
||
|
||
## Inhalt von OmniNX
|
||
|
||
### **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. Payloads**
|
||
* **[Lockpick RCM](https://github.com/saneki/Lockpick_RCM)** / **Lockpick RCM** – Konsolen-Key-Extraktion
|
||
* **[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)
|
||
|
||
### **3. Homebrew-Apps (Standard / OC; Light hat eine Teilmenge)**
|
||
* **[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](https://git.sr.ht/~thestr4ng3r/chiaki/)** – PlayStation Remote Play
|
||
* **[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/nicoboss/tinwoo)** – Installer
|
||
* **[NXGallery](https://github.com/iUltimateLP/NXGallery)** – Medien-Galerie
|
||
* **[Breeze](https://github.com/tomvita/Breeze-Beta)** – Cheat-Manager
|
||
* **[DNS_mitm Tester](https://github.com/meganukebmp/Switch_90DNS_tester)** – DNS-Test-Tool
|
||
|
||
### **4. Overlays und Packages**
|
||
* **nx-ovlloader** – Overlay-Loader für Tesla-artiges Menü
|
||
* **Ultrahand Reload** – Overlay-System und Packages:
|
||
- **Status Monitor** – Echtzeit-Systemüberwachung
|
||
- **sys-patch Overlay** – Patch-Verwaltung
|
||
- **EdiZon Overlay** – Cheats
|
||
- **sysmodules** – Modul-Verwaltung
|
||
- **DNS-MitM Manager** – DNS-Konfiguration
|
||
- **QuickNTP** – Zeitsynchronisation
|
||
* **RAM Patcher** – Speicher-Konfiguration (Default, RAM Patch, RAM Patch Kip, 4GB Kip)
|
||
* **Memory Kit / Memory Config** – Mesosphere- und Speicher-Optionen
|
||
* **Alchemist** – pchtxt- und Contents-Verwaltung
|
||
* **OmniNX Downloader** – Apps, Overlays, Sysmodules, OS, Updater
|
||
* **OC Toolkit** (OC-Variante) – sys-clk EOS und Overclock-Konfiguration
|
||
|
||
### **5. Konfiguration und Themes**
|
||
* **OmniNX-Theme** – Sphaira-Theme (`/config/sphaira/themes/omninx.ini`) in allen Varianten
|
||
* **Boot-Logos** – Einheitliches CFW-Boot-Logo (`bootlogo_cfw.bmp`)
|
||
* **Hekate** – Vorkonfigurierte Boot-Einträge (CFW-EmuMMC, OFW, Payloads)
|
||
* **Nyx** – Theming und UI (z. B. `themecolor=197`)
|
||
|
||
### **6. Sicherheit und System**
|
||
* **DNS-MitM** – DNS-Weiterleitung und Blocking
|
||
* **sys-patch** – Automatische System-Patches
|
||
* **USB 3.0 Force** – Verbesserte USB-Performance
|
||
* **exosphere.ini** – Optionale Exosphere-Konfiguration pro Variante
|
||
|
||
## Repository-Struktur
|
||
|
||
```
|
||
OmniNX/
|
||
├── staging/ # Gemeinsame Install-Stage-Dateien (Bootloader, Payloads, Nyx, etc.)
|
||
├── standard/ # Standard-Variante (voll)
|
||
├── light/ # Light-Variante (minimal)
|
||
├── oc/ # OC-Variante (Overclocking + SaltySD)
|
||
└── scripts/ # Build-Skripte (build-pack.sh, build-all.sh)
|
||
```
|
||
|
||
## Repository-Setup (Git LFS)
|
||
|
||
Dieses Repository nutzt **Git LFS** für Binärdateien. Ohne LFS wäre das Repo sehr groß und würde mit jedem Update wachsen.
|
||
|
||
### Ersteinrichtung
|
||
|
||
```bash
|
||
# Git LFS installieren (z. B. macOS)
|
||
brew install git-lfs
|
||
|
||
# Im Repo initialisieren
|
||
git lfs install
|
||
```
|
||
|
||
### Klonen
|
||
|
||
```bash
|
||
git clone <repository-url>
|
||
cd OmniNX
|
||
```
|
||
|
||
Falls das Repo bereits ohne LFS geklont wurde:
|
||
|
||
```bash
|
||
git lfs install
|
||
git lfs pull
|
||
```
|
||
|
||
Siehe `.gitattributes` für LFS-Track-Muster. Zu GitHub-Quota und Bandbreiten-Limits siehe Projekt-Docs oder SETUP.md.
|
||
|
||
## Packs bauen
|
||
|
||
### Voraussetzungen
|
||
|
||
- Bash, `zip`, Git LFS
|
||
|
||
### Einzelne Variante bauen
|
||
|
||
```bash
|
||
./scripts/build-pack.sh [standard|light|oc] [version]
|
||
```
|
||
|
||
Beispiel: `./scripts/build-pack.sh standard 1.0.0`
|
||
|
||
### Alle Varianten bauen
|
||
|
||
```bash
|
||
./scripts/build-all.sh [version]
|
||
```
|
||
|
||
Die Skripte kopieren Staging- und Varianten-Inhalt, aktualisieren `manifest.ini` mit der Version und erstellen ZIP-Archive.
|
||
|
||
Die Version steht in `{variant}/config/omninx/manifest.ini`.
|
||
|
||
## Installation
|
||
|
||
1. **SD-Karte vorbereiten** – Als FAT32 formatieren
|
||
2. **Dateien kopieren** – Gewünschtes Varianten-ZIP auf die SD-Root entpacken (oder OmniNX Installer nutzen)
|
||
3. **Booten** – Hekate oder Fusee per RCM laden
|
||
4. **Optional** – Einstellungen in `config/` anpassen (Sphaira, Ultrahand, etc.)
|
||
|
||
## Verwendung
|
||
|
||
### Boot-Optionen (Hekate)
|
||
- **CFW-EmuMMC** – Custom Firmware mit EmuMMC
|
||
- **OFW** – Original-Firmware
|
||
- **TegraExplorer** – Dateisystem-Explorer
|
||
- **Lockpick RCM** – Key-Extraktion
|
||
- **Modchip-Toolboxen** – hwfly, Instinct, PicoFly (variantenabhängig)
|
||
|
||
### Overlay-Menü
|
||
- **L + R + PLUS** – Ultrahand-Reload-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.
|
||
|
||
**[GPL 2.0](https://github.com/Atmosphere-NX/Atmosphere/blob/master/LICENSE):**
|
||
* [Atmosphere](https://github.com/Atmosphere-NX/Atmosphere)
|
||
|
||
## Credits
|
||
|
||
* **Atmosphere Team** – Custom Firmware
|
||
* **CTCaer** – Hekate Bootloader
|
||
* **ppkantorski** – Ultrahand Overlay & sys-clk
|
||
* **ITotalJustice** – Sphaira, DNS_mitm Tester, Modchip-Toolboxen und mehr
|
||
* **WerWolv** – Tesla-Menü & EdiZon
|
||
* **Sthetix** – Lockpick RCM Pro
|
||
* **NiklasCFW** & **Woody-NX** – OmniNX-Pack-Erstellung; Vorgänger NiklasCFW Pack
|
||
|
||
## Support
|
||
|
||
* **Discord:** [NiklasCFW Modding Community](https://discord.gg/niklascfw)
|
||
* **GitHub:** [Woody-NX](https://github.com/Woody-NX) · **[NiklasCFW](https://github.com/Niklas080208)**
|
||
* **Releases:** [OmniNX](https://github.com/Woody-NX/OmniNX/releases)
|
||
|
||
---
|
||
|
||
<div align="center">
|
||
|
||
[](https://github.com/OmniNX/OmniNX/releases)
|
||
[](https://github.com/OmniNX/OmniNX)
|
||
|
||
</div>
|