Skip to content
ObsiKO
English
Get the app

Library & Reading Log ๐Ÿ“š

4 min readUpdated 2026-10-29
On this page

Books you've read, books you're reading, books you bought and haven't cracked open yetโ€ฆ just type the title and ObsiKO pulls the cover, author, page count, and intro right off the internet to fill it in โ€” then gathers every book in your vault into a vertical bookshelf (library). Drag a cover onto the Done shelf and it's marked as finished! ๐Ÿ“–โœจ

โ† Home: ObsiKO 101 ยท Up: Bases (Data Tables)


Fetching book info โ€” just type the title! ๐Ÿ”Ž

Simply set the note's frontmatter type to book, and the magic begins. (Cover and author auto-fill only kicks in with the type key โ€” so make sure it's type! The library list also picks up the Korean key ์ข…๋ฅ˜: book.)

  1. Reading properties fill in all at once โ€” author ยท publisher ยท cover ยท total_pages ยท read_pages ยท rating ยท book_status ยท started_at ยท finished_at.
  2. The Find Sources panel opens on the right right away (the note title / file name is prefilled and searched automatically!). It's a side panel rather than a pop-up covering the screen, so you can keep reading your note while you pick. Pick the book you want andโ€ฆ
  3. The frontmatter fills with the cover ยท author ยท publisher ยท page count, and the body gets ## ๐Ÿ“– Intro ยท ## โœ๏ธ Notes sections laid out (plus ## ๐Ÿ—‚๏ธ Table of Contents when one can be fetched for that book).
  4. On top of that, the document title (file name) is automatically renamed to the book title.

๐ŸŒ Search uses Kakao Book Search (Korean titles) by default, plus Google Books ยท Open Library (international titles). Page counts are enriched from Aladin (a table of contents only comes in when Aladin provides one, so often you'll get just the intro and notes). Korean-title searches (Kakao, Aladin) go through ObsiKO's own server, so they work well even on the web; Google Books and Open Library are fetched by the app directly. Either way, no need to plug in an API key. If you use the app in a language other than Korean and search with words that contain no Hangul (say, The Little Prince), international titles (the original editions) come first and translations follow โ€” with a Korean interface, or a search in Hangul, Korean titles still come first as before.

Book status โœ…

book status (book_status) is a choice property, so you pick one of four values:

๐Ÿ“š To Read ยท ๐Ÿ“– Reading ยท โœ… Done ยท โน๏ธ Dropped

This value doubles as the shelf in the library below and the basis for the dashboard's Currently Reading card.


Library view โ€” your books as a vertical bookshelf ๐Ÿช‘

A dedicated Bases view that gathers every book note in your vault in one place.

  • Creating one: sidebar Newโ€ฆ menu ๐Ÿ“ โ–ธ Library (bookshelf), or search Library in the command palette (โŒ˜P)! It makes a .base file that collects type == "book" notes. (Want the templates in one go too? โ†’ Knowledge Packs ๐Ÿ“ฆ)
  • Front-facing bookshelf (gallery): not the usual sideways kanban, but a vertical shelf showing covers face-on. Shelves are split by book status (To Read ยท Reading ยท Done ยท Dropped), with covers lined up one after another on each.
  • Drag to mark as done ๐Ÿ–๏ธ: grab a cover and drag it onto the Done shelf and that note's book status flips to Done (press-hold on phone/iPad). No right-clicking โ€” just your fingertip!
  • Reading-progress bar ๐Ÿ“Š: under each cover, a thin bar shows how far you've read (read pages รท total pages). Books on the Done shelf fill up as a 100% green bar.
  • A table view too: you can view the same library as a table in the view tabs (status, rating, and pages at a glance).

Dashboard 'Currently Reading' card ๐Ÿ“–

A card on the Dashboard that gathers up the books you're reading right now.

  • Shows Reading books in most-recently-touched order with cover, title, author, and a progress bar โ€” up to 6 of them.
  • Click a title and you zip straight to that book's note.
  • The status dropdown inside the card lets you change status on the spot โ€” switch from 'Reading' to 'Done' and the card drops it and the next book takes its place.
  • By default it's a full-width card, and how many books you see grows and shrinks with the window width. Fold it to half width in edit mode and they line up 2 per row instead.

๐Ÿ’ก This card starts out hidden โ€” click Edit at the top right of the dashboard and bring it back with ๏ผ‹ from the 'Hidden cards' tray (the same for new and existing users).


Try it this way ๐Ÿ’ก

  • Before reading: make a type: book note for a book you want to buy, pull in its cover and intro, and collect them like a wishlist (To Read).
  • While reading: update read pages and the progress bar fills up. Pick up where you left off from the dashboard's Currently Reading card!
  • After finishing: drag the cover onto the Done shelf in the library, and jot your thoughts in the ## โœ๏ธ Notes section.
  • If you're writing a novel yourself, you can preview your manuscript like an e-book with view: book โ†’ E-book & Web Novel Viewer (that's a reading screen, while this library is a reading record โ€” they're different!).

โ† Previous: Project View ยท Home ยท Next: Ledger โ†’