pyShelf

Lightweight terminal-based ebook server with a web interface

526 stars 35 forks last commit first released GPL-3.0

Slowing down

No commits since 14 Aug 2025. Check the issue tracker before you rely on it.

pyShelf is a lightweight ebook server designed to run without a desktop environment. It scans your library on disk and exposes a simple web interface for browsing, searching, and downloading ebooks.

Key Features

  • Recursive scanning of folders to build a library index
  • Automatic cover image aggregation
  • Fuzzy search with optional query specifiers (for example tag, author, or title)
  • Automated collections based on folder structure
  • Download system for supported ebook files

Use Cases

  • Self-host a personal ebook library on a headless server or homelab
  • Create a simple shared library for a household or small group
  • Quickly search and download ebooks from a large folder-based archive

Limitations and Considerations

  • Supported formats are limited (notably epub and mobi)
  • Several features are explicitly not yet implemented, such as access restrictions and OPDS support

pyShelf is a practical option if you want a minimal, Calibre-like ebook server experience without needing an X server. It focuses on fast library scanning, straightforward browsing, and lightweight operation.

Categories:

Tags:

Tech Stack:

Share:

Similar to pyShelf

Readarr logo

Readarr

Ebook and audiobook library manager with download automation

3.5k
375
Last commit

Self-hosted ebook and audiobook collection manager that automates searches, downloads, upgrades, and library organization via Usenet and BitTorrent clients.

GPL-3.0Slowing down
Alternative to:
Readarr logo
Readarr
BookBounty logo

BookBounty

Finds missing Readarr books by searching Library Genesis

292
14
Last commit

Automates retrieval of missing books tracked by Readarr by searching Library Genesis and downloading matched files into a configured downloads path.

MPL-2.0Actively maintained
Alternative to:
Scribd logo
Scribd
LazyLibrarian logo

LazyLibrarian

Automated ebook and audiobook management for tracked authors

LazyLibrarian tracks authors, fetches book metadata, and automates ebook/audiobook downloads via Usenet or torrents, with Calibre integration and an OPDS catalog.

Activity unknown
Alternative to:
Readarr logo
Readarr
Calibre-Web logo

Calibre-Web

Web interface for browsing, reading, and managing a Calibre eBook library

18.1k
1.8k
Last commit

Self-hosted web app to browse, read, download, and manage eBooks from an existing Calibre library, with OPDS catalogs, user permissions, and device sync options.

GPL-3.0Actively maintained
Alternative to:
BookFusion logo
BookFusion
+4
Directory Lister logo

Directory Lister

PHP web app for browsing and sharing directory contents

2.5k
518
Last commit

Directory Lister is a PHP directory listing app that exposes web-accessible folders for browsing, searching, README display, hash verification, and zip downloads.

MITActively maintained
Alternative to:
FileBrowser logo
FileBrowser
+4
Kapowarr logo

Kapowarr

Comic book library manager and downloader in the *arr ecosystem

1.1k
68
Last commit

Kapowarr builds and manages a digital comic library with metadata, automated searching, downloading, renaming, moving, and optional conversion of issues and collections.

GPL-3.0Actively maintained
Alternative to:
Collectorz CLZ logo
Collectorz CLZ
+2