Giter Club home page Giter Club logo

nxboot's Introduction

NXBoot

This application enables provisioning a Tegra X1 powered device with early boot code using an iOS or macOS device. For example, you may use this application to start the Hekate Bootloader or the Lakka Linux Distrobution (RetroArch) on a supported Nintendo Switch.

Disclaimer: Early boot code has full access to the device it runs on and can damage it. No boot code is shipped with this application. Responsibility for consequences of using this application and executing boot code remains with the user.

Released Features

  • Command line tool for iOS and macOS
  • Native app for iOS
  • Fusée and ShofEL2 (Coreboot/Linux) payloads are supported
  • Hekate integration (command line tool only)
  • Store multiple payloads and easily switch between them
  • Install payloads via iTunes File Transfer or any iCloud/Files-Compatible file transfer app
  • Auto-boot, just connect your device while the app is opened

Planned Features

There is no ETA on those, it's just a bunch of ideas that I think are nice to have for this app:

  • Managed payload profiles with auto-updates (always have the latest Hekate etc. available without any effort)
  • Optional Substrate tweak that disables the unsupported device message when a Switch is connected
  • Proper macOS GUI (currently limited working but unreleased Mac Catalyst port)
  • Hekate integration for GUI

Prerequisites

  • A jailbroken iOS device with firmware 11.0-14.2 (later iOS versions are most likely fine too)
  • Proper sandbox patches installed by the jailbreak (unc0ver works as-is)
  • A USB 3 Type A to Type C cable
  • An OTG (Lightning to USB 2.0 or 3.0) adapter. Apple's costs $35, and cheaper third-party adapters may work.

Installation

For installation instructions please visit the project homepage at mologie.github.io. The app and command line tools can be built from source via build_app.sh and build_cmd.sh after running quickstart.sh once.

Components

  • NXBoot: The feature-complete iOS 11.0+ and Mac Catalyst app
  • NXBootCmd: iOS and macOS command line tool for injecting payloads
  • NXBootKit: The framework that powers the above tools

License

All included source code is licensed under the GPLv3. Pull requests must be made available under the same license.

Attribution and Prior Work

CVE-2018-6242 was discovered by Kate Temkin (@ktemkin) and fail0verflow (@fail0verflow). Fusée Gelée was implemented by @ktemkin; ShofEL2 was implemented by @fail0verflow.

JustBrandonT has implemented a proof-of-concept Fusée app for iOS 11.1 and earlier at GBAtemp. This application was developed independently of JustBrandonT's work.

nxboot's People

Contributors

mologie avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar

nxboot's Issues

TrollStore already works!

On my device (iPad Air 3 on iOS 15.0 running Dopamine) was successfully able to boot my Nintendo Switch from RCM by exporting the ipa using AppIndex. Turns out, it already works with TrollStore! You only need to release the .ipa file.

Repo cannot be added to Sileo on Dopamine (rootless)

Dopamine is out of beta. I tried adding your repo, but I can't install nxboot. I'm guessing some dependency is not compatible with rootless.

Is it possible for you to investigate and maybe update?

Dopamine 1.0.2
iPhone mini 13
iOS 15.1.1

Any way this could be installed through AltStore?

Hey I think this would be very useful but I don't have plans to jailbreak my phone. I don't know a lot about iOS development but at a high-level it seems like this app should be able to run in user-space and not actually require any priv-esc or working around the OS, so I was wondering if this app would work if it was installed through AltStore instead of Cydia? I understand it probably needs to be recompiled to produce an .ipa file but it would be great if that is possible and could be published as a release or something. There may be technical details I am unfamiliar with though so I understand if that's not the case.

Trollstore Support

Hello, I saw that sideloading this ipa is impossible due to sandboxxing causing issues, but since Trollstore allows you alot of free reign like arbitrary entitlements and unsandboxing
I was wondering if there are any plans to update this to allow installing with Trollstore, it would be very helpful for me and my modded switch.

Does not work on OSX

The homepage and the Github imply it should work on OSX but I can't get it to work and there are no clear instructions on how to do so either.

Catalyst Build

Hey,

could you add a download link to a catalyst build?
I don't seem to find it anywhere. I tried building myself, there are a few AppCenter Frameworks missing.

Update via Cydia does not terminate the application

The application remains opened when updated through Cydia. A random crash happens when the user returns to it. Launching the application again then spawns the new executable, which will work normally.

Workaround: Create a post-install script that runs killall NXBoot

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.