mirror of https://gh.wpcy.net/https://github.com/bohdanbobrowski/blog2epub.git synced 2026-04-24 02:36:23 +08:00

Convert blog (blogspot.com, wordpress.com...) or any website to epub using GUI, CLI or Python. https://github.com/bohdanbobrowski/blog2epub

blog blogging ebook ebook-downloader ebook-generator ebook-reader epub-generator gui linux linux-desktop macos website-archive windows

Find a file

Bohdan Bobrowski 47665436ae Documentation upd		2024-07-25 11:37:46 +02:00
.github/workflows	repo cleanup	2024-07-20 11:55:47 +02:00
assets	macOS screenshot	2024-07-20 13:06:43 +02:00
blog2epub	feature: cancel download	2024-07-20 11:40:01 +02:00
packages/aur	repo cleanup	2024-07-20 11:55:47 +02:00
.gitignore	blog2epub_kivy.spec	2024-07-18 00:19:48 +02:00
.pylintrc	Pylint upd	2024-02-29 15:48:17 +01:00
android.txt	OSX buildfixes	2023-02-25 11:38:28 +01:00
BACKLOG.md	Backlog	2024-07-22 22:59:33 +02:00
blog2epub.appdata.xml	repo cleanup	2024-07-20 11:55:47 +02:00
blog2epub.desktop	OSX buildfixes	2023-02-25 11:38:28 +01:00
blog2epub_build.py	macOS build preparation	2024-07-20 13:09:47 +02:00
blog2epub_gui_linux.spec	Fixing windows build	2024-07-19 17:21:39 +02:00
blog2epub_gui_macos.spec	Fixing macos builds	2024-07-24 18:22:07 +02:00
blog2epub_gui_windows.spec	macOS build preparation	2024-07-20 13:25:01 +02:00
build_linux.sh	Fixing windows build	2024-07-19 17:21:39 +02:00
buildozer.spec	OSX buildfixes	2023-02-25 11:38:28 +01:00
CHANGELOG.md	v1.3.0	2024-07-20 14:22:02 +02:00
com.bohdanbobrowski.blog2epub.json	OSX buildfixes	2023-02-25 11:38:28 +01:00
index.html	Github Pages	2023-10-30 00:12:11 +01:00
LICENSE	OSX buildfixes	2023-02-25 11:38:28 +01:00
make_macos_dmg.sh	Fixing macos builds	2024-07-24 22:45:40 +02:00
Makefile	Changes in progress	2024-03-25 23:34:44 +01:00
poetry.lock	Trying out venv once again	2024-07-18 09:53:56 +02:00
pyproject.toml	macOS build preparation	2024-07-20 13:10:39 +02:00
README.md	Documentation upd	2024-07-25 11:37:46 +02:00
setup.py	Updating screenshots and documentation	2024-07-19 19:01:03 +02:00

README.md

blog2epub

Convert blog to epub using command line or GUI.

Supported blogs:

*.blogspot.com
*.wordpress.com and some blogs based on WordPress

Main features

command line (CLI) and graphic user interface (GUI)
script downloads all text contents of selected blog to epub file,
if it's possible, it includes post comments,
images are downsized (to maximum 800/600px) and converted to grayscale,
one post = one epub chapter,
chapters are sorted by date ascending,
cover is generated automatically from downloaded images.

Example covers

Installation

Checkout for latest available builds.

Running from sources

git clone git@github.com:bohdanbobrowski/blog2epub.git
cd blog2epub
poetry install
poetry run blog2epubgui

Building own executable

Windows

poetry run build_gui_windows

macOS

poetry run build_gui_macos

And then to create dmg image with app:

./make_macos_dmg.sh

Screenshots of GUI

Windows (11)

Linux (Manjaro Gnome)

macOS (Sonoma 14.4.1)

CLI

poetry run blog2epub [blog url] <parameters>

Parameters

-l/--limit=[x] - limit epub file to x posts
-s/--skip=[x] - skip x latest posts
-q/--images-quality=[0-100] - included images quality (default is 40)
-n/--no-images - don't include images

Examples

poetry run blog2epub starybezpiek.blogspot.com
poetry run blog2epub velosov.blogspot.com -l=10
poetry run blog2epub poznanskiehistorie.blogspot.com -q=100
poetry run blog2epub classicameras.blogspot.com --limit=10 --no-images

Current version

v1.3.0 - 2024-07-20

introduce KivyMD
python poetry instead of venv
code refactor and cleanup
add tabbed layout with list of articles
2 stages: crawl/download & ebook generation
selectable list of articles
feature: prevent epub file overwriting
feature: cancel download
fixed bug: chapters were not added to ebook spine, which caused problems with navigation
Windows and macOS builds