obsidian-douban  by Wanxp

Obsidian plugin for enriching notes with Douban media data

Created 3 years ago
253 stars

Top 99.3% on SourcePulse

GitHubView on GitHub
Project Summary

<2-3 sentences summarising what the project addresses and solves, the target audience, and the benefit.> This Obsidian plugin integrates data from Douban, a Chinese media platform, into Markdown notes. It targets Obsidian users who want to catalog personal media consumption (movies, books, music, games) with details like ratings and reviews. The plugin streamlines building a personal media knowledge base within Obsidian, enabling features like personalized timelines.

How It Works

<2-4 sentences on core approach / design (key algorithms, models, data flow, or architectural choices) and why this approach is advantageous or novel.> The plugin allows searching Douban items within Obsidian and importing selected data. It supports importing titles, scores, cover images (local/remote hosting), publication details, genres, and user-specific information (ratings, comments, tags). It can sync personal consumption records and offers customization for note templates and storage paths, enhancing Obsidian workflow integration.

Quick Start & Requirements

  • Primary install / run command (pip, Docker, binary, etc.).
  • Non-default prerequisites and dependencies (GPU, CUDA >= 12, Python 3.12, large dataset, API keys, OS, hardware, etc.).
  • Estimated setup time or resource footprint.
  • If they are present, include links to official quick-start, docs, demo, or other relevant pages.

Install via the Obsidian Plugin Center by searching "obsidian-douban." Manual installation involves placing release files (main.js, manifest.json, styles.css) in /.obsidian/plugins/obsidian-douban/. No end-user prerequisites are listed; development requires Node.js/npm. Links to specific docs/demos are mentioned but not provided.

Highlighted Details

  • Comprehensive import/sync for movies, TV shows, books, music, games, and diaries.
  • Preserves detailed user data: ratings, comments, tags, collection dates.
  • Supports local or custom image hosting for cover art.
  • Customizable import templates and note paths.
  • Potential integration with plugins like Timeline for visualizations.

Maintenance & Community

  • Notable contributors, sponsorships, partnerships, deprecations, migrations, or other health signals if notable.
  • Links to Discord/Slack, social handles, roadmap, etc.

The project encourages community involvement via GitHub issues for bugs and features. A community channel is mentioned without a direct link. Developer support is available via donations.

Licensing & Compatibility

  • License type and notable restrictions (GPL -> copyleft, SSPL, etc.).
  • Compatibility notes for commercial use or closed-source linking.

The README does not explicitly state the software license, requiring clarification for commercial use or integration. The plugin is designed for Obsidian.

Limitations & Caveats

<1-3 sentences on caveats: unsupported platforms, missing features, alpha status, known bugs, breaking changes, bus factor, deprecation, etc. Avoid vague non-statements and judgments.> Users should back up data; syncing with "Replace same name document" can overwrite notes. The plugin is for personal learning/research, not commercial use, with the author disclaiming liability. AI analysis features are under development.

Health Check
Last Commit

1 week ago

Responsiveness

Inactive

Pull Requests (30d)
1
Issues (30d)
3
Star History
4 stars in the last 30 days

Explore Similar Projects

Feedback? Help us improve.