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

• for Windows and macOS users: available builds
• python3 setup.py install

Running froum sources

git clone git@github.com:bohdanbobrowski/blog2epub.git
cd blog2epub
python -m venv venv
source ./venv/bin/activate
pip install -r ./requirements.txt
./blog2epubgui.py

Screenshots of GUI

Windows 10

macOS

Linux

Mint 21.2 Cinnamon

CLI

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

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

Planned features and known bugs

• code needs some refactor: classes are too "nested" within each other
• there are some bugs in wordpress.com crawler
• Linux app/package(s)
• Android app
• more crawlers (ex. GitHub Pages 🙃)
• improve existing crawlers (allow)
• improve GUI - configuration, allow to save in selected place etc.

Release notes

v1.2.5

• utilize GitHub Pages for this project documentation
• save url textfield history and allow easily choose from these urls
• change font from Lato (nice but large files) to much smaller (Alegreya and Martian Mono for UI)
• make program window not resizable
• add popup similar to about dialog after finished ebook generation

v1.2.4

• article loop fix (crawler was reading by default from atomfeed, and returning maximum 25 articles)
• refactor, as usual
• url history saved into yaml file

v1.2.3

• Windows and macOS (unsigned) builds
• fixed encoding error in month name
• some minor refactors and fixes

v1.2.2

• Empty images list bug
• Fixing macOS build (works on my machine - Ventura 13.3.1)
• Improving macOS build - dmg now contains Applications folder shortcut to ease installation

v1.2.1

• Kivy threading fix
• skip parameter fix
• Linux build (now I'm working on adding package to various linux package repositories)

v1.2.0

• migration to Kivy :-)
• some bugfixes in crawler
• wordpress.com support!

v1.1.0

• migration to Gtk (for better support on multiple platforms)
• requirements cleanup
• about dialog
• macOS dmg installer included

v1.0.5

• gzip html in cache folder
• atom feed parsing
• better system notifications, also under linux

v1.0.4

• improved saving GUI settings
• system notification on finished download

v1.0.3

• saving GUI settings to yaml file
• first macOS builds (pyinstaller)