ExceptedPrism3 / PDFToAudio

"PDF To Audio" is a Python tool that transforms PDF documents into audio files using OCR and Text-to-Speech technology. Ideal for accessibility and auditory learning, it supports multiple languages, parallel processing, and smart rate limit handling.

PDF To Audio

Convert your PDF documents into audio files effortlessly with PDF to Audio Converter. This Python script harnesses the power of Optical Character Recognition (OCR) and Google's Text-to-Speech (gTTS) service to transform written content into spoken words. Ideal for accessibility, auditory learning, or enjoying documents on-the-go.

🌟 Features

• PDF Text Extraction: Utilizes pdfplumber for precise text extraction.
• OCR Capability: Integrates pytesseract for handling image-based PDFs.
• Text-to-Speech: Leverages Google's gTTS API for high-quality audio output.
• Parallel Processing: Option for faster processing of multiple documents.
• Rate Limit Management: Smart retry logic with exponential backoff.
• Flexible CLI: Command-line interface for customizable configurations.

📋 Installation

Get started with these simple steps:

Prerequisites

• Python 3.x
• Required packages: pdfplumber, pytesseract, Pillow, gtts

Install Python Packages

pip install pdfplumber pytesseract Pillow gtts

Tesseract OCR

pytesseract requires Tesseract OCR. Install it from Tesseract's GitHub page.

🚀 Usage

Command Syntax

python main.py <input_folder> [--output_folder OUTPUT_FOLDER] [--audio_folder AUDIO_FOLDER] [options]

Arguments

• input_folder: Folder containing PDF files.
• output_folder (optional): Folder for saving text files (defaults to script directory).
• audio_folder (optional): Folder for saving audio files (defaults to script directory).

Options

• --language: Language for conversion (default: 'en').
• --parallel: Enable parallel processing (sequential by default).
• --retry_delay: Delay in seconds for retrying conversion (default: 5).
• --max_retries: Max retries for conversion (default: 10).

Example

python main.py ./pdfs --output_folder ./texts --audio_folder ./audios --language fr --parallel --retry_delay 2 --max_retries 3

Processes PDFs in ./pdfs, saves text to ./texts, audio to ./audios, in French, with parallel processing, a 2-second retry delay, and a maximum of 3 retries.

🤝 Contributing

Your contributions are welcome! Feel free to submit bug fixes, feature requests, or documentation improvements. Check out the issues and pull requests sections.

📄 License

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