Lorebase

approved

by Murch1k

Lorebase is a media library built into Obsidian for games, anime, movies, TV shows, books, and manga. Cards, metadata, ratings, progress, and statistics are stored locally in Markdown - This plugin has not been manually reviewed by Obsidian staff.

โ˜… 63 starsโ†“ 3,117 downloadsUpdated 1mo agoMIT

0f0c7f0d-2240-405f-b9a7-ad54ef83c324

Obsidian Plugin Version License TypeScript

๐ŸŽฎ Lorebase

Your personal media library inside Obsidian
Track, organize, and explore your collections โ€” all stored as local Markdown files


โœจ What is Lorebase?

Lorebase transforms your Obsidian vault into a full-featured media tracker. Catalog your games, anime, movies, TV shows, books, and manga with card views, rich metadata, progress tracking, and collection statistics โ€” all while keeping your data portable and private as plain Markdown files.

๐Ÿ”’ Privacy-first โ€” No accounts, no cloud sync, no telemetry. Your data never leaves your vault.


๐Ÿ“ธ Showcase

๐ŸŽฎ Game Library โ€” Grid View

Browse your game collection with customizable card grids, status badges, and hover overlays

๐Ÿ“บ Anime Library

Track anime with season/episode progress, format badges (TV, Movie, OVA), and status tracking

๐ŸŽฌ Film Library

Browse your movie collection with posters, ratings, and status tracking

๐Ÿ“บ TV Shows Library

Track shows with season/episode progress and an active-part tracker

๐Ÿ“– Book Library

Organize your reading list with page progress, authors, and ratings

๐Ÿ“š Manga Library

Track manga with chapter and volume progress

โœ๏ธ Edit Modal

Game Edit Modal

Game editor with status, rating, tags, progress, and metadata fields.


Anime Edit Modal

Anime editor with title parts, season progress, episode tracking, and metadata fields.


Film Edit Modal

Film editor with status, rating, genres, and metadata fields.


TV Show Edit Modal

TV show editor with season progress, episode tracking, and active-part fields.


Book Edit Modal

Book editor with author, page progress, and metadata fields.


Manga Edit Modal

Manga editor with chapter and volume progress, and metadata fields.

๐Ÿ“Š Statistics Dashboard

Visualize your collection with status distribution, rating charts, and key metrics

โš™๏ธ Settings
Settings 1Settings 2Settings 3
Settings 4Settings 5Settings 6
Settings 7Settings 8Settings 9

Deeply customizable settings, now organized in tabs or an accordion layout, with accent colors, card sizes, badge positions, integrations, templates, and more.


๐Ÿš€ Features

๐Ÿ“š Six Libraries

Lorebase now covers six independent libraries, each with its own statuses, fields, and progress tracking.

GamesAnimeMovies ๐Ÿ†•TV Shows ๐Ÿ†•Books ๐Ÿ†•Manga ๐Ÿ†•
StatusesNot Started, Playing, Completed, Dropped, Sandbox, Wishlist ๐Ÿ†•Planned, Watching, Completed, Dropped, PausedPlanned, Watching, Completed, Dropped, PausedPlanned, Watching, Completed, Dropped, PausedPlanned, Reading, Completed, Dropped, PausedPlanned, Reading, Completed, Dropped, Paused
Unique fieldsGame series, HowLongToBeat time, developer, publisherFormat (TV/Movie/OVA/ONA/Special), studios, active partRuntime, director, actors, optional movie partsRuntime, director, actors, seasons, active season/partAuthors, publisher, pages, chaptersAuthors, artists, chapters, volumes, active part
ProgressMain ยท Main+Sides ยท PerfectionistSeason S2/4 ยท Episode EP 12/24Optional movie partsSeason & episode, plus an active-part tracker for shows split into cours/partsPages and chapters read / totalChapters and volumes read / total

Each library gets its own folder path, card layout, badges, and note template in settings, exactly like Games and Anime did before.


๐Ÿงพ Manual Card Creation

Not every item exists in a metadata provider โ€” now you can add a card by hand, filling in the title, poster, and details yourself, without going through a search.


๐Ÿ“ฅ Import Existing Notes ๐Ÿ†•

Bring notes you already have into your library. Lorebase automatically detects the media type, lets you map fields, and shows a preview of the changes before anything is written.


๐Ÿ”— Related Media

