Ebook Library
swekizer2k downloadsA beautiful, central library for the books, manga, magazines and documents in your vault - browse covers, tag and organize, and track reading progress.
- Overview
- Scorecard
- Updates8
Turn the files in your Obsidian vault into a beautiful, personal reading library.
Ebook Library gives your books, manga, magazines, articles, comics, PDFs, and documents a polished cover-based home inside Obsidian. Organize everything in one place, see what you are reading, and open any title with a click.
Why you'll love it
- A beautiful library view - Browse your collection in a responsive cover grid inspired by modern reading apps.
- Keep your files where they are - Catalog files already in your vault without moving, copying, or modifying them.
- Know what to read next - A dedicated Continue Reading section brings your latest reading title to the front.
- Organize your way - Add categories, tags, descriptions, ratings, covers, and reading statuses to every title.
- Find anything quickly - Search by title, author, description, or tag, then filter by category, tag, or reading status.
- Works with any reading collection - Catalog PDFs, EPUBs, Markdown notes, CBZ/CBR comics, Word documents, plain text files, and more.
- Looks at home in Obsidian - Designed to work with light mode, dark mode, and community themes.
Features
Your collection, beautifully presented
Add a cover from your vault or use an image URL. If a book does not have a cover, Ebook Library creates an attractive gradient placeholder with a category icon, so your library never looks unfinished.
Each card shows the information you care about at a glance:
- Title and author
- Category and tags
- Reading or completed status
- Recently opened information
Simple organization
Give each title the context it deserves with:
- Categories such as Book, Manga, Magazine, Comic, Document, Article, Audiobook, and Other
- Tags with suggestions from your existing library
- Descriptions and ratings
- Unread, Reading, and Completed statuses
- Optional total page counts
Fast browsing
Use the library toolbar to:
- Search across your entire collection
- Filter by category or tag
- Switch between All, Unread, Reading, and Completed
- Sort by title, author, date added, recently opened, or reading progress
- Choose a compact, comfortable, or spacious card size
Open and manage your books
Click a cover to open the file in Obsidian. For formats Obsidian cannot display, you can open the file in your operating system's default application. The card menu also lets you edit details, update reading status, reveal files on desktop, or remove an entry without deleting the original file.
Safe and portable
Ebook Library stores its catalog metadata in Obsidian's normal plugin data. Your book files are not changed, and cover files are referenced rather than duplicated. If you move a cataloged book or cover inside your vault, the library updates its reference automatically.
You can also export your library metadata as a JSON backup from the plugin settings.
Installation
From the Obsidian Community Plugins store
- Open Settings in Obsidian.
- Go to Community plugins and make sure community plugins are enabled.
- Select Browse.
- Search for Ebook Library.
- Select Install, then Enable.
Once enabled, open the library from the library icon in the ribbon or from the command palette.
Manual installation
Download the latest release files:
main.js,manifest.json, andstyles.css.Create this folder in your vault:
<your-vault>/.obsidian/plugins/ebook-library/Copy the three downloaded files into that folder.
In Obsidian, open Settings → Community plugins.
Choose Reload plugins, then enable Ebook Library.
Getting started
- Open Ebook Library from the ribbon icon or the command palette.
- Select + Add Book.
- Choose a file from your vault.
- Add a title, author, cover, category, tags, and reading status.
- Select Add to library.
After that, click any cover to open it, or use the search and filters to explore your collection.
Settings
Open Settings → Ebook Library to:
- Rename your library
- Change the card size
- Open the library automatically when Obsidian starts
- Export a JSON backup of your library
- Clear the catalog when you want to start over
Clearing the catalog removes entries from Ebook Library only. It does not delete the underlying files from your vault.
Privacy and data
Ebook Library is designed to work with the files already in your vault. Book metadata is saved in the plugin's local data.json file. The plugin does not upload your library or modify your book files.
External cover URLs are only used when you choose to add a cover from a URL.
Building from source
This section is for contributors and developers. Regular users do not need to build the plugin.
npm install
npm run build
Use npm run dev to rebuild while developing.
Feedback and feature requests
If you find a bug or have an idea that would make your reading library better, please open an issue in the repository:
https://github.com/swekizer/Ebook-Library/issues
Roadmap
Ideas being considered for future versions include:
- Automatic reading-progress tracking for PDFs
- Drag-and-drop adding
- Collections or shelves
- Cover lookup by ISBN or title