NeeleNX Setup

Vorbereitung

Was ist NeeleNX?

Ein fertig eingerichtetes Custom-Firmware-Paket. Karte bespielen, Installer starten, fertig.

NeeleNX erscheint in der Ausbaustufe OC, also mit den Werkzeugen zur Übertaktung an Bord, und ist durchgängig angepasst: eigenes Erscheinungsbild, aktuelle Emulation und ein Updater, der ausschließlich aus eigener Quelle lädt. Enthalten sind Atmosphère als Custom Firmware, Hekate als Bootloader, das Ultrahand-Overlay für Einstellungen im laufenden Betrieb und eine Auswahl an Homebrew, die ohne Nacharbeit funktioniert.

Die Konsole selbst wird nicht verändert. Alles läuft in einem emuMMC — einer Kopie des internen Speichers auf der SD-Karte. Das Original bleibt unangetastet und lässt sich jederzeit normal starten.

Was NeeleNX nicht ist

Kein Weg zu kostenlosen Spielen. Das Pack enthält Emulatoren, freie Homebrew-Spiele und Werkzeuge, um eigene Module auszulesen. Spieldateien musst du selbst besitzen.

Voraussetzungen

Nicht jede Switch lässt sich ohne Weiteres öffnen. Der Unterschied liegt im Alter der Konsole.

Ob deine Konsole anfällig ist, verrät die Seriennummer auf der Unterseite. Es gibt online Prüfdienste, in die du sie eingeben kannst. Bei „patched" hilft nur ein Modchip — daran führt kein Softwareweg vorbei.

Außerdem nötig

• microSD-Karte, mindestens 64 GB. Empfohlen sind 128 GB oder mehr: allein der emuMMC belegt rund 29 GB, das Pack knapp 3,5 GB.
• Markenkarte. Billige Karten fallen unter Dauerlast schnell aus und nehmen Spielstände mit.
• Kartenleser oder USB-Kabel. Hekate kann die Karte auch per USB am PC bereitstellen.
• Geduld für ein NAND-Backup. Rund 29 GB und eine halbe Stunde — der wichtigste Schritt überhaupt.

SD-Karte vorbereiten

FAT32, nichts anderes.

Die Switch kommt zwar mit exFAT zurecht, aber die Umsetzung gilt als anfällig für Dateisystemschäden — abgebrochene Schreibvorgänge können den gesamten Karteninhalt unlesbar machen. Für Custom Firmware ist FAT32 Pflicht.

Formatieren unter Windows

Karten über 32 GB bietet Windows im Explorer nicht als FAT32 an. Nimm ein Werkzeug wie guiformat oder den Rufus-Formatierer und stelle die Clustergröße auf 32 oder 64 KB. Kleinere Cluster verschenken Geschwindigkeit bei vielen kleinen Dateien.

Payload einspielen

Der Startschuss. Ohne ihn läuft nur die Originalfirmware.

Eine unpatchte Switch besitzt im Chip einen Fehler, über den sich beim Start eigener Code laden lässt. Dafür muss die Konsole in den RCM-Modus, und in diesem Zustand bekommt sie den Hekate-Payload eingespielt.

Mit RCM-Jig und PC

1. Konsole ausschalten

   Vollständig herunterfahren, nicht nur in den Ruhezustand.

2. Jig einsetzen

   Den Jig in die rechte Joy-Con-Schiene stecken. Er überbrückt zwei Kontakte.

3. RCM auslösen

   Lautstärke hoch gedrückt halten und Power drücken. Der Bildschirm bleibt schwarz — das ist richtig so.

4. Payload senden

   Per USB-C an den PC, dann hekate_ctcaer_*.bin einspielen. Unter Windows mit TegraRcmGUI, unter Linux mit fusee-launcher, am Handy mit NXLoader.

Mit Dongle

Ein RCM-Dongle ersetzt den PC. Auf ihm liegt nur Hekate; alles Weitere kommt von der SD-Karte. Beim Aufspielen muss die Datei meist exakt payload.bin heißen — blende dafür in Windows die Dateinamenerweiterungen ein, sonst entsteht unbemerkt payload.bin.bin.

Mit Modchip

Ein verbauter Chip lädt Hekate beim Einschalten von selbst. Kein Jig, kein Kabel, keine Zeitfenster.

Installation

Herunterladen

Das Pack liegt als einzelnes Archiv bereit.

1. Archiv laden

   neelenx.onimai.ch/NeeleNX.zip herunterladen. Versionshinweise stehen im Repository.