Link local notes together โ€” connect a game to its sequel, a book to its manga adaptation, or a movie to the series it belongs to, directly from within Lorebase.


๐Ÿƒ Card Views

Vertical Cards Horizontal Cards
Vertical Cards
Classic poster layout with a 2:3 aspect ratio.
Perfect for game covers, anime posters, and book/manga covers.
Horizontal Cards
Landscape mode with panoramic banners.
Great for cinematic screenshots and movie/TV banners.
  • 3 preset sizes: Small ยท Medium ยท Large
  • Custom dimensions: Fine-tune width, height, and image ratio
  • Adaptive grid: Automatically calculates column count based on viewport
  • Virtualized rendering: Smooth scrolling for 100+ items
  • Horizontal cover support in templates: note templates can define horizontal/banner posters out of the box

๐Ÿท๏ธ Badges & Overlays

BadgeDescriptionOptions
StatusCurrent tracking status with iconText + Icon or Icon-only mode
RatingPersonal 1โ€“5 scoreโญ Star mode or ๐Ÿ˜ Emoji mode
FavoriteHeart indicatorStatic or pulsating animation
ProgressSeason/episode, page, chapter, or volume progress depending on media typee.g. S 2/4 ยท EP 12/24 ยท Ch 45/120

All badges have customizable positions (X/Y percentage), independently configurable per library, and can be placed anywhere on the card.

Hover overlay reveals title, year, format, and description โ€” visibility of each element is configurable.


๐Ÿ” Smart Toolbar

ControlDescription
๐Ÿ”Ž SearchReal-time search with 150ms debounce
๐Ÿท๏ธ FiltersBy status, favorite, 18+, custom poster, plus advanced filters over system and custom YAML fields, lists, numbers, and dates ๐Ÿ†•
โ†•๏ธ SortBy name, year, rating, or completion date
๐Ÿ—‚๏ธ Saved views ๐Ÿ†•Your own sort/group/filter presets saved per media type
๐Ÿท๏ธ TagsPlan tags, custom tags, and genres
โž• AddCreate new items via metadata integrations or manually
๐ŸŽฒ RandomPick a random item from your collection
๐Ÿ–ผ๏ธ View ModeToggle between vertical and horizontal

๐Ÿ“Š Collection Statistics

A beautiful dashboard modal with:

  • Key metrics: Total items, completed count, average rating, favorites
  • Status distribution: Bar charts with percentages
  • Rating distribution: Emoji-based visualization (๐Ÿ˜๐Ÿ˜Š๐Ÿ˜๐Ÿ˜•๐Ÿคข)
  • Additional info: Series count, custom posters, completion % โ€” with per-media-type breakdowns covering movies, TV shows, books, and manga

โœ๏ธ Cinematic Editor

A three-column modal editor inspired by modern CMS design:

๐Ÿ“ท Left Column๐Ÿ“ Center Column๐Ÿ“‹ Right Column
Poster preview
Favorite / 18+ toggles
Plan tags
Title & year
Series
Genre chips
Status (segmented control)
Rating (5 stars)
Description editor
HowLongToBeat / reading progress
Advanced fields
Custom tags
Timestamps

Editors now share a unified field layout, tabs, a pinned save bar, and common metadata panels across all six libraries. A dedicated My Notes section lets you edit your personal text without touching the note's structure, and start/completion dates get their own pickers โ€” auto-set when an item is marked completed, and shown right on the card.

Keyboard shortcuts: Ctrl+Enter to save ยท Escape to close


๐ŸŒธ Visual Effects

EffectDescription
๐ŸŒธ SakuraGently falling cherry blossom petals
โ„๏ธ SnowSoft snowflakes drifting down

Adjustable intensity from 20 to 150 particles with realistic sway, rotation, and random delays.


๐Ÿ”— Integrations

Lorebase can automatically fetch metadata when creating new entries โ€” or you can skip providers entirely and add a card manually. Existing cards can also be linked to a metadata source after the fact, letting you switch providers or safely refresh their data, including community ratings (score and vote count) or a manual refresh.

Game Providers

ProviderDescriptionRequirements
Search Steam Store for gamesNone
Import your Steam library and wishlist directlySteam profile URL
Fallback source for high-quality vertical Steam coversFree API key
Largest video game databaseFree API key
Internet Game Database โ€” alternative metadata sourceFree API key
Game completion timesNone

