# oplus

**Repository Path**: jade-artisan/oplus

## Basic Information

- **Project Name**: oplus
- **Description**: No description available
- **Primary Language**: C#
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-04-19
- **Last Updated**: 2026-04-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Oplus EDL Tool

> A powerful, feature-rich integrated flashing and repair tool for Oplus (OnePlus/OPPO/Realme) and EEBBK Qcom devices in EDL mode.

---

## 📖 Introduction

**Oplus EDL Tool** is a comprehensive flashing utility developed by **CoolApk@Enjoy The Wind**, with valuable contributions from **github@rtyutechstudio**. It is designed to simplify firmware flashing, brick recovery, partition management, and system modification for **Oplus** and **BBK (步步高)** platform devices.

The tool is **actively evolving**, with new features and improvements being added regularly. It provides a user-friendly **GUI (Graphical User Interface)** as the primary interaction method, making professional EDL operations accessible to everyone.

---

## ✨ Key Features

- 🔥 **EDL Mode Flashing** – Flash full firmware or specific partitions on Oplus & BBK devices
- 🔧 **Brick Recovery** – Rescue hard-bricked devices with ease
- 📦 **Partition Management** – Backup, restore, and erase partitions via intuitive GUI
- 🧩 **Loader Support** – Works with multiple Firehose/Sahara loaders
- 🖥️ **Full GUI Interface** – No command line required, all operations point-and-click
- ⚡ **Fast & Reliable** – Optimized for Oplus/BBK-specific flashing protocols

### 🛠️ Advanced Built-in Tools

| Tool | Function |
|------|----------|
| **Super Image Splitter/Merger** | Split or merge `super` images for custom partition management |
| **Image Splitter/Merger** | Split or merge boot, recovery, and other partition images |
| **Boot Patcher** | Patch boot images to gain root access (Magisk integration) |
| **ADB Toolkit** | Built-in ADB tools for device management and debugging |

---

## 👥 Credits

| Contributor | Role |
|-------------|------|
| **@Enjoy The Wind** | Lead Developer / Maintainer |
| **错弦序** (Cuò Xián Xù) | Feature Contributor |

Special thanks to the broader Android modding and Qualcomm reverse-engineering community.

---

## 🚀 Getting Started

### Requirements

- Windows 10 / 11 (64-bit recommended)
- Qualcomm HS-USB QDLoader 9008 driver installed
- Device in **EDL mode** (usually via test point or key combo)
- USB cable (data sync capable)

### Basic Usage (GUI Mode)

1. **Launch the tool** by double-clicking `Oplus_EDL_Tool.exe`
2. **Connect your device** in EDL mode (the tool will auto-detect it)
3. **Select your operation** from the main menu:

| Operation | How to Use |
|-----------|------------|
| **Flash Firmware** | Click `Flash` → Select firmware file → Click `Start` |
| **Patch Boot for Root** | Click `Patch Boot` → Select boot image → Click `Patch` |
| **Split Super Image** | Click `Super Tools` → `Split` → Select super image |
| **Merge Super Image** | Click `Super Tools` → `Merge` → Select split files |
| **Split Image** | Click `Image Tools` → `Split` → Select image file |
| **Merge Image** | Click `Image Tools` → `Merge` → Select split files |
| **ADB Commands** | Click `ADB Tools` → Select command from dropdown |

> *No command line knowledge required – all functions are accessible through buttons and menus.*

---

## ⚠️ Important Notes

- **Use at your own risk** – Flashing can permanently damage your device if done incorrectly.
- Ensure you have the correct firmware and loader for your specific device model.
- Always back up critical partitions (persist, modem, super, etc.) before flashing.
- For EEBBK devices, additional unlock steps may be required.

---

## 🔄 Status & Roadmap

The tool is **under continuous development**. Planned improvements include:

- More device-specific loader auto-detection
- Additional GUI themes and layout options
- Enhanced backup/restore with compression
- Support for newer chipsets (Snapdragon 8 Gen 2/3, Dimensity series)
- Batch processing for multiple devices

---

## 📬 Contact & Support

- Main developer: **@Enjoy The Wind** (CoolApk)
- Contributions: Open to pull requests and feature suggestions
- Bug reports: Please include device model, chipset (Oplus or BBK), and screenshots of any errors

---

## 📄 License

*To be determined by the author. Currently for personal/development use.*

---

Let me know if you'd like a **shorter version** or a **Chinese version** as well.