2. Entpacken

   Darin liegen atmosphere, bootloader, config, switch sowie einige Dateien fürs Hauptverzeichnis.

3. Auf die Karte kopieren

   Den Inhalt des entpackten Ordners ins Stammverzeichnis der microSD kopieren — nicht den Ordner selbst. Nachfragen zum Ersetzen bestätigen.

4. Sicher auswerfen

   Karte abmelden und zurück in die Switch stecken.

Alternativ per USB

Hekate kann die Karte direkt bereitstellen: Tools → USB Tools → SD Card, dann die Switch per Kabel an den PC. Die Karte erscheint als Laufwerk. Danach sauber auswerfen und in Hekate auf Close.

Installer ausführen

Der Installer verteilt die Dateien und richtet die Konsole ein.

1. Hekate starten

   Per Jig und Payload oder automatisch über den Modchip.

2. Installer aufrufen

   Im Menü NeeleNX Installer antippen, mit A oder Power bestätigen. Bei der Switch Lite funktioniert nur die Power-Taste.

3. Arbeitsspeicher wählen

   4 GB Konsole — das trifft auf jede normale Switch zu. Die 8-GB-Option gilt ausschließlich für Geräte mit hardwareseitigem RAM-Umbau und führt sonst zu Startproblemen.

4. Hekate / Atmosphère wählen

   Standard. Die Pro-Variante lohnt nur bei einem emuMMC auf umgebauter eMMC.

5. Abschließen

   Bei „Erfolgreich" erneut bestätigen. Hekate startet neu und zeigt bereits das rosa Erscheinungsbild.

Was der Installer löscht

Erkennt er eine bestehende NeeleNX-Installation, ersetzt er nur die CFW-Bestandteile. Findet er keine — etwa beim Wechsel von einem anderen Pack — leert er atmosphere, bootloader, config und switch vollständig. Nicht angetastet werden emuMMC, Nintendo und eigene Ordner.

emuMMC erstellen

Die Kopie des internen Speichers, in der die Custom Firmware läuft. Ohne sie greifen alle Änderungen am echten System.

Datei-emuMMC anlegen

1. Hekate öffnen

   Landest du im Launch-Menü, oben rechts auf Close tippen.

2. emuMMC → Create emuMMC

   Dort SD File wählen.

3. Warten

   Hekate legt eine rund 29 GB große Datei an. Das dauert einige Minuten.

4. Prüfen

   Im emuMMC-Panel muss unter emuMMC Info & Selection ein grüner Haken stehen.

5. Starten

   Close, dann Launch → CFW-EmuMMC.

Partitions-emuMMC anlegen

Nur, wenn die Karte ohnehin leer ist. In Hekate Tools → Partition SD Card, den emuMMC-Regler bei V1, V2 und Lite auf 29 Full, bei OLED auf 58 Full. Dann Next Step → Start und mit Power bestätigen. Anschließend emuMMC → Create emuMMC → SD Partition → Part 1.

Ersteinrichtung

Drei Handgriffe nach dem ersten Start.

Uhrzeit stellen

Ultrahand öffnen mit L + R + Plus, mit dem Steuerkreuz nach rechts zu den Overlays, dort QuickNTP und die Zeit abgleichen.

Das ist keine Kosmetik: Ohne richtige Uhrzeit tragen alle geschriebenen Dateien falsche Zeitstempel, Absturzberichte lassen sich nicht mehr in eine Reihenfolge bringen, und Verbindungen mit Zertifikatsprüfung schlagen fehl.

Kacheln für Homebrew anlegen

Über die Album-Taste Sphaira öffnen, die gewünschten Apps mit X markieren und Forwarder installieren wählen. Danach liegen sie zwischen den Spielen auf dem Startbildschirm.

Der Nebeneffekt ist der wichtigere: Über eine Kachel bekommt die App den vollen Arbeitsspeicher statt der wenigen hundert Megabyte, die das Album-Applet abgibt. RetroArch und PPSSPP laufen dadurch spürbar stabiler.

Im Betrieb

Was ist enthalten?

Der vollständige Inhalt, so wie er nach der Installation auf der Karte liegt.

Bedienung

Drei Ebenen: Hekate vor dem Start, Ultrahand im Betrieb, Sphaira für Homebrew.

Hekate — das Startmenü

Ultrahand — Einstellungen im laufenden Betrieb

L + R + Plus öffnet das Overlay über jedem Spiel. Links liegen die Pakete, rechts die Overlays; zwischen beiden wechselst du mit dem Steuerkreuz. Hier stellst du Takt ein, synchronisierst die Uhr, schaltest Hintergrunddienste ab oder prüfst Updates.

