AnimeList

AnimeList is a local-first Obsidian plugin for tracking anime, manga, and novels in ordinary Markdown files. It provides a native library, metadata search, local covers, progress tracking, ratings, templates, a Score Dashboard, and a completion timeline.

Your Markdown notes remain the source of truth. Removing the plugin does not remove your records, notes, or images.

Library
Score Dashboard	Timeline

[!NOTE] What's new in 1.2.1

• Fixed manga and novel serial-entry date layout and standardized date input behavior.
• Prevented newly added chapter, season, or volume rows from causing scroll jumps.
• Fixed the serial-cover modal method binding warning without changing modal behavior.
• Corrected list-mode cover sizing and kept cover status text on one line.

Features

• One Markdown-based library for anime, manga, and novels.
• Metadata search through Bangumi, AniList, and Open Library.
• Card, list, and poster views with search, filters, and sorting.
• Media-specific progress tracking and dated serial entries with optional per-entry covers.
• A Score Dashboard for direct and batch rating changes.
• Favorite mode or reusable Masterpiece categories.
• A pannable and zoomable completion timeline.
• Local series and serial-entry covers with remote-image fallback.
• Desktop and mobile support without a Dataview dependency.

Installation

Community plugins

1. Open Settings → Community plugins in Obsidian.
2. Select Browse and search for AnimeList.
3. Install and enable the plugin.

Manual installation

1. Download main.js, manifest.json, and styles.css from the matching GitHub release.
2. Copy them into <vault>/.obsidian/plugins/animelist/.
3. Reload Obsidian and enable AnimeList under Community plugins.

Quick start

1. Open AnimeList from the ribbon or run AnimeList: Open library from the command palette.
2. Select 收錄, choose anime, manga, or novel, and search for a title.
3. Review the imported metadata and save the note.
4. Update its status, progress, dates, rating, or special label from the library.

The interface uses Traditional Chinese. Provider metadata may remain in its original language.

Documentation

See the User Guide for status rules, progress units, serial-entry covers, search, Masterpiece categories, the Score Dashboard, the timeline, Markdown data, and templates.

Metadata and privacy

• Search terms are sent only to enabled metadata providers.
• Personal ratings, progress, dates, labels, and note content stay in the vault.
• Covers are stored locally when available, with remote-image fallback.

Development

Requirements: Node.js 18 or newer and npm.

npm ci
npm run check

For a production bundle:

npm run build

See CONTRIBUTING.md, the manual test checklist, CHANGELOG.md, and ROADMAP.md for project details.

License

MIT