Bookshelf Base

by Sébastien Dubois
5
4
3
2
1
Score: 39/100

Description

A community plugin that adds a Bookshelf view type to Obsidian Bases, letting you display notes as a visual bookshelf — with real book covers on realistic shelves.

Reviews

No reviews yet.

Stats

6
stars
2,584
downloads
1
forks
188
days
2
days
2
days
10
total PRs
6
open PRs
3
closed PRs
1
merged PRs
7
total issues
2
open issues
5
closed issues
105
commits

Latest Version

2 days ago

Changelog

1.3.0 (2026-11-18)

Books without a cover image now get a real cover: a hardcover drawn by the plugin, with the title and the author lettered in gold leaf. The aspect ratio also moves in steps of 0.01, and its default is now 2:3, the shape of most printed books.

Heads up: two things look different after the update

  • Books are taller by default. The default aspect ratio changed from 1 (square) to 0.67 (2:3). Views where you never set Aspect ratio now show taller books. Square covers, such as music albums, don't fill a tall book: with Image fit on Contain they get empty space above and below, on Cover their sides are cut off. To keep the square look, open the view options and set Aspect ratio to 1.
  • Default covers replace the colored spine. To keep the old colored block with its vertical title, set Cover without image to Classic spine.

Default covers (#15)

  • Five styles: pick one in Cover without image, in the Cover group of the view options.
    • Cloth hardcover (default): linen texture, a double gold frame, the title in small caps, the author in italics.
    • Leather with label: grained leather, a gold frame with dots in the corners, the title on a dark label.
    • Library binding: plain library cloth, the title in capitals between two gold rules. The easiest one to read on small cards.
    • Mixed: each book gets cloth, leather or library binding, picked from its title. Your shelf looks like an old library.
    • Classic spine: the look of earlier versions.
  • Lettering: Cover lettering sets the foil: gold leaf (default), silver, copper, or blind (pressed into the cover, no foil).
  • Same title, same look: the color (and, with Mixed, the binding) comes from the title, so a book looks the same in every view and after every reload. The colors are dark bookcloth and leather tones, so the lettering stays readable.
  • Author: Author property names the property that holds the author. Leave it empty and Bookshelf tries author, then authors. A list shows the first author plus "et al.", a wikilink shows its display text, and a formula works too.
  • Spines: at an aspect ratio of 0.4 or less, default covers turn into spines, with gold bands at the top and the bottom and the title running up the spine.
  • Dead image links: a cover URL that doesn't load (a 404, a dead host, no network) now gets a default cover. Before, the book showed an empty gray block.
  • Any card size: the cover scales with Card size and Aspect ratio. On small cards the author and the ornaments are dropped, and a long word makes the title smaller instead of breaking in the middle.
  • Screen readers: each cover is labeled "Title by Author".

It's all CSS: no image file, nothing to download. All the options, with screenshots: Default covers.

Aspect ratio in steps of 0.01

The Aspect ratio slider now moves in steps of 0.01 instead of 0.25, still from 0.25 to 2.5. So you can match the real shape of your covers: 0.67 for 2:3 books, 0.71 for A-series and European formats. A missing or invalid value gives 0.67, and a value outside the range is clamped to the nearest limit.


Enjoying this plugin?

README file from

Github

Bookshelf Base

A community plugin that adds a Bookshelf view type to Obsidian Bases, letting you display notes as a visual bookshelf — with real book covers on realistic shelves.

Perfect for tracking books, movies, games, courses, papers, or any collection of notes where a visual, cover-driven layout beats a table or card grid.

Bookshelf view showing book covers on a wooden shelf

Features

  • Bookshelf view for Bases — register a new view type alongside Table, Cards, and Gallery.
  • Cover-driven layout — pick any property containing an image URL or vault path. Supports external URLs, data: URIs, vault-relative paths, bare file names, wikilinks ([[cover.jpg]]), and markdown images. A vault file that cannot be found, or an image URL that does not load, gets a default cover.
  • Default covers — notes without a cover image get a hardcover drawn in CSS, with the title and the author lettered in gold leaf. Pick cloth, leather, library binding, or a mix of the three; silver, copper or blind lettering; or the classic colored spine. The color and the binding come from the title, so each book keeps its look. Set the aspect ratio to 0.4 or less (e.g. 0.25) and they turn into spines.
  • Shelf textures — choose from oak, walnut, cherry, mahogany, pine, ebony, brushed metal, dark metal, white marble, black marble, concrete, and slate.
  • Grouping — respects the Base's groupBy configuration. Each group becomes its own shelf with a header and count.
  • Property display — any property added to the Base's display order appears under each book. Rating properties are highlighted.
  • Wikilink rendering — [[links]] inside displayed properties are clickable and routed through Obsidian's standard link handling.
  • Interactions — click a cover to open the note, Ctrl/Cmd+click to open in a new tab, right-click for a context menu (open, open in new tab, reveal in navigation).
  • Adjustable layout — tune card size, gap between books, and aspect ratio directly from the view's options.
  • Desktop & mobile — no desktop-only APIs.
  • What's new after updates. After a plugin update, a one-time dialog shows the release notes you just received (including skipped versions) with ways to support development. Never shown on fresh installs or regular restarts.

Default covers

No cover image? Bookshelf binds the book for you. Below: mixed bindings next to real covers, then default covers as spines. All the options are in Configuration.

Mixed default covers next to real covers on a wooden shelf

Default covers as spines, at aspect ratio 0.25

Requirements

  • Obsidian 1.4.0 or newer.
  • The Bases feature enabled (core plugin).

Installation

  1. In Obsidian, go to Settings → Community plugins.
  2. Disable Restricted mode if it's enabled.
  3. Select Browse, search for Bookshelf, install it, then enable it.

You can also browse the catalog on the Obsidian Community website.

Manual installation

If the plugin isn't listed in the community catalog yet (or you want a specific version):

  1. Download main.js, manifest.json, and styles.css from the latest release.
  2. Copy them into <Vault>/.obsidian/plugins/bookshelf-base/.
  3. Reload Obsidian and enable Bookshelf in Settings → Community plugins.

BRAT (bleeding edge)

BRAT (Beta Reviewers Auto-update Tool) installs plugins straight from a GitHub repo and keeps them updated automatically. Use this if you want the latest commits — things might break.

  1. Install Obsidian42 - BRAT from Settings → Community plugins → Browse and enable it.
  2. Run BRAT: Add a beta plugin for testing from the command palette.
  3. Paste https://github.com/dsebastien/obsidian-bookshelf.
  4. Select the latest version and confirm.
  5. Enable Bookshelf in Settings → Community plugins.

Quick start

  1. Create or open a Base (.base file).
  2. Add a view and select Bookshelf as its type.
  3. In the view's options, set Image property to the frontmatter property holding your cover images (e.g. cover).
  4. Add any properties you want to show under each book to the view's display order.
  5. Optionally set groupBy on the Base to split books across multiple shelves.

A minimal note that works out of the box:

---
title: The Pragmatic Programmer
author: '[[David Thomas]]'
cover: https://example.com/pragmatic.jpg
rating: 5
---

Documentation

Full documentation lives in docs/ and is published at https://dsebastien.github.io/obsidian-bookshelf.

Development

See DEVELOPMENT.md and CONTRIBUTING.md.

Quick commands:

Command Description
bun install Install dependencies
bun run dev Development build with watch mode
bun run build Production build
bun run tsc:watch Type check in watch mode
bun run lint Run ESLint
bun run format Format with Prettier
bun run test Run tests

License

MIT © Sébastien Dubois

My other Obsidian plugins

Plugin What it does
Agentic Resource Discovery Server Local-first Agentic Resource Discovery publisher and registry that serves your AI skills and tools to agents over a local HTTP and MCP server
Book Exporter Export books (one manifest note + linked chapter notes) to EPUB and PDF via Pandoc
Dataview Serializer Serialize Dataview queries to Markdown, and keep the Markdown representation up to date
Expander Replace variables across your vault using HTML comment markers. Supports static values and dynamic functions
Ghost Publish Publish your vault notes to a Ghost blog with configurable presets for tags, newsletters, and frontmatter conventions
Graph Explorer Base View A custom Bases view that renders notes as an interactive force-directed graph with explored/unexplored tracking
Hidden Folders Access Index hidden root-level folders (e.g. .claude) so they appear in the file tree, metadata cache, and Bases
Journal Bases Custom Base views for journaling and periodic reviews
Kanban Action Planner Render your notes as configurable Kanban boards and calendars inside Bases, with statuses, ordering, relationships, and scheduling
Life Tracker Capture and visualize the data that matters in your life
Note Village A 2D pixel art village where your notes become villagers you can explore and chat with using AI
Obsidian Starter Kit Adds strong typing support and powerful automation support for notes
Remarkable Synchronizer Connect to the reMarkable cloud, list, download, and sync notebook pages as images
Replicate Use AI models with ease via the Replicate.com integration
REST and MCP server Exposes CLI commands as RESTful API endpoints and an MCP server for AI tool integration
Time Machine Browse, compare, and restore previous versions of your notes using built-in file-recovery snapshots
Transcriber Transcribe images to markdown using Ollama vision models
Typefully Publish social media posts with ease using the Typefully integration
Update Time Automatically update front matter to include creation and last update times

Everything I build is documented in my newsletter and on my YouTube channel.

News & support

To stay up to date about this plugin, Obsidian in general, personal knowledge management and note-taking:

If this plugin is useful to you, here are the best ways to support my work ❤️:

Found a bug or have an idea? Open an issue.