Sphaira — das Homebrew-Menü

Die Album-Taste öffnet Sphaira statt der Bildergalerie. Von hier startest du Homebrew, installierst Forwarder und lädst Neues aus dem Katalog nach.

Emulation

Zwei Wege, und einer davon altert besser.

Eigenständige Emulatoren werden für die Switch selten aktualisiert. PPSSPP etwa stammt aus dem September 2024 und verträgt sich mit neuen Firmwares nicht mehr zuverlässig. RetroArch dagegen erscheint täglich neu, und der PPSSPP-Core darin ist entsprechend aktuell.

Deshalb: Läuft eine eigenständige App nicht, probiere denselben Emulator als Core in RetroArch. Alle 137 Cores sind bereits enthalten, der Download-Umweg entfällt.

Woher die Spieldateien kommen

Aus eigenen Modulen. Für Switch-Spiele liest nxdumptool die eingesteckte Karte aus. Für ältere Systeme brauchst du Auslesegeräte an der jeweiligen Konsole — die Switch kann keine DS-Module oder PSP-Discs lesen.

Übertaktung

Mehr Bildrate — und die häufigste Ursache für unerklärliche Abstürze.

NeeleNX bringt Horizon OC mit. Die Werte liegen in config/horizon-oc/config.ini und lassen sich über das HOC Toolkit im Ultrahand-Menü ändern.

Wer Ruhe haben will, lässt den Arbeitsspeicher auf Werkstakt und übertaktet allenfalls die CPU. Der Unterschied in der Bildrate ist kleiner, als die Zahlen vermuten lassen.

Updates

Das Pack meldet sich selbst, wenn eine neue Fassung vorliegt.

Beim Systemstart lädt das Paket NeeleNX Updater die Datei RELEASE.ini von neelenx.onimai.ch und vergleicht die Versionsnummer mit der installierten in config/neelenx/manifest.ini. Gibt es etwas Neueres, erscheint auf der Konsole die Meldung NeeleNX Update verfügbar.

Was der Updater sonst noch kann

Das Paket aktualisiert nicht nur sich selbst. Im Ultrahand-Menü unter NeeleNX Updater liegen fünf weitere Einträge, über die sich einzelne Bestandteile nachladen lassen — ohne das ganze Pack neu zu installieren. Praktisch, wenn nur eine App zickt.

Die Einträge holen jeweils die neueste Veröffentlichung direkt beim Urheber — beim Homebrew-Katalog über switch.cdn.fortheusers.org, sonst über die Release-Schnittstelle von GitHub. Nur das Pack selbst kommt von neelenx.onimai.ch.

Was die Konsole über sich selbst weiß

Zwei kleine Dateien steuern das Verhalten. Wer nachsehen will, warum der Updater etwas anbietet oder eben nicht, findet die Antwort dort.

Atmosphère getrennt aktualisieren

Der AIO Switch Updater pflegt Atmosphère, Hekate, Sigpatches und Cheats unabhängig vom Pack. Nach einem Firmware-Update der Konsole ist das der erste Weg — neue Firmwares brauchen neue Patches.

Update-API

Die technischen Angaben zur Update-Schnittstelle sind angemeldeten Nutzerinnen und Nutzern vorbehalten.

Firmware aktualisieren

Die Systemversion der Konsole ist etwas anderes als das Pack. Beide altern getrennt.

Im Ultrahand-Menü zeigt der Updater beide Zahlen nebeneinander: die installierte Pack-Version und die Firmware deiner Konsole. Weicht deine Firmware von der ab, die im Pack als getestet hinterlegt ist, wird die Zeile hervorgehoben.

Warum man überhaupt aktualisiert

Neue Spiele verlangen oft eine Mindestversion. Umgekehrt bringt jede neue Firmware das Risiko, dass Homebrew nicht mehr läuft, bis Atmosphère und die Patches nachgezogen sind. Wer keinen Grund hat, wartet besser ab.

Der saubere Weg

Firmware ist Nintendos Software. Fertige Firmware-Pakete kursieren zwar im Netz, sind aber unerlaubte Kopien — und man weiß nie, was daran verändert wurde. Es gibt zwei Wege, die ohne fremde Quellen auskommen:

1. Über die Originalfirmware aktualisieren

   In Hekate OFW starten und dort ganz normal über die Systemeinstellungen aktualisieren. Nintendo liefert die Version direkt und kostenlos. Danach hat deine Konsole die neue Firmware — der emuMMC bleibt vorerst auf dem alten Stand.

