# EPUBShelf 2.2.3 [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.2.3 **Japanese interface.** EPUBShelf is now available in Portuguese, English and Japanese. The locale is detected automatically from the operating system, with fallback `ja → en → pt`. CJK text uses a self-hosted Noto Sans JP subset, so no Google Fonts CDN is contacted. **Modal close buttons.** The Statistics and About dialogs now show a proper × close button. The previous ✕ glyph was not rendering in the self-hosted Space Grotesk font, which left the buttons blank. **Since 2.0.0:** favorites on the shelf — mark a series, filter the grid to just those, and spot them by a gold star on the cover — and a chapter excerpt in the series view, which previews the opening of volume 01's first chapter, read on demand from inside the EPUB. * * * ## Downloads | File | Platform | Size | | --- | --- | --- | | `EPUBShelf-2.2.3.AppImage` | Linux x86-64 (any distro) | 112.0 MiB | | `epub-shelf_2.2.3_amd64.deb` | Linux amd64 (Debian/Ubuntu) | 78.4 MiB | | `EPUBShelf-Setup-2.2.3.exe` | Windows x64 — installer | 82.9 MiB | | `EPUBShelf-2.2.3.exe` | Windows x64 — portable, no install | 82.7 MiB | | `EPUBShelf-2.2.3-arm64.dmg` | macOS 10.15+ — **Apple silicon only** | 100.5 MiB | | `README.md` | Documentation | 15 KB | **Linux (AppImage):** `chmod +x EPUBShelf-2.2.3.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.2.3.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 Every build in this torrent was submitted to VirusTotal and scanned by 60 or more engines. Four of the five builds were flagged by nothing at all; the macOS `.dmg` received a single machine-learning flag. | File | Engines | Result | | --- | --- | --- | | `EPUBShelf-2.2.3.AppImage` | 63 | clean | | `epub-shelf_2.2.3_amd64.deb` | 61 | clean | | `EPUBShelf-Setup-2.2.3.exe` | 68 | clean | | `EPUBShelf-2.2.3.exe` | 68 | clean | | `EPUBShelf-2.2.3-arm64.dmg` | 60 | 1 ML flag | **The one flag, in context.** Microsoft's engine reports `Trojan:Script/Wacatac.B!ml` — a machine-learning heuristic, not a signature match. The other 59 engines that analysed the file report nothing, and the application code inside the `.dmg` (`app.asar`) is **byte-identical** to the one inside the Linux AppImage, which every engine clears. This is the well-known false-positive pattern for unsigned Electron applications. The reports are public — check them yourself: - [AppImage](https://www.virustotal.com/gui/file/2620985c297b6904147a52f0373e7f1c1a9a59aa986f9c542a38d2be3d419dde) - [.deb](https://www.virustotal.com/gui/file/00f5ab649df38f34056de8ca0ed9bae52eb0fda81a2b4c10a9920950e3f7f0bc) - [Windows installer](https://www.virustotal.com/gui/file/d30c680fcd75a4165ab76113ec3e02de56f25231069d3d72426648fe3d1a1f01) - [Windows portable](https://www.virustotal.com/gui/file/6c9e9965c297b8124f85beffaa50b4deb7505428357a778cc71c7a9d2438581c) - [macOS](https://www.virustotal.com/gui/file/7136335dae82e01402a6a2ab27ebb65383bb89b3196ff701214d36541b884437) ### 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.2.3.AppImage` | `2620985c297b6904147a52f0373e7f1c1a9a59aa986f9c542a38d2be3d419dde` | | `epub-shelf_2.2.3_amd64.deb` | `00f5ab649df38f34056de8ca0ed9bae52eb0fda81a2b4c10a9920950e3f7f0bc` | | `EPUBShelf-Setup-2.2.3.exe` | `d30c680fcd75a4165ab76113ec3e02de56f25231069d3d72426648fe3d1a1f01` | | `EPUBShelf-2.2.3.exe` | `6c9e9965c297b8124f85beffaa50b4deb7505428357a778cc71c7a9d2438581c` | | `EPUBShelf-2.2.3-arm64.dmg` | `7136335dae82e01402a6a2ab27ebb65383bb89b3196ff701214d36541b884437` | ```bash # Linux / macOS sha256sum EPUBShelf-2.2.3.AppImage # Windows (PowerShell) Get-FileHash .\EPUBShelf-Setup-2.2.3.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 - **Favorites** — mark a series, filter the grid to just those, gold star on the cover - **Chapter excerpt** — the opening of volume 01's first chapter, read on demand from inside the EPUB - **Search** — `Ctrl+K` across titles and authors - **Sorting** — by name, reading progress, or last updated - **Multi-language** — Portuguese, English and Japanese, detected from the OS locale - **Dark & light themes** - **Statistics** — library overview, state breakdown, and 30-day activity - **Accessibility** — focus-visible outlines, `prefers-reduced-motion`, ARIA live regions, keyboard navigation 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)._