{"id":26657168,"url":"https://github.com/grm34/zenmaxbuilder","last_synced_at":"2025-04-11T11:54:38.079Z","repository":{"id":36998057,"uuid":"375508103","full_name":"grm34/ZenMaxBuilder","owner":"grm34","description":"📲 Android Kernel Builder | On stand-by, also take look at https://github.com/cyberknight777/YAKB","archived":false,"fork":false,"pushed_at":"2023-02-26T19:22:13.000Z","size":10048,"stargazers_count":104,"open_issues_count":4,"forks_count":28,"subscribers_count":4,"default_branch":"zmb","last_synced_at":"2025-03-25T08:17:38.669Z","etag":null,"topics":["aircrack-ng","android","aosp","clang","compiler","gcc","kali-linux","kernel","kernel-builder","nethunter","pentesting"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/grm34.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":".github/CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":".github/CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":".github/SECURITY.md","support":null}},"created_at":"2021-06-09T22:51:15.000Z","updated_at":"2025-02-21T15:53:56.000Z","dependencies_parsed_at":"2023-02-16T22:46:08.012Z","dependency_job_id":null,"html_url":"https://github.com/grm34/ZenMaxBuilder","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/grm34%2FZenMaxBuilder","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/grm34%2FZenMaxBuilder/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/grm34%2FZenMaxBuilder/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/grm34%2FZenMaxBuilder/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/grm34","download_url":"https://codeload.github.com/grm34/ZenMaxBuilder/tar.gz/refs/heads/zmb","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248391292,"owners_count":21095987,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["aircrack-ng","android","aosp","clang","compiler","gcc","kali-linux","kernel","kernel-builder","nethunter","pentesting"],"created_at":"2025-03-25T08:17:43.373Z","updated_at":"2025-04-11T11:54:38.053Z","avatar_url":"https://github.com/grm34.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🆉🅴🅽🅼🅰🆇🅱🆄🅸🅻🅳🅴🆁 📲\n\n\u003e ⚠️ This project is on stand-by for the moment. Indeed, as I don't have a computer anymore, it's impossible for me to debug/test or even to update what would certainly have needed it. Keep in mind that this was originally designed to facilitate the management/build of multiple kernels maintained by experienced developers and is not and will not be a \"run it and grab a coffee\" tool. Kernel compilation requires a minimum of prior knowledge and this kind of tool simply does not exist.\n\n\u003ca href=\"https://app.codiga.io/public/project/23638/ZenMaxBuilder/dashboard\"\u003e\n  \u003cimg src=\"https://api.codiga.io/project/23638/score/svg\" alt=\"Codescore\"\u003e\n\u003c/a\u003e\n\n\u003ca href=\"https://www.codefactor.io/repository/github/grm34/zenmaxbuilder\"\u003e\n  \u003cimg src=\"https://www.codefactor.io/repository/github/grm34/zenmaxbuilder/badge\" alt=\"Codefactor\"\u003e\n\u003c/a\u003e\n\n\u003ca href=\"https://github.com/grm34/ZenMaxBuilder/fork\"\u003e\n  \u003cimg src=\"https://img.shields.io/github/forks/grm34/ZenMaxBuilder.svg?logo=github\" alt=\"Forks\"\u003e\n\u003c/a\u003e\n\n\u003ca href=\"https://github.com/grm34/ZenMaxBuilder/stargazers\"\u003e\n  \u003cimg src=\"https://img.shields.io/github/stars/grm34/ZenMaxBuilder.svg?logo=github-sponsors\" alt=\"Stars\"\u003e\n\u003c/a\u003e\n\u003cbr\u003e\n\n\u003ca href=\"https://mit-license.org/\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/license-MIT-blue.svg?logo=keepassxc\" alt=\"License: MIT\"\u003e\n\u003c/a\u003e\n\n\u003ca href=\"https://github.com/grm34/ZenMaxBuilder/issues\"\u003e\n  \u003cimg src=\"https://img.shields.io/github/issues/grm34/ZenMaxBuilder.svg?logo=git\" alt=\"Issues\"\u003e\n\u003c/a\u003e\n\n\u003ca href=\"https://github.com/grm34/ZenMaxBuilder/commits\"\u003e\n  \u003cimg alt=\"GitHub commit activity\" src=\"https://img.shields.io/github/commit-activity/y/grm34/zenmaxbuilder?label=commits\u0026logo=github\"\u003e\n\u003c/a\u003e\n\n\u003ca href=\"https://github.com/grm34/ZenMaxBuilder/commits\"\u003e\n  \u003cimg alt=\"GitHub last commit\" src=\"https://img.shields.io/github/last-commit/grm34/ZenMaxBuilder?\u0026logo=Github\"\u003e\n\u003c/a\u003e\n\u003cbr\u003e\n\n\u003cdetails\u003e\n  \u003csummary\u003eSome tested distros\u003c/summary\u003e\n\n\u003ca href=\"https://ubuntu.com\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Ubuntu-✅-blue.svg?logo=ubuntu\" alt=\"distro\"\u003e\n\u003c/a\u003e\n\n\u003ca href=\"https://archlinux.org\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/ArchLinux-✅-blue.svg?logo=archlinux\" alt=\"distro\"\u003e\n\u003c/a\u003e\n\n\u003ca href=\"https://www.debian.org\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Debian-✅-blue.svg?logo=debian\" alt=\"distro\"\u003e\n\u003c/a\u003e\n\n\u003ca href=\"https://getfedora.org\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Fedora-✅-blue.svg?logo=fedora\" alt=\"distro\"\u003e\n\u003c/a\u003e\n\n\u003ca href=\"https://manjaro.org\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Manjaro-✅-blue.svg?logo=manjaro\" alt=\"distro\"\u003e\n\u003c/a\u003e\n\u003cbr\u003e\n\n\u003ca href=\"https://linuxmint.com\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Linux Mint-✅-blue.svg?logo=linuxmint\" alt=\"distro\"\u003e\n\u003c/a\u003e\n\n\u003ca href=\"https://www.redhat.com\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/RedHat-❔-blue.svg?logo=redhat\" alt=\"distro\"\u003e\n\u003c/a\u003e\n\n\u003ca href=\"https://www.gentoo.org\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Gentoo-❔-blue.svg?logo=gentoo\" alt=\"distro\"\u003e\n\u003c/a\u003e\n\n\u003ca href=\"https://www.centos.org\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/CentOS-❔-blue.svg?logo=centos\" alt=\"distro\"\u003e\n\u003c/a\u003e\n\n\u003ca href=\"https://www.opensuse.org\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/OpenSuse-❔-blue.svg?logo=opensuse\" alt=\"distro\"\u003e\n\u003c/a\u003e\n\u003cbr\u003e\n\n\u003ca href=\"https://www.kali.org\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Kali Linux-✅-blue.svg?logo=kalilinux\" alt=\"distro\"\u003e\n\u003c/a\u003e\n\n\u003ca href=\"https://www.blackarch.org\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/BlackArch-✅-blue.svg?logo=archlinux\" alt=\"distro\"\u003e\n\u003c/a\u003e\n\n\u003ca href=\"https://termux.com\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Termux-⚠️-blue.svg?logo=android\" alt=\"distro\"\u003e\n\u003c/a\u003e\n\n\u003ca href=\"https://www.freebsd.org\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/FreeBSD-❌-blue.svg?logo=freebsd\" alt=\"distro\"\u003e\n\u003c/a\u003e\n\u003cbr\u003e\n\n\u003ca href=\"https://www.microsoft.com/en-us/windows\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Windows-❌-blue.svg?logo=windows\" alt=\"distro\"\u003e\n\u003c/a\u003e\n\n\u003ca href=\"https://www.apple.com/macos\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/MacOS-❌-blue.svg?logo=macos\" alt=\"distro\"\u003e\n\u003c/a\u003e\n\u003c/details\u003e\n\n## Table of Contents\n\n- [Overview](#overview)\n- [Requirements](#requirements)\n- [Installation](#installation)\n- [Getting Started](#getting-started)\n- [Options](#options)\n- [Working Structure](#working-structure)\n- [Toolchains](#toolchains)\n- [Screenshots](#screenshots)\n- [More information](#more-information)\n- [Common warnings and errors](#common-warnings-and-errors)\n- [Reporting Issues](#reporting-issues)\n- [Contributing](#contributing)\n- [Help us Translate ZenMaxBuilder](#help-us-translate-zenmaxbuilder)\n- [License](#license)\n- [Credits](#credits)\n\n## Overview\n\nZenMaxBuilder (ZMB) is a Linux kernel builder written in Bash and oriented for android devices but as well compatible for other platforms. It can be installed on any compatible Linux system (feel free to Pull Request for win/mac support). By default it uses AOSP-Clang, Eva-GCC, Proton-Clang, Neutron-Clang or Lineage-GCC but you can use any Clang or GCC toolchain you like (with LLVM and binutils included).\n\nFind all your compilations and working folders in one place, update and maintain your kernels faster. Full logs with the possibility to restart the build after error. Automatic creation of a flashable signed ZIP for android devices (with AK3 and AOSP Keys). Real time status feedback with build sending on any group or Telegram channel. And more. The perfect tool to compile on the fly and keep fresh and clean kernel paths.\n\n## Requirements\n\n- A compatible Linux system\n- The kernel source code of your device/os\n- A minimum of knowledge in kernel compilation\n- Patience\n\nThe installation of the missing dependencies will be proposed by the installer or first install them manually with your favorite package manager (no package is installed without your prior consent) :\n\n    bash sed wget git curl zip tar jq expect make cmake automake autoconf llvm lld lldb clang gcc binutils bison perl gperf gawk flex bc python3 zstd openssl sudo\n\nThe optional flashable zip signature with AOSP Keys requires java (JDK) which is not proposed to install (openjdk recommended).\n\n## Installation\n\nThe installer simply clones the repository in your `HOME` and creates a copy of the executable in `usr/bin`.\n\nInstall ZenMaxBuilder :\n\n    wget kernel-builder.com/zmb \u0026\u0026 bash zmb install\n\nChecking the installation :\n\n    bash ~/ZenMaxBuilder/docs/zmb check\n\nUpdate ZenMaxBuilder :\n\n    zmb --update\n\nUninstall ZenMaxBuilder :\n\n    bash ~/ZenMaxBuilder/docs/zmb uninstall\n    rm -rf ~/ZenMaxBuilder\n\n## Getting Started\n\nCreate a copy of [settings.cfg](https://github.com/grm34/ZenMaxBuilder/blob/zmb/etc/settings.cfg) to set your settings (optional) :\n\n    cp ~/ZenMaxBuilder/etc/settings.cfg ~/ZenMaxBuilder/etc/user.cfg\n    vi ~/ZenMaxBuilder/etc/user.cfg\n\nStart ZMB and follow instructions :\n\n    zmb --start\n\nYou can exit ZMB at any time using `ctrl+c` or `ctrl+z` combinaison keys.\n\n## Options\n\n    Usage: zmb [OPTION] [ARGUMENT] (e.g. zmb --info zenfone pro)\n\n    Options\n        -h, --help                      show this message and exit\n        -s, --start                     start new kernel compilation\n        -u, --update                    update script and toolchains\n        -v, --version                   show toolchains versions\n        -l, --list                      show list of your kernels\n        -t, --tag          [v4.19]      show the latest Linux tag\n        -i, --info        [device]      mobile device specifications\n        -m, --msg        [message]      send message on Telegram\n        -f, --file          [file]      send file on Telegram\n        -z, --zip          [image]      create new kernel zip\n        -p, --patch                     apply a patch to a kernel\n        -r, --revert                    revert a patch to a kernel\n        -d, --debug                     start compilation in debug mode\n\n## Working Structure\n\n    ZenMaxBuilder/\n    |\n    |---- builds/               # Flashable kernel zips\n    |     |---- DEVICE1/\n    |     |---- DEVICE2/\n    |\n    |---- logs/                 # Compilation build logs\n    |     |---- DEVICE1/\n    |     |---- DEVICE2/\n    |\n    |---- out/                  # Kernel working directories\n    |     |---- DEVICE1/\n    |     |---- DEVICE2/\n\n## Toolchains\n\nZMB uses prebuilt toolchains by default (built on x86-64 `interpreter: lib64/ld-linux-x86-64.so.2`).\n\nIn case you need others or have already compiled/downloaded some, just move them to the `toolchains` folder and name them `aosp-clang` for example (see [settings.cfg](https://github.com/grm34/ZenMaxBuilder/blob/zmb/etc/settings.cfg)).\n\n- [AOSP-Clang](https://android.googlesource.com/platform/prebuilts/clang/host/linux-x86/) `Android Clang/LLVM Prebuilts by Google`\n- [Binutils](https://android.googlesource.com/platform/prebuilts/gcc/linux-x86/) `Android GCC/LLVM Prebuilts by Google`\n- [Eva-GCC](https://github.com/mvaisakh/gcc-build) `Bleeding Edge GCC Prebuilts by mvaisakh`\n- [Neutron-Clang](https://gitlab.com/dakkshesh07/neutron-clang) `Bleeding Edge LLVM Prebuilts by dakkshesh07`\n- [Proton-Clang](https://github.com/kdrag0n/proton-clang) `Android Clang/LLVM Prebuilts by kdrag0n`\n- [Lineage-GCC](https://github.com/LineageOS/android_prebuilts_gcc_linux-x86_aarch64_aarch64-linux-android-4.9) `Android GCC Prebuilts by LineageOS`\n- Proton-GCC `Proton-Clang vs Eva-GCC`\n- Neutron-GCC `Neutron-Clang vs Eva-GCC`\n- Host-Clang `system host Clang/LLVM`\n\n## Screenshots\n\n\u003cdetails\u003e\n  \u003csummary\u003eClic to expand\u003c/summary\u003e\n\n  ![screenshot](https://raw.githubusercontent.com/grm34/ZenMaxBuilder/zmb/docs/assets/images/screenshot.png)\n  ![help](https://raw.githubusercontent.com/grm34/ZenMaxBuilder/zmb/docs/assets/images/help.png)\n  ![devices](https://raw.githubusercontent.com/grm34/ZenMaxBuilder/zmb/docs/assets/images/devices.png)\n  ![telegram](https://raw.githubusercontent.com/grm34/ZenMaxBuilder/zmb/docs/assets/images/telegram.png)\n\u003c/details\u003e\n\n## More information\n\nZMB is a tool to facilitate the compilation of the Linux kernel, it does not modify the source, does not adds possible patchset and does not fixes specific drivers or compilation warnings.\n\nThe only change made is the addition of the selected toolchain compiler in the main Makefile, all others options from ZMB settings will be passed directly to make as command-line arguments :\n\n    # AOSP-Clang\n    CROSS_COMPILE ?= aarch64-linux-android-\n    CC             = clang\n\n    # Proton-Clang / Neutron-Clang\n    CROSS_COMPILE ?= aarch64-linux-gnu-\n    CC             = clang\n\n    # Eva-GCC\n    CROSS_COMPILE ?= aarch64-elf-\n    CC             = aarch64-elf-gcc\n\n    # Lineage-GCC\n    CROSS_COMPILE ?= aarch64-linux-android-\n    CC             = aarch64-linux-android-gcc\n\n## Common warnings and errors\n\n- `invalid kernel directory` : occurs while the `ARCH` option is not matching the selected kernel directory (or while `KERNEL_DIR` is not correctly set), edit `user.cfg` accordingly.\n\n- `your system does not support this prebuilt of` : occurs while the included prebuilt toolchains are not compatible with your system, you can disable `HOST_LINKER` in `user.cfg` but the build will fail in most cases. System compatible toolchains are required or you can try host compiler option.\n\n- `CROSS_COMPILE not found in Makefile` : occurs while your source is configured to pass `CROSS_COMPILE` to `make` as command-line argument. You can ignore this warning except if you deactivated `MAKE_CMD_ARGS`.\n\n- `CROSS_COMPILE may not be set correctly in Makefile` : occurs while another compiler is defined in the main `Makefile`. You can ignore this warning and answer `yes` while ZMB asking to set it up for you.\n\n- `failed to add toolchain bin to the PATH` : occurs while the `PATH` is not correctly set, please open an issue.\n\n- An error occurs while getting the kernel version : in most cases your source is not configured to be built with the selected toolchain compiler. Try another compiler or answer `yes` while purposed and edit your `Makefile` accordingly.\n\n- `kernel version not found` : same as above or issue with your source.\n\n## Reporting Issues\n\nFound a problem? Want a new feature? Have a question? First of all see if your issue, question or idea has [already been reported](https://github.com/grm34/ZenMaxBuilder/issues?q=is%3Aissue). If don't, just open a [new clear and descriptive issue](https://github.com/grm34/ZenMaxBuilder/issues/new/choose).\n\n## Contributing\n\nIf you want to contribute to ZenMaxBuilder project and make it better, your help is very welcome: [Contributing Guidelines](https://github.com/grm34/ZenMaxBuilder/blob/zmb/.github/CONTRIBUTING.md).\n\n## Help us Translate ZenMaxBuilder\n\n| language | flag | translator | progress |\n| :------- | ---: | ---------: | -------: |\n| English  |   🇬🇧 |     @grm34 |     100% |\n| Spanish  |   🇪🇸 |     @grm34 |     100% |\n| French   |   🇫🇷 |     @grm34 |     100% |\n| German   |   🇩🇪 |   @0n1cOn3 |     100% |\n\n## License\n\n    MIT License\n\n    Copyright (c) 2021-2022 darkmaster @grm34 Neternels Team\n\n    Permission is hereby granted, free of charge, to any person\n    obtaining a copy of this software and associated documentation\n    files (the \"Software\"), to deal in the Software without restriction,\n    including without limitation the rights to use, copy, modify, merge,\n    publish, distribute, sublicense, and/or sell copies of the Software,\n    and to permit persons to whom the Software is furnished to do so,\n    subject to the following conditions:\n\n    The above copyright notice and this permission notice shall be\n    included in all copies or substantial portions of the Software.\n\n    THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND,\n    EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF\n    MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.\n    IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY\n    CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,\n    TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE\n    SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.\n\n## Credits\n\n- Neternels Team: [https://neternels.org](https://neternels.org)\n- Proton-Clang: [@kdrag0n](https://github.com/kdrag0n)\n- Neutron-Clang: [@dakkshesh07](https://gitlab.com/dakkshesh07)\n- Eva-GCC: [@mvaisakh](https://github.com/mvaisakh)\n- Lineage-GCC: [@LineageOS](https://github.com/LineageOS)\n- AnyKernel3: [@osm0sis](https://github.com/osm0sis)\n- ZipSigner: [@osm0sis](https://github.com/osm0sis) [@topjohnwu](https://github.com/topjohnwu)\n- Patches: [@Kali-Linux](https://gitlab.com/kalilinux) [@cyberknight777](https://github.com/cyberknight777)\n\n### Buy me a beer ?\n\n    LTC: MHjiEKDw7SAtx6HzSeFEWTfEUiVUak2wUD\n    BTC: 356URzmeVn8AF8WxMtqipP2qQ3gwZQHdRi\n    BCH: 1MrG2pNek2v1nM2JShjW6gnxvS9sdxaytw\n    DOGE: DEMJp1QLze6n76h2f4KH6a55UBETuZHdMp\n    GTC: 0x349319b09D93EE3576F99622fDEE1388f42a82B0\n    ETH: 0x445bd5EF7f36CF09135F23dd9E85B8De9fab2199\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgrm34%2Fzenmaxbuilder","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgrm34%2Fzenmaxbuilder","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgrm34%2Fzenmaxbuilder/lists"}