Anime & Manga Providers

ProviderDescriptionRequirements
Comprehensive anime databaseNone
Russian anime platformNone
MyAnimeList metadata through the Jikan APINone
๐Ÿ†•Primary manga search provider, replacing Jikan for mangaNone
Manga database and metadata sourceNone

Movie & TV Providers

ProviderDescriptionRequirements
Movies and TV shows, posters and metadataFree API key
TV show schedules and metadataNone
Movie and TV metadata via IMDb dataFree API key

Book Providers

ProviderDescriptionRequirements
Book tracking and metadataFree API key
Large book metadata databaseOptional API key

๐Ÿงช Experimental: download a poster from any URL straight to local storage instead of linking it remotely.


๐Ÿ“ฆ Installation

Community Plugin

  1. Open Settings โ†’ Community plugins
  2. Search for Lorebase
  3. Install and enable the plugin

Manual Installation

  1. Download the latest release from GitHub Releases

  2. Copy these files into your vault's plugin folder:

    <Vault>/.obsidian/plugins/lorebase/
    โ”œโ”€โ”€ main.js
    โ”œโ”€โ”€ manifest.json
    โ””โ”€โ”€ styles.css
    
  3. Restart Obsidian or reload plugins

  4. Open Settings โ†’ Community plugins and enable Lorebase

Build from Source

# Install dependencies
npm install

# Build the plugin
npm run build

# Run tests
npm test

# Type checking
npm run typecheck

๐ŸŽฏ Getting Started

  1. Open Lorebase โ€” Click the Lorebase icon in the ribbon, or use the command palette (Ctrl+P โ†’ "Lorebase")
  2. Choose your library โ€” Switch between Games, Anime, Movies, TV Shows, Books, and Manga tabs
  3. Add your first item โ€” Click the โž• button to search via configured providers, or create a card manually
  4. Review & create โ€” Select a result, review the metadata, and create a note
  5. Edit details โ€” Right-click any card to edit status, rating, tags, and more

Quick Actions via Context Menu

Right-click any card to:

  • ๐ŸŽฏ Change status instantly
  • โญ Set rating
  • โค๏ธ Toggle favorite
  • โœ๏ธ Open full editor
  • ๐Ÿ—‘๏ธ Delete item

โš™๏ธ Settings

General

SettingDescriptionOptions
LanguageInterface languageEnglish, Russian, Ukrainian
Accent ColorTheme accent10 presets + custom hex
Particle EffectAmbient particlesNone, Sakura, Snow
Particle IntensityNumber of particles20โ€“150
Settings LayoutHow settings sections are displayedTabs or Accordion

Library Settings (per media type)

Available independently for Games, Anime, Movies, TV Shows, Books, and Manga.

SettingDescription
Folder PathVault folder for this library
Card SizeSmall / Medium / Large
Card OrientationVertical or Horizontal
Custom DimensionsFine-tune card width, height, ratio
ColumnsGrid column count

Card Appearance

  • Overlay text: Position and visibility of title, year, format, description
  • Badges: Position, mode, and style for status, rating, and favorite
  • Description lines: Number of visible lines in hover overlay (1โ€“70)
  • Progress badges: Season/episode, page, chapter, or volume progress, depending on media type
  • Card style: Hover overlay or progress-footer cards where supported
  • Book cover effect: Hardcover-style cards for books and manga
  • Completion date format ๐Ÿ†•: Choose how completion dates are displayed on cards

Integrations

  • Toggle each provider on/off
  • Enter API keys where required (RAWG, IGDB, SteamGridDB, TMDB, OMDb, Hardcover) or recommended (Google Books)
  • Select default provider per media type
  • Link an existing card to a metadata source, switch providers, or safely refresh its data without losing your own edits ๐Ÿ†•
  • Configure note templates per media type (simple field list or advanced YAML), including dedicated templates for movies, TV shows, books, and manga

Diagnostics ๐Ÿ†•

  • Request log: Review requests, errors, retries, and temporary provider rate-limit blocks
  • Steam Sync progress: A dedicated progress window with pause, resume, cancel, and detailed processing results

๐Ÿ“ Data Format

Every library item is a Markdown file with YAML frontmatter. You can edit them directly or through the Lorebase UI.

