Skip to content

In essence, it's a collection of scripts and tools bundled together to simplify complex procedures for Android modding, such as: Flashing custom software: Installing custom ROMs (like LineageOS), Generic System Images (GSIs), and other modifications. Bypassing security: Disabling Factory Reset Protection (FRP) and Android Verified Boot(AVB)

License

Interested-Deving-1896/BlacksmithOS

Repository files navigation

BlacksmithOS

Built by SudoWarrior317 — Out The Gate 🔥

A Linux-based toolkit to unlock, root, patch, and revive legacy Android devices — especially Samsung tablets like the SM-T560NU.

🔧 Tools Included

  • lash-gsi.sh — Raw GSI system.img installer
  • �uildprop-patcher.sh — Disable FRP and setup wizard
  • �bmeta-null.sh — AVB verification killer
  • lash-rom.sh — Sideloader for LineageOS + GApps + Magisk
  • rp-killer.sh — ADB-based lock/FRP remover
  • gsi-part-resize.sh — Resizes system partition for larger GSIs
  • �lacksmith.sh — Zenity-powered GUI launcher for all toolkit scripts

🚀 Installation

  1. Clone or Download: Get this repository to your Linux system.
  2. Run Installer: �ash chmod +x install.sh ./install.sh
  3. Reload Shell: Restart your terminal or run source /etc/profile.d/blacksmith.sh to load the new PATH and aliases.

🧰 Usage

All scripts are located in /opt/blacksmith/scripts/. The GUI launcher can be started by typing �lacksmith (alias for /opt/blacksmith/scripts/blacksmith.sh). Individual scripts can be run directly, e.g., lash-gsi.sh system.img.

📚 Documentation

Refer to the docs/ folder for detailed guides on:

  • Installing BlacksmithOS
  • Flashing Samsung devices (SM-T560NU specific)
  • GSI porting and troubleshooting
  • Understanding and bypassing Android Verified Boot (AVB)
  • Building your own custom ISO

License

This project is licensed under the MIT License (see LICENSE file for details).

About

In essence, it's a collection of scripts and tools bundled together to simplify complex procedures for Android modding, such as: Flashing custom software: Installing custom ROMs (like LineageOS), Generic System Images (GSIs), and other modifications. Bypassing security: Disabling Factory Reset Protection (FRP) and Android Verified Boot(AVB)

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages