Back to browse
GitHub Repository

A small python app with web UI to download an entire substack to ePub format for reading offline (kindle etc)

3 starsPython

Download entire/partial Substack to ePub for offline reading

by locusofself·Mar 20, 2026·3 points·0 comments

AI Analysis

●●SolidCozySolve My Problem

Downloads paywalled Substack posts to Kindle-ready EPUB when Readwise costs $8/month.

Strengths
  • Session cookie caching avoids repeated logins across downloads
  • Kindle-optimized grayscale JPEG conversion for Paperwhite screens
  • Both CLI and Web UI with real-time progress tracking
Weaknesses
  • Substack-only scope limits broader ebook download use cases
  • Author admits 'vibe coded' with Claude—early-stage quality
Category
Target Audience

Substack readers, Kindle users

Similar To

Readwise Reader · Instapaper · web2epub

Post Description

Hi HN,

This is a small python app with optional webUI. It is intended to be run locally. It can be run with Docker (cookie autodetection will not work).

It allows you to download a single substack, either entirely or partially, and saves the output to an epub file, which can be easily transferred to Kindle or other reading devices.

This is admittedly a "vibe coded" app made with Claude Code and a few hours of iterating, but I've already found it very useful for myself.

It supports both free and paywalled posts (if you are a paid subscriber to that creator).

You can order the entries in the epub by popularity, newest first, or oldest first, and also limit to a specific number of entries, if you don't want all of them.

You can either provide your substack.sid cookie manually, or you can have it be autodetected from most browsers/operating systems.

Similar Projects

Productivity●●Solid

CrossX – iOS/macOS App to Convert web/X articles to ePub for e-reader

Sends cleaned EPUBs straight to an Xteink over its Wi‑Fi hotspot using on‑device parsing, a Safari share extension, and automatic mDNS detection for stock and CrossPoint firmware. Nice local-first stance — no cloud or accounts — and it even bundles a file manager and activity history. Parsing images and batch conversion are called out as next steps; those would make this useful beyond its already-specific audience.

Niche GemShip It
pompeii
223mo ago