A User-Friendly GUI Application to Fix Corrupted and Encrypted JPEG Images
This application provides a simple, graphical user interface (GUI) built with Python and PyQt6 to effectively repair JPEG images that have been corrupted, often as a result of ransomware encryption (like Stop/DJVU) or other file-level damage.
The tool works by intelligently determining and applying the correct Minimum Coded Unit (MCU) shift using a reference image, and then offers an optional auto-color enhancement to restore image quality.
| Before Repair | After Repair |
|---|---|
 |
 |
- MCU Shift Repair: Automatically calculates and applies the necessary MCU shift to repair the header structure of corrupted JPEGs.
- Batch Processing: Repair multiple corrupted images within a specified folder using a single reference image.
- Auto Color Enhancement: Optional post-repair feature to automatically improve the color, contrast, and brightness of the restored images.
- Intuitive GUI: Easy-to-use interface powered by PyQt6.
You need Python 3.x installed on your system.
-
Clone the repository or download the latest release:
git clone https://github.com/DRCRecoveryData/JPEG-Repair-Tool.git cd JPEG-Repair-Tool -
Install the required dependencies (PyQt6, NumPy, Pillow):
pip install -r requirements.txt
Alternatively, you can install them manually:
pip install pyqt6 numpy pillow
- Run the application:
python jpeg_repair_tool.py
- Select Files:
- Click the button to select one known-good reference JPEG (an uncorrupted image from the same camera/source).
- Click the button to select the folder containing the encrypted/corrupted JPEGs.
- Repair: Click "Repair JPEGs" to start the batch repair process.
- Enhance (Optional): Click "Auto Color" to apply automatic color correction to the newly repaired images.
The core of the repair process involves MCU (Minimum Coded Unit) alignment. Many forms of file corruption, particularly those from simple encryption methods, often corrupt the file header, causing a shift in the data blocks. The tool leverages a known-good reference file to calculate the correct header offset (MCU shift) and applies this correction to the corrupted files, effectively restoring the image data structure and making the image viewable again.
We welcome contributions, bug reports, and suggestions!
- Fork the repository.
- Create a new feature branch.
- Commit your changes.
- Push to the branch.
- Open a Pull Request.
For major changes, please open an issue first to discuss what you would like to change.
This project is licensed under the GNU General Public License (GPL). See the LICENSE file for more details.
For professional support, questions, or inquiries, feel free to reach out:
📧 Email: [email protected] 🔗 GitHub: DRCRecoveryData