A CLI and GUI tool to convert a book on https://shamela.ws to an EPUB book.
Project description
shamela2epub
A CLI and GUI tool to download a book on https://shamela.ws into an EPUB book.
Disclaimer:
- This software is freeware and open source and is only intended for personal or educational use.
Installation
From PyPI
pip install shamela2epub
From the cloned repository
# Using poetry
poetry install
# or using pip 18+
pip install .
Usage
Command-line Tool (CLI)
python3 -m shamela2epub download URL
# python3 -m shamela2epub download "https://shamela.ws/book/823"
python3 -m shamela2epub download --help
Usage: python -m shamela2epub download [OPTIONS] URL
Download Shamela book form URL to ePub
Options:
-o, --output TEXT ePub output book custom name
--help Show this message and exit.
Graphical User Interface (GUI)
- If you installed the package from PyPI, you can use the following command:
shamela2epubgui
- If you downloaded the latest gui exe file from releases you can open it normally and use it.
- Otherwise, use normal python command:
python3 -m shamela2epub gui
Features
- CLI and GUI!
- Creates an EPUB3 RTL standard book.
- Automatically adds a page for book information.
- Automatically generated table of contents with support for nested chapters.
- Automatically adds book part and page number to each page's footer.
- Sanitizes the book HTML from unnecessary elements and classes.
- Converts inline CSS color styles to CSS classes.
Known Issues
- Books that have a last nested section with level deeper (e.g. 3) than its next section (e.g. 2) and both have the same
page number (e.g.
page_017.xhtml
) cannot be converted to KFX unless that last nested section is removed.
TODO
Next
- You tell me :)
Maybe
- Fix TOC conversion problem when last nested section with level deeper than its next has the same page number by removing it from the TOC
Acknowledgments
- GUI icons are made by the amazing Phosphor Icons (books - duotone -
#AB8B64
).
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
shamela2epub-1.0.1.tar.gz
(120.4 kB
view hashes)
Built Distribution
shamela2epub-1.0.1-py3-none-any.whl
(123.9 kB
view hashes)
Close
Hashes for shamela2epub-1.0.1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | b8c6971e1d41438112adf87062573b2d8182720bd7107ed4081ea9dcf030b8d2 |
|
MD5 | 54177891b1d2d92b2e5a9585c4f5c55b |
|
BLAKE2b-256 | 603a40f42fe7e5b63e7c9c60fa759af957525681b3d6ebea9a7b9c26df32175d |