Lorebase stores progress fields in snake_case. For books and manga, the UI may display the watching status as Reading, but the saved status value remains watching.

๐ŸŽฎ Game Example
---
name: "The Witcher 3: Wild Hunt"
poster: "https://example.com/game-cover.jpg"
poster_b: "https://example.com/game-banner.jpg"
gameSeries: "The Witcher"
genres:
  - "RPG"
  - "Action"
plot: "You play as Geralt of Rivia, a monster hunter..."
platforms: "PC, PS4, Xbox One, Nintendo Switch"
year: "2015"
released: "2015-05-19"
developers:
  - "CD Projekt Red"
publishers:
  - "CD Projekt"
rating: "4"
userRating: 5
status: "completed"
favorite: true
url: "https://store.steampowered.com/app/292030"
main: "51 hours"
main_plus_sides: "103 hours"
perfectionist: "173 hours"
---

## My Notes

Amazing open-world RPG with incredible storytelling...
๐Ÿ“บ Anime Example
---
title: "Attack on Titan"
image: "https://example.com/anime-cover.jpg"
image_b: "https://example.com/anime-banner.jpg"
plot: "In a world where humanity lives within enormous walled cities..."
scoreImdb: "84"
tags: "action, drama, fantasy"
year: "2013"
studios: "Wit Studio, MAPPA"
format: "tv"
season_current: "4"
episode_current: "87"
episode_total: "87"
active_part_id: "season-4"
anime_parts:
  - id: "season-4"
    kind: "tv"
    title: "Season 4"
    season: 4
    episode_current: 87
    episode_total: 87
    status: "completed"
rating: "5"
status: "completed"
favorite: true
url: "https://anilist.co/anime/16498"
---

## My Notes

One of the greatest anime of all time...
๐ŸŽฌ Movie Example
---
type: "movie"
title: "Blade Runner 2049"
poster: "https://example.com/movie-poster.jpg"
poster_b: "https://example.com/movie-banner.jpg"
plot: "A young blade runner uncovers a secret that could destabilize society..."
genres: "Sci-Fi, Drama"
year: "2017"
released: "2017-10-06"
runtime: "164 min"
director: "Denis Villeneuve"
actors: "Ryan Gosling, Harrison Ford, Ana de Armas"
rating: "5"
status: "completed"
favorite: true
active_part_id: ""
movie_parts: []
integration_provider: "tmdb"
integration_id: "335984"
url: "https://www.themoviedb.org/movie/335984"
---

## My Notes

A slow, visual sci-fi sequel with a strong atmosphere...
๐Ÿ“บ TV Show Example
---
type: "series"
title: "The Boys"
poster: "https://example.com/series-poster.jpg"
poster_b: "https://example.com/series-banner.jpg"
plot: "A group of vigilantes takes on corrupt superheroes..."
genres: "Action, Drama, Superhero"
year: "2019"
released: "2019-07-26"
runtime: "60 min"
director: ""
actors: "Karl Urban, Jack Quaid, Antony Starr"
seasons: "4"
episode_current: "39"
episode_total: "40"
active_part_id: "season-4"
series_parts:
  - id: "season-4"
    kind: "season"
    title: "Season 4"
    season: 4
    episode_current: 7
    episode_total: 8
    status: "watching"
rating: "4"
status: "watching"
favorite: false
integration_provider: "tmdb"
integration_id: "76479"
url: "https://www.themoviedb.org/tv/76479"
---

## My Notes

Season tracking works through series_parts and active_part_id...
๐Ÿ“– Book Example
---
type: "book"
title: "Dune"
poster: "https://example.com/dune-cover.jpg"
poster_b: "https://example.com/dune-banner.jpg"
plot: "A story of politics, religion, and power on the desert planet Arrakis..."
authors: "Frank Herbert"
publisher: "Chilton Books"
genres: "Sci-Fi"
tags: "classic, space opera"
year: "1965"
released: "1965-08-01"
page_current: "210"
page_total: "412"
chapter_current: "8"
chapter_total: "22"
rating: "5"
status: "watching"
favorite: true
integration_provider: "googlebooks"
integration_id: "example"
url: "https://www.google.com/books/edition/Dune/example"
---

## My Notes

