Skip to content

Latest commit

 

History

History
84 lines (57 loc) · 2.7 KB

README.md

File metadata and controls

84 lines (57 loc) · 2.7 KB

JPEG Repair Tool

2024-04-24_004544

This is a simple GUI tool for repairing JPEG images by shifting MCU and applying auto color enhancements.

Table of Contents

Overview

This tool is built using Python and PyQt6. It provides a user-friendly interface to repair JPEG images corrupted due to encryption or other issues.

Features

  • Select a reference JPEG image and an encrypted folder containing corrupted JPEG images.
  • Repair corrupted JPEG images by shifting MCU and applying necessary adjustments.
  • Automatically enhance colors of repaired images.
  • User-friendly GUI with buttons for easy interaction.

Requirements

  • Python 3.x
  • PyQt6
  • NumPy
  • Pillow (PIL)

pip install pyqt6 numpy pillow

Installation

To install the JPEG Repair Tool:

  1. Download the latest release from the releases page.
  2. Extract the contents to a directory.
  3. Ensure you have Python installed. You can download it from python.org.
  4. Install the required dependencies: 
    pip install -r requirements.txt

Usage

  1. Install the required dependencies.
  2. Run the script jpeg_repair_tool.py.
  3. Use the buttons to select the reference JPEG image and the encrypted folder.
  4. Click on "Repair JPEGs" to start the repair process.
  5. Optionally, click on "Auto Color" to enhance the colors of repaired images.
  6. Monitor the output in the text area for progress and errors.

How it works

The tool first identifies the MCU shift required for each corrupted JPEG image. Then, it applies the necessary shift and saves the repaired images. Optionally, it applies auto color enhancement to the images.

Contributing

We welcome contributions! To contribute:

  1. Fork the repository.
  2. Create a new branch.
  3. Make your changes.
  4. Submit a pull request.

For issues or suggestions, please open an issue on GitHub.

License

This project is licensed under the GNU General Public License (GPL). See the LICENSE file for details.

References

Contact

For support or questions, please contact us at hanaloginstruments@gmail.com.