Skip to main content

A versatile module providing memory-efficient text-to-speech capabilities for various file formats.

Project description


pyxreader is a Python module that streamlines the process of reading and vocalizing the content of files using text-to-speech capabilities in a memory-efficient way. It provides a flexible and extensible architecture to support various file formats and allows for custom methods that the user can choose to extract text from various files.


  • Read and vocalize the content of any file.
  • Easily configure reading speed, volume, and voice.
  • Support for custom dependency injection, enabling users to define their own text extraction logic for various file formats. The module comes with native support for PDFs.


pip install pyxreader

if you're on linux, for the speech capabilities you might also need to install:

sudo apt update && sudo apt install espeak ffmpeg libespeak1

Note: The text-to-speech capabilities are provided by pyttsx3. If you encounter any issues with speech not functioning on your system, make sure to consult the library for more information.


The Reader class allows you to configure various settings:

  • speed: Reading speed in words per minute (default: 200).
  • volume: Volume level, a float between 0.0 and 1.0 (default: 1.0).
  • voice: The voice to use for reading (default: operating system).


Normal text file reader

from pyxreader import TextReader

# Speak the provided text
TextReader("Hey there!").say().execute()

# Save spoken text to an MP3 file
TextReader("Whatever it read").save("output.mp3").execute()

# Read and speak the content of a normal file line by line

Custom files (PDFs by default)

from pyxreader import AdaptableReader

# Read and vocalize the content of a PDF file with default settings
# Defaults to the base iterator PDFTextIterator.

This uses PDFTextIterator to parse PDFs and extract text per page

How it works

from pyxreader import PDFTextIterator

per_page = PDFTextIterator("any.pdf")
for line in per_page:

If the file you have is not a PDF like


Then define your own custom file iterator

from pyxreader import AdaptableReader
from pyxreader.iterators import BaseIterator

class CustomIterator(BaseIterator):
    def __init__(self, file: str):
        # Additional initialization for your custom iterator

    def __iter__(self) -> "CustomIterator":
        Method to initialize the custom iterator.

    def __next__(self) -> str:
        Method to extract the next item in the iteration.
        # Implement the logic to extract the next item in the iteration for your custom iterator
        # This method should return a string

# Example using a custom iterator

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pyxreader-0.0.1.tar.gz (6.0 kB view hashes)

Uploaded source

Built Distribution

pyxreader-0.0.1-py3-none-any.whl (6.8 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page