Audiobook Downloader and Tagger

This Python script downloads all chapters of an audiobook from tokybook.com or zaudiobooks.com, embeds metadata (title, author, narrator, etc.), and attaches cover art.

Note: This project is intended for educational purposes only. Please respect copyright laws and the terms of service of the respective websites.

Supported Sites

• tokybook.com
• zaudiobooks.com
• fulllengthaudiobooks.net
• hdaudiobooks.net
• bigaudiobooks.net
• goldenaudiobook.com (only on Mac)

Features

• Downloads all chapters for a given audiobook URL.
• Prompts the user for audiobook details (URL, cover art, author, etc.).
• Automatically scrapes the book title.
• Embeds essential ID3 tags into each MP3 file for proper organization in media players.
• Saves the organized, tagged files into an Audiobooks folder in the script's directory.
• Displays a summary table of all metadata before starting the download.

---

Setup and Installation

To run this script, you need Python 3.11 installed on your system.

Step 1: Clone the Repository

Start by cloning this repository to your local machine:

git clone https://github.com/aviiciii/tokybook.git
cd tokybook

Step 2: Install Required Dependencies

This project requires both Python packages and FFmpeg for audio processing.

Install FFmpeg:

Make sure FFmpeg is available in your system's PATH.

• macOS:

  brew install ffmpeg

• Linux (Debian/Ubuntu):

  sudo apt update
  sudo apt install ffmpeg

• Windows:
  1. The easiest way is to use winget:

     winget install ffmpeg

  2. Alternatively, download FFmpeg from ffmpeg.org/download.html, extract the files, and add the bin folder to your system's PATH.

Install Python Packages and Run the Script:

You can install the required Python packages using either pip or the faster uv package manager:

Option A: Using uv (recommended)

If you have uv installed, just run:

uv run main.py

Option B: Using pip

pip install -r requirements.txt

python main.py # or python3 main.py on some systems

The script will then prompt you to enter the following information:

• The URL for the audiobook. (It must be from tokybook.com, zaudiobooks.com, fulllengthaudiobooks.net, hdaudiobooks.net, bigaudiobooks.net or goldenaudiobook.com.)
• Optional details like the author, cover image URL, year, and narrator.

After you provide the details, it will display a summary table, and the download will begin.

Enjoy :)

---

Acknowledgements

This tool was made possible by the developers of the following open-source libraries:

• yt-dlp
• FFmpeg
• Requests
• Beautiful Soup
• Tqdm
• Mutagen
• Rich
• uv

A special thanks to the team behind tokybook.com, goldenaudiobook.com and zaudiobooks.com for providing access to the audiobooks.