/Android-Binloader-Magisk-Module

a Magisk module that provides a simplified cli packager to load various executables to Android

Primary LanguageShellMIT LicenseMIT

Android Binaries Loader

a Magisk module that provides a simplified command-line packager to load various binaries/scripts/executables into Android system

What is this

This is a command-line utility for Android devices. It provides a packager(bpkg), which enables us to load various useful utils with a simple package. With this, we are not needed to write a new Magisk module for a single script.

Installation

Step 1 - Download the latest flashable zip from Release page of this repo;
Step 2 - Put the zip into the sdcard, and flash it via Magisk app and reboot;
Step 3 - Launch terminal emulator app, and type 'binloader', it will be initialized;
Step 4 - Reboot again and enjoy.

Usage

bpkg + [Options] + [Parameters]
Options:

install [path] - install a new package
remove [path] - remove a installed package
ls - list all installed packages
ver - show blcore version information
help - show this help screen

Make a Package

Package Structure

─ util_1.0 [folder]
----programs [folder] ---- custom_applet.sh
----pkginfo [file]

pkginfo File Content

Total 4 tags of this metadata file, they are:
pkgname=[NAME_OF_YOUR_APPLET]
version=[APPLET_VERSION]
execpath=[custom_applet.sh]
execname=[NAME_OF_EXEC]

  • execname is the spell of the command which you access this applet in terminal to.

Try Packing a Script

For example we have script 'custom_applet.sh', following these simple steps:
Step 1 - create a folder named 'programs';
Step 2 - copy the 'custom_applet.sh' to 'programs' folder;
Step 3 - write pkginfo file according to the format above;
Step 4 - pack the folder and pkginfo with tar format;
Step 5 - install the tar file using 'bpkg install [file_path]' command and reboot.
After this, you can access your brand new applet via terminal.

About This Program

This is a command-line utility which is working at Magisk environment, it has been tested working fine with Magisk v26.3 and Android 13. But still, this utility does NOT responsible for any losses by using this program, please use it at your own risk.


THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.