# EPUBShelf 2.0.0 [A light novel library manager]
Organise your EPUB library by series.
A desktop application for managing a large EPUB collection — automatic metadata
extraction, cover art pulled from inside each book, reading progress tracking,
and search. Built for people with more books than shelf space.
---
## What's new in 2.0.0
**Volume cover preview.** Hover a volume thumbnail — or tab to it — and the
full-size cover floats above the list. The thumbnails are 42×63 px, too small to
tell one volume from another; this shows the real artwork without leaving the
page. Each cover keeps its own proportions, and `Esc` dismisses it.
**Bandua Studio branding.** New loading screen, and the About dialog was rebuilt
with the studio identity, social profiles, and support links with
copy-to-clipboard.
---
## Downloads
| File | Platform | Size |
|---|---|---|
| `EPUBShelf-2.0.0.AppImage` | Linux x86-64 (any distro) | 102.2 MiB |
| `epub-shelf_2.0.0_amd64.deb` | Linux amd64 (Debian/Ubuntu) | 71.0 MiB |
| `EPUBShelf-Setup-2.0.0.exe` | Windows x64 — installer | 74.8 MiB |
| `EPUBShelf-2.0.0.exe` | Windows x64 — portable, no install | 74.5 MiB |
| `EPUBShelf-2.0.0-arm64.dmg` | macOS 10.15+ — **Apple silicon only** | 90.8 MiB |
| `README.md` | Documentation | 11 KB |
**Linux (AppImage):** `chmod +x EPUBShelf-2.0.0.AppImage` then run it.
**Note on architecture:** every build is **64-bit**. The Linux builds are
x86-64, the Windows builds are x64, and the macOS build is **arm64 only** — it
will not run on an Intel Mac, and there is no Intel build.
---
## ⚠️ These builds are not code-signed
No code signing certificates are used — they cost more per year than this
project will ever earn. **The applications are safe, but your OS cannot verify
that on its own**, so both Windows and macOS will warn you on first launch.
This is normal for unsigned open-source software, and the warnings are one-time.
### Windows — SmartScreen
On first launch Windows may show **"Windows protected your PC"** with an unknown
publisher.
1. Click **"More info"**
2. Click **"Run anyway"**
Antivirus false positives are also more common with unsigned executables. The
**portable** `EPUBShelf-2.0.0.exe` is the simplest route — it needs no installer
and raises no installer-level warnings.
### macOS — Gatekeeper
The `.dmg` is **arm64 only** and will **not run on Intel Macs**. The app is
unsigned and not notarized, so macOS blocks it with one of:
- *"EPUBShelf cannot be opened because the developer cannot be verified."*
- *"EPUBShelf is damaged and can't be opened."* — misleading; the download is
fine, Gatekeeper simply cannot verify it.
**Fix, no Terminal:**
1. Drag the app to `/Applications`
2. **Right-click** (or Control-click) the app → **Open** → **Open** again
On macOS 15 Sequoia and later: double-click once, then go to
**System Settings → Privacy & Security**, scroll down, and click **"Open
Anyway"**.
**Fix, with Terminal** — clears the quarantine flag:
```bash
xattr -dr com.apple.quarantine "/Applications/EPUBShelf.app"
```
Either way it is a **one-time confirmation per install**; afterwards it launches
by double-click.
---
## ✅ Scanned by 60+ antivirus engines — nothing found
Every build in this torrent was submitted to VirusTotal and scanned by more
than 60 engines. **None of them flagged anything** — zero malicious, zero
suspicious:
| File | Engines | Result |
|---|---|---|
| `EPUBShelf-2.0.0.AppImage` | 63 | clean |
| `epub-shelf_2.0.0_amd64.deb` | 59 | clean |
| `EPUBShelf-Setup-2.0.0.exe` | 67 | clean |
| `EPUBShelf-2.0.0.exe` | 67 | clean |
| `EPUBShelf-2.0.0-arm64.dmg` | 61 | clean |
The reports are public — check them yourself:
- [AppImage](https://www.virustotal.com/gui/file/a6fe9e01ab727fcc4a11318dbc60d25ae51b3ed0cd474e59c89e778e6c15a450)
- [.deb](https://www.virustotal.com/gui/file/4dc72467978498357856d587a8b2dde3f66426c7f22180b001c11d0ed0e69b5c)
- [Windows installer](https://www.virustotal.com/gui/file/1fdb50117f2d8b480db34edddf5ad954a1f4b0cf3a719933de66e0be933686aa)
- [Windows portable](https://www.virustotal.com/gui/file/b0df0fdd0fee2b9f6a9e09ffa650cd21e20d2bfc64d5d09b79d555300fd660a4)
- [macOS](https://www.virustotal.com/gui/file/33f743c782e57e5a026e86b5a58d71764849f4acd65d6d3a9ed7162211039e37)
### Verify the files yourself
A scan is a snapshot; a **checksum** proves the file you downloaded is the one
that was scanned. Compare what you get against these:
| File | SHA-256 |
|---|---|
| `EPUBShelf-2.0.0.AppImage` | `a6fe9e01ab727fcc4a11318dbc60d25ae51b3ed0cd474e59c89e778e6c15a450` |
| `epub-shelf_2.0.0_amd64.deb` | `4dc72467978498357856d587a8b2dde3f66426c7f22180b001c11d0ed0e69b5c` |
| `EPUBShelf-Setup-2.0.0.exe` | `1fdb50117f2d8b480db34edddf5ad954a1f4b0cf3a719933de66e0be933686aa` |
| `EPUBShelf-2.0.0.exe` | `b0df0fdd0fee2b9f6a9e09ffa650cd21e20d2bfc64d5d09b79d555300fd660a4` |
| `EPUBShelf-2.0.0-arm64.dmg` | `33f743c782e57e5a026e86b5a58d71764849f4acd65d6d3a9ed7162211039e37` |
```bash
# Linux / macOS
sha256sum EPUBShelf-2.0.0.AppImage
# Windows (PowerShell)
Get-FileHash .\EPUBShelf-Setup-2.0.0.exe -Algorithm SHA256
```
---
## Features
- **Recursive EPUB scanner** — index an entire folder tree, cached so the second
scan is instant
- **Series detection** — volumes grouped automatically, with covers and metadata
read from inside each EPUB
- **Reading progress** — per-volume read / unread / pending, persisted locally
- **Search** — `Ctrl+K` across titles and authors
- **Sorting** — by name, reading progress, or last updated
- **Dark & light themes**
- **Statistics** — library overview, state breakdown, and 30-day activity
Everything runs on your machine. No account, no cloud, no telemetry.
---
## Screenshots


---
## Links
- **Source & releases:** https://github.com/ribaudequin/epub-library-manager
- **Issues:** https://github.com/ribaudequin/epub-library-manager/issues
- **Licence:** MIT
---
## Support
EPUBShelf is free and open source. If it is useful to you, you can support the
work:
- **Ko-fi:** https://ko-fi.com/A0383T5
- **Patreon:** https://www.patreon.com/banduastudio
**Cryptocurrency** — the ETH address accepts any EVM-compatible chain:
| Coin | Address |
|---|---|
| ETH | `0x466f0c3ee495a3dc851fafa5c4720ab2fdcd4af4` |
| SOL | `Hnw5z47sk1hS6FsnCLfgX8pZhDryQVnZpzWJjSSRV5Nf` |
---
*Built by [Bandua Studio](https://github.com/ribaudequin).*
Comments - 4
Killuaalt
marina84
ribaudequin (uploader)
7521