Shelfmark
Shelfmark is a self-hosted web interface for searching and downloading books and audiobooks from multiple sources in one place.
Platform availability
Available on 4 of 10 platforms
- Unraid
- TrueNAS
- Umbrel (not listed)
- ZimaOS (not listed)
- Proxmox
- Helm (not listed)
- Mac (not listed)
- Windows (not listed)
- Linux (not listed)
- Any server
Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.
71/100 Good
- Maintained
- 100last commit 7 days ago
- Popular
- 724,155 GitHub stars
- Easy to install
- 654 install platforms, install notes, Docker image
- Light to run
- No data
- Security check
- 201 serious finding, 8 minor, CI, tests
Based on 4 of 5 factors.
Security check: 1 serious finding
- Uses certifi 2026.7.22, which has a known critical vulnerability (PyPI)
Automated checks on commit 10710ab, 20 Oct 2026. Not an audit.
Availability: platform listings confirmed today, links checked 2 days ago
- GitHub stars
- 4,155
- Open issues
- 61
- Last commit
- 2026-11-13
- Latest release
- v1.7.0
- License
- MIT
- Activity
- steady
Checked 6 days ago - source: GitHub (calibrain/shelfmark)
Resources & Compatibility
Requirements not published yet.
Checked 54 days ago - source: Docker Hub image tags and published docs
First-install notes
- Start Shelfmark with Docker Compose After downloading the compose file, run `docker compose up -d` (the command that starts the app's containers in the background). If you skip it, Shelfmark won't be running when you try to open it. source
- Initial setup After startup, add your own sources, metadata providers, and download clients; optional multi-user accounts let others browse and request books. source
Fetched 45 days ago - each note links to its source
Variants
Alternatives
No alternatives collected yet.
Common questions
How can I extend Shelfmark beyond its built-in search and request workflow?
You can bring your own sources, metadata providers, and download clients. This lets Shelfmark search and request books and audiobooks across multiple sources.
What should I do if Shelfmark is not running after setup?
Run docker compose up -d after downloading the compose file. If this step is skipped, Shelfmark won't be running when you try to open it.
What common problems does Shelfmark troubleshooting cover?
It covers container startup problems, permission errors, network connectivity issues, and Cloudflare bypass failures.
How can I contribute to Shelfmark development?
Contribute to Shelfmark development by creating an account on GitHub.
Answers sourced from deepwiki.com, github.com, github.com, github.com
Community
- Reddit (reddit)
Collected 49 days ago - public community threads