Insurgently

Obsidian plugin· Active · beta · not yet released

Books & Shelves

Shelves across Obsidian, Calibre and Audible, as an Obsidian plugin over the shelf engine.

Beta. Books & Shelves is not released yet. These pages describe the build in progress.

Packs

Add fields and rules for a kind of library, with a built-in pack or one of your own.

A pack adds fields and rules for a kind of library: extra properties copied from Calibre, wording added to summaries, folders for groups of shelves.

The built-in pack

Buddhism is built in and off until you turn it on, on the Packs tab. It:

  • copies #tradition, #text_type, #composed and #translators from Calibre into book notes;
  • files names that end in a title, such as Rinpoche or Lama, whole;
  • adds tradition-aware wording to summaries and shelf names.

Write your own

  1. On the Packs tab, check the Packs folder. The default is Books/Packs.
  2. Add a folder there with a pack.yml file in it.
  3. Run Books & Shelves: Reload packs. Packs also load when Obsidian starts.
name: My library
fields:                    # copied from Calibre columns into book notes (filled when empty)
  - name: genre
    from: "#genre"
    list: true
prompts:                   # text added to a task's instructions
  books.summarize: "Mention the book's setting."
groups:                    # shelf notes go into a group folder by words in their name and genre
  - name: Story
    match: "fiction|tales|poem"
note:
  frontmatter:             # given to new book notes
    sticker: "lucide//book-open"
  banner_from_cover: true  # also set `banner` to the cover
reading:                   # an older status field to read when reading_status is empty
  field: status
  map: { unread: want to read, read: read }

A pack with a mistake is named in a notice and left out.

Related