Library

Your movies, series, anime and manga, books and audiobooks, games, comics, music, YouTube videos and NFTs as plain Markdown notes,
shown as a gallery of covers. Search a title, pick it, and the note fills itself in.

Install · Wiki · Report a bug

What it does

• One note per title. The cover, year, genres, creators, cast, ratings and trailer sit in its properties (frontmatter), where Bases, Dataview and other plugins can read them. Set your own rating with five stars: each half star is one point out of 10, written to My Rating; click the same rating again to clear it.
• Episode and chapter lists sit at the top of the note. Tick them off as you go, rate them, and see when the next episode airs. A book's chapter list can be edited with the pencil, and each chapter's notes button opens a section with its name in the note body for quotes and thoughts.
• The Library tab has a section per kind of media, with filters, sorting by rating, date or progress, an "Up next" shelf and a "Soon" list with the air dates of new episodes. In Settings > Categories, move the Soon list and Up next shelf between categories by dragging, or with arrows on phones; the Library tab follows that order. Searching a book also finds its audiobooks from Audible, Apple Books, LibriVox and the Internet Archive, no key needed, and their listening time counts in the statistics. A book note marks its format (paper, ebook, audiobook) with buttons under the title, saved to Format, and the Books filter can show one format.
• Statistics count your titles and the hours of watching or reading they took, list your top directors, developers and channels, and put the time in perspective: "in that time you could have watched every Bond film". Your taste shows how your scores compare with other viewers and your favourite genres and decade, next to your latest diary entries.
• Ticking an episode or a chapter, or marking a title complete, writes the day into the note's Log property.
• A library code block puts cards in any note, picked by category, genre, year or score, or shows what you are in the middle of, the Soon list or the statistics.
• One command draws your library as a canvas, with posters grouped around the actors and creators they share, and each category has its own, grouped by creator, actor and genre.
• Turn on "Keep covers in the vault" and covers go to a Covers folder, so the library looks the same without internet.
• Genres, creators and actors are links. Open Horror and a canvas shows the covers of every horror title in your library, by category.
• Searching a book also finds its audiobooks, with their length. Listening time counts in the statistics.
• Paste a wallet address and its NFTs arrive as notes, from 33 networks, with no key: pictures, dates, transactions and the project's links. Details in the wiki.
• Works on desktop and mobile, in every Obsidian language.

Getting started

1. In Obsidian open Settings, then Community plugins, search for Library, install and enable it.
2. Click the Library icon on the left sidebar and press + in the tab's header.
3. Pick a kind, search, choose a result. Each kind gets its own category and folder, created with its first title.

Same name, different films? Add the year: dune 1984.

Connect and sync

Connect an account in the plugin settings. Your lists arrive as notes, and anime progress and scores stay in sync.

• AniList: anime and manga lists, progress and scores; changes go back with the Push command
• MyAnimeList: anime and manga lists, progress and scores; changes go back on save
• Kitsu: anime list, progress and ratings; changes go back on save
• IMDb: ratings, episode ratings and watchlist; scores and new watchlist titles go back
• Netflix: viewing history and thumbs, anime into the anime category; scores go back as thumbs, unticked episodes leave the history, and series you haven't started go to My List
• YouTube: one note per video, in the Video category, with the time you spent, rewatches, publish date, views, likes and estimated dislikes, and the description; like, dislike and subscribe from the note; the last 7 days first, then one older month a day back to the start of the history; Shorts are left out
• Trakt: watch history, ratings and watchlist; scores, ticked and unticked episodes and new watchlist titles go back
• PlayStation: played games, playtime and trophies
• Steam: library, playtime and achievements
• Nintendo Switch: played games and playtime
• Epic Games: library and store links
• EA App: library and playtime from your sessions

Imports run once a day on desktop. Your own scores are never overwritten, and progress never moves backwards. IMDb, Netflix, YouTube, PlayStation, Steam, Nintendo, Epic Games and EA App work on desktop only. Trakt also signs in and sends changes from mobile. When you delete a note, the plugin asks whether to remove the title from the connected sites too.

Sources

Each category searches open sources. An API key adds richer data, and its service is tried first.

Anime and manga notes take English, romaji or original names, as you choose in the settings. Titles marked adult stay out of search until you turn them on.

Anything that doesn't fit goes into a Manual category with your own fields. More in the wiki: sources and keys, frontmatter, anime sync.

A note from the library looks like this:

---
Type: Series
Name: Stranger Things
Year: 2016
Rating IMDB: 8.7
My Rating: 9
Cover: https://images.metahub.space/poster/medium/tt4574334/img
Progress: 8/42
Date: 01.03.2026
Source: omdb
Source ID: tt4574334
---

Progress: 8/42 means 8 of 42 episodes watched. Genre, creator and cast are written as links to their canvases when Settings > General > Links for the graph is on; when it is off, they stay plain names in every library note. Refreshing a note fills in empty fields and updates ratings from the source. It never overwrites your own rating or progress.

Privacy

Your library is plain notes and opens offline. The plugin only goes online to search, refresh, sync or share, and never more often than once every 5 minutes for the same note. No telemetry, no self-update. Each API key is sent only to its own service, and sign-ins happen on the service's own page, so the plugin only ever stores the token.

Nintendo accepts requests only from its own app, so they pass through a third-party signing service (nxapi-znca-api). The plugin asks before you sign in.

Support

Questions go to Discussions, bugs and ideas to Issues. Released under the MIT License.