/pipsqueak

convert articles into shareable voiceover mp3's

Primary LanguagePython

Pipsqueak: Turn Articles to MP3's!

Pipsqueak Banner

Pipsqueak is a handy tool that converts articles into shareable MP3 audio files. It's perfect for people who are visually impaired, those who want to enjoy some nighttime reading without straining their eyes, or anyone who simply prefers listening to articles rather than reading them.

Features

  • Convert any article URL to an MP3 audio file
  • Download and share the generated audio files easily
  • Get around paywalls seamlessly
  • (Coming soon) Celebrity voices
  • (Coming soon) User Interface to download articles. Current version supports downloads through git commands

Prerequisites

  • Python 3.8+

Installation

  1. Clone the repository: git clone https://github.com/yourusername/pipsqueak.git
  2. Change to the repository's directory: cd pipsqueak
  3. Install the required dependencies: pip install -r requirements.txt

Usage

  1. Run the script by opening up your terminal python article_to_audio.py <url> [<output_filename>]
  2. The MP3 file will be saved in the same directory as the script, ready to be shared or listened to.

Contributing

I welcome contributions! Please feel free to submit a pull request or open an issue to discuss improvements or suggest new features.