Skip to content

0.1.0

Choose a tag to compare

View all tags
@VitaliiRomanenko VitaliiRomanenko released this 13 Jun 14:15
· 26 commits to main since this release
0.1.0
3cabc18

🎉 PopcornMD v0.1.0 — First Release

We’re excited to announce the very first release of PopcornMD, an Obsidian community plugin that brings your movie collection to life inside your notes.

This initial version focuses on core functionality: searching movies and TV shows via TMDb and generating structured notes directly in Obsidian.

🚀 Features

  • Search by title or IMDb ID — Quickly find any movie or show.

  • Auto-generated notes — Create Obsidian notes pre-filled with metadata (title, year, genres, poster, synopsis, rating, cast, etc.).

  • Customizable templates — Design your own note layout using placeholders.

  • Minimal UI — Clean modal search interface for distraction-free workflow.

⚙️ Installation

From Obsidian Community Plugins (coming soon)

  • Browse for PopcornMD in Obsidian’s Community Plugins list.

Manual (developer preview)

  1. Download the latest release from Releases.

  2. Extract main.js, manifest.json, and styles.css into: <vault>/.obsidian/plugins/popcornmd/

  3. Reload Obsidian and enable the plugin in Settings → Community plugins.

🛠 Getting Started

  1. Obtain a TMDb API key from [themoviedb.org](https://www.themoviedb.org/signup).

  2. Open Settings → Popcorn MD.

  3. Select your template file.

  4. Enter your API key and save.

  5. Run the command “Popcorn MD: Create new movie note” from the palette or click the 🍿 ribbon icon.

  6. Choose a movie by title or IMDb ID.

  7. A new note is generated using your selected template.

📋 Commands

  • Popcorn MD: Create new movie note — Opens the movie search modal.

⚙️ Settings

  • TMDb API Key — Required for API access.

  • Default language — Language for movie data.

  • Template path — Path to your custom template file.

🧩 Template System

PopcornMD uses a flexible template system with placeholders ({{variable}}) to auto-populate metadata fields. Examples include: {{title}}, {{genres}}, {{release_date}}, {{overview}}, {{poster_path}}, and more.

Future versions will expand template configuration options (e.g., storing arrays as links, lists, or comma-separated strings).

🧑‍💻 Development

  • Node.js 18+

  • npm

  • Commands:

    • npm run dev — Development with watch mode

    • npm run build — Production build

    • npm run lint — Linting

📜 License

MIT License.

This plugin is not affiliated with TMDb or Obsidian. You must obtain your own API key from TMDb.

✨ PopcornMD — Because your movie collection deserves better than plain text.

Assets 5
Loading