A dense but rewarding classic...
๐Ÿ“š Manga Example
---
type: "manga"
title: "Berserk"
poster: "https://example.com/berserk-cover.jpg"
poster_b: "https://example.com/berserk-banner.jpg"
plot: "Guts, a lone mercenary, fights against demonic forces..."
authors: "Kentaro Miura"
artists: "Kentaro Miura"
genres: "Dark Fantasy, Action"
tags: "seinen, tragedy"
year: "1989"
chapter_current: "364"
chapter_total: "379"
volume_current: "41"
volume_total: "42"
active_part_id: "volume-41"
manga_parts:
  - id: "volume-41"
    kind: "volume"
    title: "Volume 41"
    volume: 41
    chapter_current: 364
    chapter_total: 379
    status: "watching"
rating: "5"
status: "watching"
favorite: true
integration_provider: "mangadex"
integration_id: "example"
url: "https://mangadex.org/title/example"
---

## My Notes

One of the most influential dark fantasy manga...

โšก Performance

Lorebase is optimized for large collections:

  • Virtualized rendering โ€” Only visible cards are in the DOM
  • Batch card rendering โ€” 24 cards per animation frame
  • O(1) file lookups โ€” Map-based index for instant access
  • Debounced search โ€” Search input updates are throttled
  • RAF-based scroll rendering โ€” Virtual grid updates are aligned with animation frames
  • SVG template caching โ€” Icons use cloneNode instead of innerHTML
  • ResizeObserver โ€” Adaptive layout without polling
  • Reworked virtual grid ๐Ÿ†• โ€” Improved scroll restoration and rendering for large libraries

๐ŸŒ Localization

LanguageStatus
๐Ÿ‡ฌ๐Ÿ‡ง Englishโœ… Full
๐Ÿ‡ท๐Ÿ‡บ Russianโœ… Full
๐Ÿ‡บ๐Ÿ‡ฆ Ukrainian๐Ÿงช Beta

All core UI elements, status labels, settings descriptions, and error messages are translated, including all media types and providers.


๐Ÿ“‹ Changelog

v3.0.1

โš ๏ธ Mobile UI is in active development. The reworked mobile interface for the library, add, and edit flows is an early alpha โ€” expect rough edges while it's polished over the next few releases.

Added

  • ๐Ÿ“ฅ Import existing notes โ€” bring notes into your library with automatic media-type detection, field mapping, and a preview of the changes
  • ๐Ÿ”— Metadata sources for existing cards โ€” link a card to a provider, switch providers, and safely refresh its data
  • โญ Community ratings โ€” score, vote count, and a manual refresh of provider data
  • ๐Ÿงฉ Extended progress โ€” seasons, episodes, volumes, chapters, DLC, active parts, and quick actions right from the card
  • ๐Ÿ“ "My Notes" section โ€” edit your personal text without touching the note's structure
  • ๐Ÿ”— Related media โ€” create links between games, anime, movies, TV shows, books, and manga
  • ๐Ÿ“… Start and completion dates โ€” convenient date pickers, auto-set on completion, and the date shown on the card
  • ๐Ÿ—‚๏ธ Saved library views โ€” your own sort/group/filter presets for each media type
  • ๐ŸŽ›๏ธ Advanced filters โ€” filter on system and custom YAML fields, lists, numbers, and dates
  • ๐Ÿ–ฑ๏ธ Card click action โ€” open the note or jump straight into editing
  • ๐Ÿฉบ Request diagnostics โ€” a log of requests, errors, retries, and temporary provider rate-limit blocks
  • โฏ๏ธ Steam Sync controls โ€” a progress window with pause, resume, cancel, and detailed processing results
  • ๐Ÿ”Ž MangaUpdates โ€” new primary manga search provider, replacing Jikan for manga

Improved

  • ๐Ÿ“ฑ Reworked mobile interface for the library, add, and edit flows across all media types (early alpha โ€” still a lot of work ahead)
  • โœ๏ธ Editors now share a unified field layout, tabs, a pinned save bar, and common metadata panels
  • ๐Ÿ•น๏ธ Steam Sync got a faster preview, earlier duplicate detection, and improved library/wishlist loading
  • ๐ŸŒ Improved providers and fallback sources for games, anime, movies, TV shows, books, and manga
  • ๐Ÿ“„ Improved templates and frontmatter generation: arrays, numbers, dates, field order, and consistent naming
  • ๐Ÿ›ก๏ธ Added safe request throttling, retries, and protection against 403 and 429 errors
  • ๐Ÿ–ผ๏ธ Improved handling of local images, remote posters, and custom covers
  • ๐ŸŽจ Expanded appearance settings for cards, completion date format, and library effects
  • ๐Ÿงฑ Reworked the virtual grid, scroll restoration, and rendering for large libraries

