FlipHTML5 Downloader

Purpose

The FlipHTML5 Downloader is a Python tool designed to download public pages from FlipHTML5 books and compile them into a single PDF file. It efficiently handles large books with hundreds of pages by downloading images, converting them if necessary, and creating a high-quality PDF document.

Features

• Download Pages: Fetches pages from FlipHTML5 books in various formats.
• Image Conversion: Converts images from webp to jpg if needed.
• Progress Tracking: Provides progress updates during image downloads.
• Chunked PDF Creation: Breaks down large PDFs into smaller chunks to manage memory usage and combines them into a final PDF.
• Flexible Page Range: Allows specifying a range of pages or defaulting to the entire book.

Installation

To use this tool, you need to install the required Python libraries. You can do this using pip. Open your terminal and run:

pip install requests pillow tqdm PyPDF2 fpdf

or

pip install -r requirements.txt

Usage

1. Download the Script: Clone this repository or download the script file.

2. Run the Script: Execute the script using Python. You will be prompted to enter the following details:

   • Book ID: The ID of the FlipHTML5 book (e.g., ousy/stby).
   • Start Page Number: The page number where you want to start downloading (leave empty for default: 1).
   • End Page Number: The page number where you want to stop downloading (leave empty for default: last page).
   • Folder Name: The folder where images and PDFs will be saved (leave empty to use Book ID).
   • PDF Filename: The name of the final PDF file (leave empty for default).
   • Skip Existing Files: Whether to skip downloading images that already exist.

   Example command:

   python fliphtml5_downloader.py

   Follow the prompts to provide the necessary inputs.

3. Final PDF: Once the script finishes, the final PDF will be available in the specified folder.

Open in Google Colab

You can also use this code on Google Colab.

Contributing

Contributions to this project are welcome! If you have any suggestions or improvements, please fork the repository and submit a pull request.

🚀 Upcoming Features & Enhancements

• Expanded Format Support

  • Support for additional image formats: PNG, TIFF, BMP.
  • Option for multi-resolution downloads (low, medium, high).
  • Direct PDF download support from FlipHTML5.

• Performance Improvements

  • Enhanced multi-threading for faster downloads.
  • Asynchronous requests for reduced wait times.
  • Memory-based chunk optimization for quicker PDF creation.
  • Optional image compression for smaller PDF sizes.

• Improved User Experience

  • Simplified CLI with presets for common settings.
  • Better error handling with automatic retries.
  • Detailed logging and progress bars for PDF generation.

• Advanced Error Handling

  • Retry logic for network issues.
  • Detection and exclusion of corrupt images during PDF creation.

Acknowledgments

• Requests: For handling HTTP requests.
• Pillow: For image processing.
• TQDM: For progress bars.
• PyPDF2: For PDF manipulation.
• FPDF: For PDF creation.

License

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