Giter Club home page Giter Club logo

bootwitch's Introduction

bootwitch

Magisk-powered Android Kernel Installer

Version License: BSD 3-Clause okitavera

๐Ÿ— Setup

magiskboot

Although bootwitch are powered by magiskboot, it doesn't comes with the magiskboot binary by default.
The main purpose of it is so you can decide what version of magiskboot by yourself.
So, before anything else, you need to put your preferred magiskboot binary file inside the external/ folder.

kernel related files

Like anykernel2, you can put your Image.gz-dtb (and dtbo.img if you also want to flash that) to the root of bootwitch folder.

Specific kernel configuration (kernel.conf)

There is several things that you can configure in the kernel.conf.

kernelid=

Used by buildzip.sh for naming your zip files. required if you're using buildzip.sh for building zip file.

kernelname=
kernelver=
kernelauthor=

Informations of your kernel release. it will be displayed in the installation process. OR :

banner_mode=

If you want to use your own banner at banner.txt, you can set banner_mode to custom.
It will display the content of banner.txt instead the default information.

blk_boot=
src_kernel=

Define your kernel filename, and where the boot device block on it.

with_dtbo=
blk_dtbo=
src_dtbo=

If your kernel release also provide the dtbo.img, you can enable with_dtbo=true.
Don't forget to set the dtbo device block on blk_dtbo, and dtbo filename on src_dtbo.
If not, then just set it to false.

preserve_magisk=

Mostly, custom kernel on system-as-root devices doesn't patch their initramfs.c (@okitavera does, hehehe).
Basically, in order preserve magisk functionality on system-as-root device, you need to hexpatch it like Magisk does.
But don't worry, we got you.
You just need to set it true to let the witch (and of course, magiskboot) does the job.

before_process() {
  ....
}
after_process() {
  ....
}

This is an optional function that will be invoked before/after the whole process happens
You can use it for example: device checking, backing-up files, etc.

๐Ÿ“ฆ Building zip file

bootwitch comes with buildzip.sh to generate zip easily.
If you're already setup all things (kernel.conf, external/magiskboot, Image.gz-dtb, and maybe dtbo.img),
you can just run the script directly in your bootwitch folder.

./buildzip.sh

Author

๐Ÿ‘ค Nanda Oktavera

๐Ÿค Contributing

Contributions, issues and feature requests are welcome!
Feel free to check issues page.

Show your support

Give a โญ๏ธ if this project helped you!

๐Ÿ“ License

Copyright ยฉ 2019 Nanda Oktavera.
This project is BSD 3-Clause licensed.


This README was generated with โค๏ธ by readme-md-generator

bootwitch's People

Contributors

okitavera avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar

Forkers

gah0

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.