Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/mcombeau/epub_downloader
EPUB downloader for remote archives. Supports URL resolution for www.epub.pub or www.readanybook.com ebooks.
https://github.com/mcombeau/epub_downloader
downloader ebook-downloader ebooks epub epub-downloader epub-files epub-generation python3
Last synced: 27 days ago
JSON representation
EPUB downloader for remote archives. Supports URL resolution for www.epub.pub or www.readanybook.com ebooks.
- Host: GitHub
- URL: https://github.com/mcombeau/epub_downloader
- Owner: mcombeau
- License: mit
- Created: 2024-05-22T09:41:07.000Z (8 months ago)
- Default Branch: main
- Last Pushed: 2024-06-23T12:17:25.000Z (6 months ago)
- Last Synced: 2024-06-23T20:53:34.548Z (6 months ago)
- Topics: downloader, ebook-downloader, ebooks, epub, epub-downloader, epub-files, epub-generation, python3
- Language: Python
- Homepage:
- Size: 59.6 KB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# EPUB Downloader
This script downloads an ebook from an online reader and creates an EPUB file for offline viewing.
Though this script can be used if you know the URL to a remote EPUB archive, it is specifically designed to handle finding EPUB URLs for the following sites:
- [epub.pub](https://www.epub.pub/)
- [readanybook.com](https://www.readanybook.com)
Please open an issue to request support for other domains, or submit a PR!
## Description
Given a URL to a remote EPUB file, this script parses its content list and downloads all the necessary files to recreate the EPUB archive locally.
If a URL to an www.epub.pub or a www.readanybook.com book page is supplied, it can automatically resolve the EPUB's remote storage URL.
This script supports verbose output to help track the progress and identify issues during the download and creation process.
Works on Linux, MacOS and Windows.
## Prerequisites
- Python 3.6 or higher
- Dependencies:
- `bs4`
- `lxml`
- `tqdm`
- `urllib3`
## Installation
1. Clone the repository or download the script file.
2. Install the required Python packages using pip:
```bash
pip install -r requirements.txt
```
## Usage
To run the script, use the following command:
```bash
Copy code
python epub_downloader.py [book_url] [-v]
```
- `book_url`: The URL of the EPUB archive or to the book page on epub.pub or readanybook.com
- `-v`, `--verbose`: Enable verbose output (optional)
### Example
The script handles downloading directly from the book page for the www.epub.pub and www.readanybook.com domains:
```bash
python epub_downloader.py https://www.epub.pub/book/it-by-stephen-king
```
```bash
python epub_downloader.py https://www.readanybook.com/ebook/it-book-565296
```
Or you can download from the epub.pub spread or continuous page (after clicking on one of the Read Online buttons):
```bash
python epub_downloader.py https://spread.epub.pub/epub/5a5827247412f4000781f18e
python epub_downloader.py https://continuous.epub.pub/epub/5a5827247412f4000781f18e
```
Or if you're into digging for the EPUB URL manually:
```bash
python epub_downloader.py https://asset.epub.pub/epub/it-by-stephen-king-1.epub
```
## Notes
- The script will create a temporary directory to store downloaded files, which will be cleaned up after the EPUB is created.
- **Support Authors: If you enjoy an ebook you downloaded using this script, please consider supporting the author by purchasing the book from a legitimate retailer.**