Fixed

  • Improved handling of provider 403 and 429 errors: added safe pauses, retries, and protection against excessive requests
  • Plans and tags now write to notes correctly, including values with spaces
  • Fixed metadata-source recording and detection when adding cards from mobile
  • Fixed major mobile UI issues: overlapping panels, duplicate close button, status display, and editor behavior
  • Fixed DLC loading, vertical Steam cover selection, and SteamGridDB fallback
  • Fixed metadata updates wiping personal progress, custom fields, and manually edited values
  • Improved stability of search, import, Steam Sync, and external provider requests
v2.0.6

Added

  • ๐ŸŽฌ New media types โ€” Movies, TV Shows, Books, and Manga are now fully supported as standalone libraries
  • ๐Ÿ”Ž New metadata providers โ€” TMDB, TVmaze, OMDb, Hardcover, Google Books, Jikan, and MangaDex
  • ๐Ÿงพ Manual card creation โ€” add media without searching through a provider
  • ๐Ÿ–ผ๏ธ SteamGridDB โ€” fallback source for high-quality vertical Steam covers
  • ๐Ÿ“š Reading progress โ€” pages, chapters, volumes, and manga progress tracking
  • ๐Ÿ“บ Show progress โ€” seasons, episodes, and an active-part tracker for shows
  • ๐Ÿ”— Related media โ€” link local notes to each other
  • ๐ŸŽ›๏ธ New per-media settings โ€” dedicated folders, templates, badges, and appearance for each media type
  • ๐Ÿƒ Card style modes โ€” choose between hover overlay cards and progress-footer cards where supported
  • ๐Ÿ“˜ Book cover effect โ€” optional hardcover-style cards for books and manga
  • ๐Ÿ‡บ๐Ÿ‡ฆ Ukrainian localization โ€” new beta interface language
  • โญ Wishlist status for games
  • ๐Ÿงฉ New templates โ€” dedicated note templates for movies, TV shows, books, and manga

Improved

  • Fully reworked plugin settings
  • Added a tabbed or accordion layout mode for settings
  • Added folder suggestions for library paths and image storage paths
  • Added per-media preview controls for card appearance settings
  • Improved library cards and progress display
  • Updated editor modals
  • Improved manual creation with cover URL/file support and media-specific fields
  • Improved genre and tag editing in modals
  • Improved handling of genres, tags, ratings, and statuses
  • Improved Steam Sync and Steam image matching
  • Improved handling of local and remote posters
  • Improved Russian and English localization
  • Expanded statistics to cover all new media types

Stabilized during 2.0.6 development

  • Removed the obsolete Coming Soon / In development settings section
  • Fixed book add flow using the wrong cover or metadata after selecting a search result
  • Fixed manga add flow resetting selection when searching for another title
  • Book and manga hover overlays have stronger background readability
  • Book and manga card text sizing is more readable
  • Anime and TV progress-footer cards keep the same hover behavior as books and manga
  • Manga hover cards now lift consistently in hover mode
  • Anime virtual-grid progress footers no longer overlap the next row
  • Anime and TV season/part chips now use status colors consistently
  • README data format examples now match the current snake_case frontmatter fields
v1.1.0

Added

  • ๐Ÿ”„ Steam Sync โ€” import your Steam library and wishlist directly
  • IGDB provider for game metadata
  • ๐Ÿค– Anime Title Parts auto-fill
  • ๐Ÿ–ผ๏ธ Horizontal cover support in templates
  • ๐Ÿงช Experimental: poster download from URL to local storage

Improved

  • Small redesign of the add window
  • HowLongToBeat integration

Fixed

  • Support buttons in settings
  • Dropdown formatting under description
  • Removed unnecessary media providers block

๐Ÿ“„ License

MIT ยฉ Murch1k


Built with โค๏ธ for Obsidian
Your media library stays local, clear, and fully under your control

For plugin developers

Search results and similarity scores are powered by semantic analysis of your plugin's README. If your plugin isn't appearing for searches you'd expect, try updating your README to clearly describe your plugin's purpose, features, and use cases.