Giter VIP home page Giter VIP logo

sh0wer's Introduction

     .-.     
    (   ).   
   (___(__)  
    ' ' ' '  
   ' ' ' '   

Another Linux-based distribution for jailbreaking iOS devices on the A7-A11 chipset with the checkra1n jailbreak.

It aims to be fast and lightweight, yet easy to use.

Usage โ€ข Building


Usage

You'll need a USB storage device with at least 128MB of storage.

Download the appropriate ISO for your PC:

  • x86_64 is for 64-bit CPUs
  • x86 is for 32-bit CPUs

If you don't know what type of CPU you have:

Windows

Open File Explorer, right click This PC and select Properties, look for the line "System type":

  • x64-based processor means your CPU is 64-bit
  • x86-based processor means your CPU is 32-bit

I will only support Ventoy, use other tools at your own risk

  1. Get the latest Ventoy for Windows here: https://github.com/ventoy/Ventoy/releases
  2. After downloading and extracting the Ventoy .zip file, connect your USB flash drive then open the Ventoy2Disk.exe program. Back up any files on the USB now, you can copy them back later.
  3. Select your USB flash drive at the top then press Install. You will be prompted twice to confirm that you are okay with deleting all data on the drive.
  4. Copy the Odysseyn1x .iso file to the newly-flashed "Ventoy" USB.

Building sh0wer

Installing build dependencies

Debian and its derivatives

sudo apt-get update
sudo apt-get install -y --no-install-recommends wget debootstrap grub-pc-bin \
    grub-efi-amd64-bin mtools squashfs-tools xorriso ca-certificates curl \
    libusb-1.0-0-dev gcc make gzip xz-utils unzip libc6-dev zstd rename

Environment variables

All build variables are inside the .env file.

VERSION="YOUR_VERSION"
ARCH="ARCHITECTURE_TO_BUILD" # Available architectures: x86_64 and x86

# Leave empty to automatically grab the latest version
CHECKRA1N_AMD64=""
CHECKRA1N_I486=""
SILEO=""
ZSTD="" # gz-compressed archive of release from https://github.com/facebook/zstd

Advanced: Kernel modules

Inside the file modules is a list of kernel modules to keep. If you made a copy of the modules file, you can instruct the build script to read from the file you modified by editing the KERNEL_MODULES variable at the start of the script.

Notes

  • The file supports commenting by putting # at the beginning of the line (you cannot do in-line commenting).
  • Any blank lines must be totally blank (can be removed entirely with sed '/^$/d')
  • If you're on Windows, ensure that you are using the LF newline character so as not to cause any issues.

sh0wer's People

Contributors

beerpiss avatar

Stargazers

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

Watchers

 avatar

Forkers

streemline

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.