Skip to content

A tool to convert online novels into audiobooks using TTS

License

Notifications You must be signed in to change notification settings

Spectre-hidN/LibRead-Tool

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

9 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

LibRead-Tool

Converts online novels into audiobooks

Introducing LibRead-tool – your go-to for turning online novels into awesome audio! Fetch your favourites and convert them into audiobooks. Say hello to hands-free storytelling!

LibRead-Tool Main page Result

🌸 Features

  • 🔍 Search novels directly within LibRead-Tool
  • 📕 Convert novels into one audiobook or Split it into parts
  • 💾 Embeds ID3 tags into the MP3 file
  • 🌐 Scrapes LibRead to fetch novels

🔧Installation

Using Portable Builds

  • This is the recommended method if Python is not installed on your system.
  • Download the executable binary files from the release page for your system
  • To execute the program, use the following method
    • On Windows, double-click on the application to run it.
    • On Ubuntu-based distros, open a terminal in the directory where the executable file is saved and execute the following command ./LibRead-Tool_Zorin-OS.
      If you are getting a permission denied error, then you have to execute the command
      chmod +x LibRead-Tool_Zorin-OS to make it executable.


Running from source

  • You need Python, preferably version >= 3.9, to run the script files.
  • You can obtain the source code files either from the release page or by cloning this repo using git,
  • Downloading pip to resolve dependecies
    • Pip is required to download the packages required for the execution of the script. If your system doesn’t have pip installed, then you can use the following command to install
      • On Debian/Ubuntu-Based Distros sudo apt-get install python3-pip
      • On Red Hat/Fedora-Based Distros sudo dnf install python3-pip
  • Resolving dependencies using pip
    • Open a terminal in the src directory and execute the following command to obtain the packages required for the script.
      pip install -r requirements.txt
  • Executing the script
    • To run the script, execute the following command in the terminal. python3 ./libread-tool.py

Installing Optional Dependency

  • FFmpeg is required to merge different sub-parts into one. It is not essential to have it installed, but it increases stability during conversions. If FFmpeg is not found in the system’s path, then it will fetch all the chapters in a single part and convert them at the end.
  • Use this guide to get it installed on your windows OS.
  • Most Linux distros come pre-installed with a supported version of FFmpeg. But, if that's not the case, then use the following command to get it installed.
    • On Debian/Ubuntu-based distros sudo apt install ffmpeg
    • On Fedora-based distros sudo dnf install ffmpeg

⚙️ Configuring

Upon initial execution, the program will create a default configuration file inside the same directory named libread-config.ini. You can open that in any text editor, and you might change some options.



Packages Used
beautifulsoup4
requests
music-tag
pynput
PyWinCtl
edge-tts