patch-recovery-revived - GitLite

KO | EN

gitlite — search

#javascript #hacktoberfest #react #llm #go #android #machine-learning #rust #deep-learning #macos #awesome #security #mcp #ios

patch-recovery-revived

(★ 79)

a "Working" Fastbootd recovery patcher for Samsung devices.

파일 탐색기

최종 버전 다운로드 (.zip)

- - patch-recovery.yml
- env.sh
- gofile.sh
- hex_split.sh
- magiskboot
- - bbootimg.jar
- - abe
  - avb_print_property_desc.diff
  - debug.kts
  - extract_kernel.py.diff
  - factory_image_parser.py
  - free.py
  - mkdtboimg.diff
  - port.mk
  - pull.py
  - release.mk
  - remove_projects.diff
  - syncCode.sh
  - temp.txt
  - work_from_China.diff
- .gitattributes
- .gitignore
- .gitmodules
- .travis.yml
- gradlew
- gradlew.bat
- LICENSE.md
- README.md
- - 1.png
  - 10.png
  - 11.png
  - 12.png
  - 13.png
  - 14.png
  - 15.png
  - 16.png
  - 17.png
  - 18.png
  - 19.png
  - 2.png
  - 20.png
  - 21.png
  - 22.png
  - 23.png
  - 24.png
  - 25.png
  - 26.png
  - 27.png
  - 28.png
  - 29.png
  - 3.png
  - 30.png
  - 31.jpg
  - 4.png
  - 5.png
  - 6.png
  - 7.png
  - 8.png
  - 9.png
- README.md
- .gitkeep
- .gitkeep
- .gitkeep
- 1.jpg
.gitignore
hex-patches.sh
patch-recovery.sh
README.md

# 설치 가이드

1. 코드 내려받기

git clone https://github.com/ravindu644/patch-recovery-revived

깃허브에서 프로젝트 코드 전체를 내 컴퓨터로 내려받습니다.

cd patch-recovery-revived

방금 내려받은 프로젝트 폴더 안으로 이동합니다.

2. Gradle (Java/Kotlin)

보통 추천

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
JDK (Java) Java/Kotlin 프로젝트를 빌드/실행하려면 필요합니다.
Gradle 레포에 포함된 gradlew(Gradle Wrapper)를 쓰면 Gradle을 따로 설치할 필요가 없습니다.

cd boot_editor_v15_r1

이 프로젝트의 관련 파일이 하위 폴더 안에 있어서, 먼저 그 폴더로 이동합니다.

./gradlew build

Gradle로 빌드를 진행합니다.

✅ BUILD SUCCESSFUL 메시지가 뜨면 성공입니다. build/ 폴더에 결과물이 생성됩니다.

3. Make

보통

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
Make Linux/macOS는 보통 기본 설치되어 있습니다. Windows는 별도 설치(예: MSYS2, WSL)가 필요합니다.

⚠️ 이 프로젝트는 규모가 큰 저장소라, 이 방법이 실제 핵심 제품이 아니라 내부 하위 패키지를 가리키는 것일 수 있습니다. README 전체를 함께 확인해보세요.

cd boot_editor_v15_r1/aosp/dispol

이 프로젝트의 관련 파일이 하위 폴더 안에 있어서, 먼저 그 폴더로 이동합니다.

make

생성된 빌드 설정을 바탕으로 실제 컴파일을 진행해 실행 파일을 만듭니다.

✅ 에러 없이 끝나면 성공입니다. 생성된 실행 파일을 직접 실행해보세요.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Patch-Recovery-Revived

The only working `patch-recovery` tool that ever lived to patch Samsung's recovery images to enable **fastbootd mode**.

<details>
  <summary>Click to view image</summary>

<img src="./resources/1.jpg" alt="Preview" width="600"/>

</details>

## Features

- Supports `.img`, `.lz4`, `.zip` and `.tar` formats as input.
- Supports both `recovery` and `vendor_boot` images.
- Automatically downloads and processes recovery images from a provided URL or local path.
- Hex-patches the recovery binary to enable **fastbootd** mode.
- **Boot image patching**: You can also upload your `boot.img` along with `recovery.img`/`vendor_boot.img` to patch the boot image, which removes stock recovery auto-restoration issues on some devices.
- Creates an ODIN-flashable `.tar` file for easy flashing.

Notes:

- All the hex patches are located in [this database file](./hex-patches.sh).  
- On Samsung devices, `vendor_boot` contains the recovery ramdisk, only if the device uses the A/B partition scheme.
- If you include `boot.img` in your archive (`.zip`, `.tar`, etc.), the script will automatically unpack and repack it to break its signature, preventing stock recovery auto-restoration issues.

---

If this tool didn’t enable the `fastbootd` mode, it means we need to find your exact `hex` byte sequence to enable it. To learn how to get those values, please refer to the guide on the ["how-to-find-patches"](./how-to-find-patches/) page.

---

## Usage

### 🟢 GitHub Workflow

Use the GitHub Actions workflow to automate the process:

1. Star and fork this repository.
2. Trigger the workflow manually via the **Actions** tab.
3. Provide the required inputs:
   - **Model**: Your device's model number.
   - **Recovery Link**: Direct download link to the recovery image. For a single image, provide a link to an `.img` file. If you want to patch multiple images (e.g., `vendor_boot.img` + `boot.img` or `recovery.img` + `boot.img`) to prevent stock recovery auto-restoration, zip the relevant images together and upload the zip's link.
   - You can upload the recovery and get a direct link from https://filebin.net/

- The workflow will generate a patched recovery image and upload it as an artifact.
- If your archive contains `boot.img`, it will be automatically patched to remove stock recovery auto-restoration issues.
- Optionally uploaded to [GoFile](https://gofile.io/) for easy sharing.

### Output

**The patched recovery image will be available as:**
- A `.tar` file for ODIN flashing.

### 🟢 Local Usage

1. Clone the repository:
   ```bash
   git clone https://github.com/ravindu644/patch-recovery-revived.git
   cd patch-recovery-revived
   ```

2. Run the script:
   ```bash
   ./patch-recovery.sh <URL/Path to Recovery Image> <Model Number>
   ```

The script will automatically install all required dependencies and process the recovery image.

### Note

If the tool does not enable fastboot mode for your device, please start an issue on GitHub. Make sure to upload the `recovery.img` file so the issue can be investigated.

## Credits

Developed by [@ravindu644](https://github.com/ravindu644).

Got the idea from [phhusson](https://github.com/phhusson), [Johx22](https://github.com/Johx22), [ratcoded](https://github.com/ratcoded).