2. Aus der eigenen Konsole auslesen

   Mit TegraExplorer und dem mitgelieferten Skript FirmwareDump.te oder mit nxdumptool die Firmware aus dem internen Speicher in einen Ordner auf der SD schreiben.

3. In den emuMMC installieren

   Daybreak im Homebrew-Menü öffnen, auf den ausgelesenen Ordner zeigen, Version prüfen, installieren. Nur den emuMMC aktualisieren — nie den internen Speicher.

4. Patches nachziehen

   AIO Switch Updater starten und Atmosphère sowie Sigpatches aktualisieren. Anschließend in config/sys-patch/log.ini prüfen, ob alle Einträge auf „Patched" stehen.

Zurück geht nur begrenzt

Bei jedem Firmware-Update brennt die Konsole physische Sicherungen durch, die Fuses. Die Originalfirmware weigert sich anschließend, ältere Versionen zu starten. Unter Custom Firmware umgeht Atmosphère diese Prüfung, weshalb ein Downgrade im emuMMC möglich bleibt — der interne Speicher sollte davon aber unberührt bleiben.

Sicherheit

NAND-Backup

Der einzige Schritt, den man nicht nachholen kann, wenn er gebraucht wird.

Ein NAND-Backup ist eine vollständige Kopie des internen Speichers. Damit lässt sich eine Konsole aus fast jedem Softwarefehler zurückholen — ohne sie ist ein misslungenes Firmware-Update endgültig.

1. Hekate → Tools → Backup eMMC

   eMMC RAW GPP wählen. Rund 29 GB, etwa 20 bis 40 Minuten.

2. BOOT0 und BOOT1 mitnehmen

   Falls nicht automatisch mitgesichert, separat anlegen. Die beiden Dateien sind winzig und unverzichtbar.

3. Vom Kartenleser wegkopieren

   Auf den PC oder eine externe Platte. Ein Backup, das auf derselben Karte liegt, die es absichern soll, ist keins.

Was geheim bleibt

Einige Dateien identifizieren deine Konsole eindeutig.

Online und Sperrrisiko

Custom Firmware und Nintendos Server vertragen sich nicht.

NeeleNX bringt DNS-MitM mit einer Sperrliste mit, die Nintendos Telemetrie- und Kontrollserver ins Leere laufen lässt. Das reduziert das Risiko, ersetzt aber kein Verhalten mit Verstand.

• Mit der Custom Firmware nicht online gehen, wenn das Konto dir etwas wert ist.
• Für Online-Spiele die OFW starten — dafür ist die Trennung durch den emuMMC da.
• Kein Nintendo-Konto im emuMMC verknüpfen, wenn es dasselbe ist wie in der OFW.
• Eine Sperre trifft die Konsole, nicht nur das Konto, und lässt sich nicht rückgängig machen.

Nachschlagen

Fehlerbehebung

Die Fälle, die in der Praxis am häufigsten auftreten.

Einen Absturzbericht lesen

Die Berichte sind Textdateien. Oben stehen Prozessname und Programm-ID, weiter unten der Aufrufverlauf:

Process Name:  hbloader
Exception:     Data Abort
Fault Address: 0000000000000000

Stack Trace:
  ReturnAddress[00]: (PPSSPPSDL + 0xb9b32c)

Der Name in Klammern verrät das betroffene Programm, die Adresse dahinter die Stelle im Code. Bleibt sie über mehrere Abstürze gleich, ist der Fehler reproduzierbar und liegt in der Software.

Wichtige Pfade

Wo was liegt, wenn die Karte am PC steckt.

Glossar

Begriffe, die in jeder Anleitung vorkommen.

Atmosphère

Die Custom Firmware. Sie legt sich über das Originalsystem und erlaubt eigene Software.

Hekate

Der Bootloader. Er erscheint vor dem System und entscheidet, was gestartet wird.

Payload

Ein kleines Programm, das vor dem Betriebssystem läuft — Hekate selbst ist eins.

RCM

Ein Wartungsmodus des Chips. Nur in ihm lässt sich fremder Code einspielen.

Jig

Ein Stück Plastik oder Draht, das in der Joy-Con-Schiene zwei Kontakte überbrückt und RCM auslöst.

emuMMC

Eine Kopie des internen Speichers auf der SD-Karte. Die Custom Firmware läuft darin, das Original bleibt sauber.

OFW

Originalfirmware — das unveränderte System der Konsole.

Sigpatches

Patches, die die Signaturprüfung aussetzen. Ohne sie startet keine selbst installierte Software.

Homebrew

Selbst geschriebene Software für die Konsole. Endet meist auf .nro.

Forwarder

Eine Kachel auf dem Startbildschirm, die Homebrew direkt startet — mit vollem Arbeitsspeicher.

Overlay

Ein Menü, das sich über das laufende Spiel legt. Bei NeeleNX über L + R + Plus.

Fuses

Physische Sicherungen im Chip, die bei Firmware-Updates durchgebrannt werden. Sie verhindern in der Originalfirmware ein Downgrade.

NAND

Der interne Speicher der Konsole.

Rechtliches

Kurz gesagt: Du nutzt NeeleNX auf eigene Verantwortung.

Haftungsausschluss

NeeleNX wird ohne jede Gewährleistung bereitgestellt, „wie es ist". Ich, der Ersteller und Betreiber von NeeleNX, übernehme — soweit gesetzlich zulässig — keinerlei Haftung für Schäden, die aus dem Herunterladen, der Installation oder der Nutzung entstehen — insbesondere nicht für:

• Beschädigung oder Unbrauchbarkeit der Konsole
• Verlust von Spielständen, Daten oder gekauften Inhalten
• Sperrung von Konsole oder Nintendo-Konto
• Verlust von Garantie- oder Gewährleistungsansprüchen gegenüber dem Hersteller
• mittelbare Schäden, Folgeschäden oder entgangenen Nutzen

Das Verändern der Systemsoftware einer Spielkonsole geschieht ausschließlich auf eigenes Risiko und in eigener Verantwortung des Nutzers. Wer nicht bereit ist, dieses Risiko zu tragen, sollte NeeleNX nicht installieren.

Unberührt bleibt die zwingende gesetzliche Haftung — etwa für Vorsatz und grobe Fahrlässigkeit sowie für Schäden aus der Verletzung des Lebens, des Körpers oder der Gesundheit. Eine darüber hinausgehende Haftung meinerseits ist ausgeschlossen.

Keine Verbindung zu Nintendo

Dieses Projekt steht in keinerlei Verbindung zu Nintendo und wird von Nintendo weder unterstützt noch geprüft oder genehmigt. „Nintendo", „Nintendo Switch" und alle weiteren genannten Marken sind Eigentum ihrer jeweiligen Inhaber und werden hier ausschließlich zur Beschreibung verwendet.

Inhalte und Urheberrecht

NeeleNX enthält keine Spiele, keine Firmware und keine Shops. Mitgeliefert werden ausschließlich freie Software und Homebrew unter den Lizenzen der jeweiligen Urheber sowie Spiele, die von ihren Entwicklern zur freien Weitergabe bestimmt wurden.

Emulatoren sind erlaubte Software. Die dazugehörigen Spieldateien musst du selbst besitzen und aus eigenen Datenträgern auslesen. Das Herunterladen urheberrechtlich geschützter Spiele oder Firmware aus fremden Quellen ist rechtswidrig und wird hier weder unterstützt noch beschrieben.

Fremde Projekte

NeeleNX ist eine Zusammenstellung bestehender Projekte. Die enthaltenen Bestandteile unterliegen den Lizenzen ihrer jeweiligen Urheber — maßgeblich sind die Angaben in den Ursprungs-Repositories, nicht die Zusammenstellung. Eine Übersicht steht unter Credits.

Verweise auf andere Seiten

Für Inhalte verlinkter Seiten sind ausschließlich deren Betreiber verantwortlich. Zum Zeitpunkt der Verlinkung waren keine Rechtsverstöße erkennbar.

Credits

NeeleNX ist eine Zusammenstellung. Die eigentliche Arbeit steckt in diesen Projekten.

• Atmosphère Team — die Custom Firmware
• CTCaer — Hekate und Nyx
• Woody2408 und NiklasCFW — Vorarbeit, auf der dieses Pack aufbaut
• ppkantorski — Ultrahand Overlay und nx-ovlloader
• ITotalJustice — Sphaira
• MasaGratoR — SaltyNX, FPSLocker, sys-ticon, Status Monitor, ReverseNX-RT
• Horizon-OC — Übertaktung und Overlay
• WerWolv — Tesla-Menü und EdiZon
• DarkMatterCore — nxdumptool
• J-D-K — JKSV · XorTroll — Goldleaf · impeeza — Linkalho
• HamletDuFromage — AIO Switch Updater
• libretro — RetroArch und die Cores
• Pixel — Cave Story · sergiou87 — OpenSupaplex · diasurgical — devilutionX · XProger — OpenLara

Die verwendeten Projekte stehen unter ihren jeweiligen Lizenzen; maßgeblich sind die Angaben in den Ursprungs-Repositories.