Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/bohdanbobrowski/blog2epub

Convert blog (blogspot.com, wordpress.com or another based on Wordpress) to epub using command line or GUI.
https://github.com/bohdanbobrowski/blog2epub

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

Last synced: 2 months ago
JSON representation

Convert blog (blogspot.com, wordpress.com or another based on Wordpress) to epub using command line or GUI.

Host: GitHub
URL: https://github.com/bohdanbobrowski/blog2epub
Owner: bohdanbobrowski
License: mit
Created: 2015-07-13T09:32:23.000Z (over 9 years ago)
Default Branch: master
Last Pushed: 2024-09-10T06:50:00.000Z (3 months ago)
Last Synced: 2024-09-29T15:43:56.064Z (3 months ago)
Topics: blog, blogging, ebook, ebook-downloader, ebook-generator, ebook-reader, epub-generator, gui, linux, linux-desktop, macos, windows
Language: Python
Homepage: https://github.com/bohdanbobrowski/blog2epub
Size: 12.9 MB
Stars: 37
Watchers: 4
Forks: 4
Open Issues: 3
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE

Awesome Lists containing this project

README

        






# blog2epub

[![Maintenance](https://img.shields.io/badge/Maintained%3F-yes-green.svg)](https://github.com/bohdanbobrowski/blog2epub/graphs/commit-activity) [![MIT license](https://img.shields.io/badge/License-MIT-blue.svg)](https://lbesson.mit-license.org/) ![GitHub all releases](https://img.shields.io/github/downloads/bohdanbobrowski/blog2epub/total) ![GitHub release (with filter)](https://img.shields.io/github/v/release/bohdanbobrowski/blog2epub) ![GitHub Release Date - Published_At](https://img.shields.io/github/release-date/bohdanbobrowski/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](https://github.com/bohdanbobrowski/blog2epub/releases).

### Running from sources

    git clone [email protected]: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

    -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](https://github.com/bohdanbobrowski/blog2epub/releases/tag/v1.3.0) - 2024-07-20

- [X] introduce KivyMD

- [X] python poetry instead of venv

- [X] code refactor and cleanup

- [X] add tabbed layout with list of articles

- [X] 2 stages: crawl/download & ebook generation

- [X] selectable list of articles

- [X] feature: prevent epub file overwriting

- [X] feature: cancel download

- [X] fixed bug: chapters were not added to ebook spine, which caused problems with navigation

- [X] Windows and macOS builds

[» Complete Change Log here «](https://github.com/bohdanbobrowski/blog2epub/blob/master/CHANGELOG.md)

## Project backlog

And finally, a list known bugs and future plans for some new functions and enhancements: [BACKLOG.md](https://github.com/bohdanbobrowski/blog2epub/blob/master/BACKLOG.md)