README file from
GithubWhat 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. - A note opens with a header drawn from its properties: the cover, the trailer and the details side by side when the pane is wide, one column on a phone, with your stars and the IMDb, Rotten Tomatoes, RAWG and Metacritic scores on top. It shows what the title is about, in your language when the source or Wikipedia has it, in English otherwise; the text is kept in the note as a folded Description callout. After you switch Obsidian's language, each note gets its description in the new one the next time you open it. A Refresh button looks everything up again, takes the source's current gallery and trailer, and leaves your other edits alone.
- 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.
- Search your library by title, creator or id: results come grouped by category, with covers.
- 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
Logproperty. - A sync button on each category pulls new data from its connected services and sources. The statistics can show an activity grid, a cell per day as on GitHub.
- A Collection category keeps Pokémon, Magic and Yu-Gi-Oh! cards with their set, price and the cards still missing, and coins, banknotes and tokens from Numista with your free Numista key. A book without chapters writes the pages or listening time you got through that day.
- A Certificates category keeps your certificates and badges: paste the link to one into the search and the note gets its name, who issued it, the dates it was issued and expires, its skills and its picture. Credly badges, Claude Academy badges, Google for Education certificates (Exceed LMS), Anthropic Academy certificates and any page that publishes an Open Badge work, no key.
- A
librarycode 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 Shelf view in the settings and the library becomes a room: books stand as spines on a shelf, films, series and games in disc cases, albums in CD cases, comics as paperbacks, videos on floppy disks, certificates framed on the wall and NFTs as holographic cards.
- 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 an ISBN, with or without hyphens, to find that exact edition, with its own cover and page count.
- 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
- In Obsidian open Settings, then Community plugins, search for Library, install and enable it.
- Click the Library icon on the left sidebar and press + in the tab's header.
- 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
- Claude Academy: your completion badges, with their pictures and verification codes, into Certificates; sign in with your email and the code Claude sends
- Google for Education: your certificates, such as Gemini Academy, with their pictures and dates, into Certificates; sign in with Google
Connect more than one account of a service with the add-account button next to it: lists and scores come in from every account, and changes from your notes go back to the first one. 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, EA App, Claude Academy and Google for Education 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.
| Category | Open sources | With a key |
|---|---|---|
| Movies, series | Cinemeta, Wikidata | OMDb, TMDB for season ratings and episode images |
| Books | Open Library | Google Books |
| Games | Steam, Wikidata | RAWG, Twitch (game trailers) |
| Anime, manga | AniList, MyAnimeList, Kitsu | None |
| Comics | Wikidata, AniList | Comic Vine |
| Music | Deezer | None |
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.
- Open Library · Add content · Add to a category · Search your library
- Refresh metadata for current note · Refresh metadata of all notes
- Rebuild graph links · Find & remove duplicates · Share current note
- Import from AniList, MyAnimeList or Kitsu · Push and pull progress for each
- Import Steam library · Import PlayStation games and trophies · Import Nintendo games · Import Epic Games library · Import EA App library
- Import from Trakt · Build library map
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.
| Hosts | Use | Data sent |
|---|---|---|
www.omdbapi.com, m.media-amazon.com |
Movie search with a key, posters | Title or IMDb id, key |
v3-cinemeta.strem.io, images.metahub.space, episodes.metahub.space |
Movies, series, stills, air dates | Title or IMDb id, genre |
v3.sg.media-imdb.com, m.media-amazon.com |
Movie and series search and posters, with IMDb connected | Title |
api.themoviedb.org, image.tmdb.org |
Movie and series details, with a key | IMDb id, key |
www.wikidata.org, en.wikipedia.org, commons.wikimedia.org, upload.wikimedia.org |
Search, Rotten Tomatoes, trailers, covers, matching Netflix titles, awards of albums, titles and people, photos on a person's canvas | Search text, ids, Netflix ids, album title and artist |
<your language>.wikipedia.org |
A title's description in the language Obsidian is set to | The article's title |
openlibrary.org, covers.openlibrary.org |
Books, chapters, covers | Title, author, ISBN, genres |
api.tcgdex.net, assets.tcgdex.net, api.scryfall.com, cards.scryfall.io, db.ygoprodeck.com, images.ygoprodeck.com |
Collection: Pokémon, Magic and Yu-Gi-Oh! cards, their sets and prices, no key | Card name, set |
api.numista.com, en.numista.com |
Collection: coins, banknotes and tokens, with your Numista key | Search text, Numista ID, key |
www.credly.com, images.credly.com |
Certificates: a Credly badge's Open Badges record and picture | The badge's ID |
academy.claude.com, claude.ai |
Certificates: a Claude Academy badge checked by its code; the Claude Academy connector signs in on the academy's page and reads your badges in a hidden window | The badge's code; sign-in |
edu.exceedlms.com and other *.exceedlms.com |
Certificates: a Google for Education (Gemini Academy) or other Exceed LMS award page, read and photographed for its picture; the Google for Education connector signs in with Google and reads your Credentials list in a hidden window | The award's link; sign-in |
verify.skilljar.com, cc.sj-cdn.net |
Certificates: an Anthropic Academy certificate's page and picture | The certificate's link |
| The certificate page you paste | Certificates: its Open Badge or share tags | The link |
api.audible.com, itunes.apple.com, books.apple.com, is1-ssl.mzstatic.com to is5-ssl.mzstatic.com, librivox.org, archive.org |
Audiobook search, length, covers, chapters | Title and author |
www.googleapis.com, books.google.com |
Book search with a key, covers | Title, key |
api.rawg.io, media.rawg.io |
Games, with a key | Title or id, genre, key |
store.steampowered.com, steamcommunity.com, api.steampowered.com, cdn.cloudflare.steamstatic.com, video.akamai.steamstatic.com, shared.akamai.steamstatic.com, shared.fastly.steamstatic.com |
Games, trailers, Steam import, achievements | Title or app id; sign-in, library and achievements on import |
api.graphql.imdb.com |
The current IMDb score of every film and series, no key | IMDb ID |
www.imdb.com, api.graphql.imdb.com |
IMDb connector | Sign-in; ratings and watchlist are read, scores and new titles are sent, removals of deleted notes |
www.netflix.com |
Netflix connector | Sign-in; viewing activity and thumbs are read, scores are sent as thumbs; unticked or deleted titles are hidden from the history, unstarted series go to My List |
accounts.google.com, www.youtube.com |
YouTube connector | Sign-in; the watch history is read (the last 7 days, then one older month a day) with each video's length and watched share; per video, its description, publish date, your like and whether you're subscribed; the like and subscribe buttons in a note send them back |
returnyoutubedislikeapi.com |
YouTube connector: like and estimated dislike counts, as YouTube shows no dislikes | Video id |
eth.blockscout.com, optimism.blockscout.com, base.blockscout.com, arbitrum.blockscout.com, polygon.blockscout.com, gnosis.blockscout.com, celo.blockscout.com, zksync.blockscout.com, scroll.blockscout.com, explorer.inkonchain.com, soneium.blockscout.com, unichain.blockscout.com, explorer.mode.network, arbitrum-nova.blockscout.com, shapescan.xyz, robinhoodchain.blockscout.com, tonapi.io, api-mainnet.magiceden.dev, api.nearblocks.io, api.fastnear.com, rpc.mainnet.near.org |
NFT connector | Your wallet addresses |
api.etherscan.io, bsc-dataseed.binance.org, rpc.mainnet.taiko.xyz |
NFT connector on BNB Chain, Polygon and Taiko, with an Etherscan key | Wallet address, key; token contract and id |
api.opensea.io |
NFT collection links (site, socials); with an API key also the creator's profile, covers and token pictures | Contract address and token id; key if set |
ethereum-rpc.publicnode.com, mainnet.optimism.io, mainnet.base.org, arb1.arbitrum.io, polygon-bor-rpc.publicnode.com, rpc.gnosischain.com, rpc.mainnet.chain.robinhood.com |
NFT pictures the explorer lacks | Token contract and id |
bscscan.com, polygonscan.com, taikoscan.io token and address pages, cdn*.assetquay.com |
Explorer's cached NFT picture, who created a contract | Token contract and id |
bnb.nftscan.com token pages and the image hosts they show (i.seadn.io, cdn-2.galxe.com) |
BNB NFT pictures whose own servers are gone | Token contract and id |
api.routescan.io, api.avax.network, rpc.blast.io, rpc.mantle.xyz, mainnet.boba.network, rpc.hemi.network, rpc.chiliz.com |
NFT connector on Avalanche, Blast, Mantle, Boba, Hemi and Chiliz | Wallet address; token contract and id |
api.tzkt.io |
NFT connector on Tezos | Wallet address |
ipfs2.seadn.io, ipfs.filebase.io, cloudflare-ipfs.com, gateway.pinata.cloud, ipfs.io, dweb.link, arweave.net, and the hosts a token's metadata names |
NFT images and metadata | Token id or file path |
tonviewer.com, solscan.io, bscscan.com, taikoscan.io, nearblocks.io, tzkt.io, www.audible.com, snowtrace.io, blastexplorer.io, mantlescan.xyz, bobascan.com, explorer.hemi.xyz, chiliscan.com |
Links in NFT notes, opened only when you click them | Nothing until you click |
api.trakt.tv, auth.trakt.tv |
Trakt connector | Sign-in code; history, ratings and watchlist are read, scores, watched and unwatched episodes, watchlist titles and removals of deleted notes are sent |
id.twitch.tv, api.igdb.com |
Game trailers, with Twitch keys | Twitch id and secret, game |
api.deezer.com, cdn-images.dzcdn.net |
Music search, covers, tracks, similar albums | Album or artist |
graphql.anilist.co, anilist.co, s4.anilist.co, streaming services' image hosts |
Anime, manga, air dates, sync | Title or ids; token, progress, status, score |
myanimelist.net, api.myanimelist.net, api-cdn.myanimelist.net |
Anime and manga search, sign-in, import, sync | Search text; token, progress, status, score |
kitsu.io, kitsu.app |
Anime search, sign-in, import, sync | Search text; token, progress, status, score |
ca.account.sony.com, my.account.sony.com, m.np.playstation.com, web.np.playstation.com, image.api.playstation.com, psnobj.prod.dl.playstation.net |
PlayStation sign-in, games, trophies, covers | Token |
accounts.nintendo.com, api.accounts.nintendo.com, api-lp1.znc.srv.nintendo.net, atum-img-lp1.cdn.nintendo.net |
Nintendo sign-in, play activity, covers | Session token |
www.epicgames.com, account-public-service-prod03.ol.epicgames.com, library-service.live.use1a.on.epicgames.com, catalog-public-service-prod06.ol.epicgames.com, store.epicgames.com |
Epic Games sign-in and library import | Token |
accounts.ea.com, www.ea.com, gateway.ea.com, service-aggregation-layer.juno.ea.com |
EA App sign-in and library import | Token |
nxapi-auth.fancy.org.uk, nxapi-znca-api.fancy.org.uk |
Signing service for Nintendo requests | Nintendo Account id token, account id, the app's requests and answers |
comicvine.gamespot.com |
Comic search, with a key | Title, key |
www.youtube.com, www.youtube-nocookie.com, i.ytimg.com, player.vimeo.com, www.dailymotion.com |
Trailers | Video id |
twitter.com, t.me, wa.me, www.reddit.com, www.facebook.com, www.linkedin.com, vk.com, bsky.app, www.pinterest.com |
Share buttons | Caption with title, score and link; the image stays local |
specs.openid.net only names the OpenID fields in the Steam sign-in request; nothing is sent to it.
Support
Questions go to Discussions, bugs and ideas to Issues. Released under the MIT License.
| Network | Address |
|---|---|
| EVM | 0xf9B4807E107f6f8Db79D86aCef6072A31d570201 |
| Sui | 0x1d6989810ee7e55d43f65398253b02462b921e9ce8ad626b542929f02c3d3e9a |
| Sol | 2jmrmQrLVeUDFgHzSkHvHKBrmRJXes5X8h3GHXxrLaX6 |
| BTC | bc1q4pdlj35uev8r0rgncpmn999n3jvj472pppds6r |
| TON | UQCphscY14j0AiRY1lGPciQjd9_XcRbUDyPLDxG4O1unEpgM |
| Tron | TYhmDLfx7aGHL1ikmNN3t72oGB3DjBjydR |