Hysen Labs
Library / SDK
mmaarij/shelfab avatar
mmaarij

shelfab

An elegant, EPUB library manager with StoryGraph sync, beautiful cover arts, and automatic series grouping.

100 stars0 forksTypeScriptGPL-3.0
01
DEEP OPEN-SOURCE ANALYSIS

Shelfab: an EPUB library manager that syncs StoryGraph

A local first EPUB library manager with StoryGraph sync, web searched cover art, and automatic series grouping. Metadata edits are written back into the files themselves.

02
DEEP OPEN-SOURCE ANALYSIS

Elegant beats clunky

Shelfab is an EPUB library manager built around StoryGraph sync, cover art, and automatic series grouping. The README frames it as modern and local first, aimed at readers who want their StoryGraph library in sync and their metadata handled with less effort. It is positioned against tools it calls powerful but clunky, with a stated goal of feeling native and elegant instead. The word elegant shows up repeatedly in the description, and it is clearly a deliberate part of the identity.

03
DEEP OPEN-SOURCE ANALYSIS

Editing metadata in place

Metadata management edits titles, authors, series info, and descriptions. Shelfab then updates and refactors the EPUB files internally, so the accurate metadata lives in the files themselves and the library stays consistent without manual bookkeeping.

04
DEEP OPEN-SOURCE ANALYSIS

Covers and series

Cover art searches the web for high resolution artwork inside the app, or accepts custom covers. Automatic series grouping pulls series information and groups related books in an animated timeline, which turns a flat library into something organized by hand.

05
DEEP OPEN-SOURCE ANALYSIS

The StoryGraph tie in

StoryGraph integration syncs reading progress and the managed library, and the README calls it the standout integration. It is the feature that gives the tool a reason to exist beyond plain file management. Syncing reading progress ties the library to where you actually are in each book.

06
DEEP OPEN-SOURCE ANALYSIS

The privacy angle

Privacy is stated plainly: the StoryGraph username and library data never leave the machine. Combined with the GPLv3 license, the privacy claim is the project's way of distinguishing itself from hosted library services.

08
DEEP OPEN-SOURCE ANALYSIS

Official sources

09
Community notes

Community notes