/odysseyn1x

Primary LanguageShellMIT LicenseMIT

odysseyn1x

Linux-based distro that lets you install checkra1n, odysseyra1n and Project Sandcastle.

logo

This project aims to be easy to use, to have a nice interface and to support both 32 and 64 bit CPUs.
Here is a screenshot of odysseyn1x.
Contributions are gladly appreciated :)

Usage

Make an iCloud/iTunes backup before using odysseyn1x, so that you can go back if something goes wrong.

The amd64 iso is for 64-bit CPUs (AMD and Intel) and the i686 one is for 32-bit CPUs. If you are unsure which one to download, the amd64 ISO will work in most cases.

  1. Download an .iso here.
  2. Download balenaEtcher. If you prefer Rufus, make sure to select GPT partition and DD image mode otherwise it won't work.
  3. Open balenaEtcher and write the .iso you downloaded to your USB drive.
  4. Reboot, enter your BIOS's boot menu and select the USB drive.

Odysseyra1n

What's odysseyra1n

Odysseyra1n lets you install on a checkra1ned device

  • libhooker, a substrate/substitute alternative built from the ground up by Coolstar with speed and stability in mind,
  • Procursus, an open source and modern bootstrap that aims to provide a large set of consistently up-to-date tools and
  • Sileo instead of aging Cydia.

Installing odysseyra1n

  1. Restore rootfs using the ckeckra1n app.
  2. Jailbreak using checkra1n, but don’t open the loader.
  3. Install odysseyra1n.
  4. OpenSSH is installed by default, please change the default mobile/root passwords.

Note: You don’t have to reinstall odysseyra1n after each reboot, just re-jailbreak using checkra1n.

Changing the default mobile/root passwords

Changing the default passwords is a must to prevent the possibility of unsavory people remotely logging into your device through SSH.
The default/old password is alpine.

  1. Install Newterm in Sileo.
  2. Open it and type passwd mobile to change the mobile user's password.
  3. Then, execute su to login as root.
  4. After that, run passwd to change its password.

Project Sandcastle

What's Project Sandcastle

It's Android and Linux for the iPhone. Project Sandcastle is in beta so not everything is fully supported. More information

Installing Android

Select Project Sandcastle > Setup Project Sandcastle > Start Android. When Project Sandcastle has been installed, simply choose "Start Android" to boot back into Android.

Removing Android

If you wish to remove the Android NAND image and reclaim the space, you can login via SSH or using the terminal app (for example Newterm) to your checkra1ned device, and mount the final volume, and remove the NAND file. To do this, run ls /dev/disk0s1s* and find the last volume. You can verify it's the right volume by running /System/Library/Filesystems/apfs.fs/apfs.util -p VOLUME_HERE and if it says Android, that's the correct one. Once you have the volume path, you can then run these commands as root (type su):

mkdir -p /tmp/mnt
mount -t apfs VOLUME_HERE /tmp/mnt
rm -rf /tmp/mnt/nand
umount /tmp/mnt
sync

and that will reclaim the space for you.

Booting Linux

Select Project Sandcastle > Start Linux.

Building odysseyn1x

To change the version of checkra1n, edit CRSOURCE_amd64 and CRSOURCE_i686.
Execute these commands on a Debian-based system.

git clone https://github.com/raspberryenvoie/odysseyn1x.git
cd odysseyn1x
sudo ./build.sh

Credits