Popcorn MD

Popcorn-MD is an Obsidian plugin that lets you search for movies and TV shows via TMDb and automatically create beautiful, structured notes from a template — all without leaving Obsidian.

Features

• Search by title or IMDb ID — Find any movie quickly.
• Auto-generated notes — Creates an Obsidian note pre-filled with movie metadata (title, year, genres, poster, synopsis, rating, cast, etc.).
• Customizable templates — Design your own note layout using placeholders.
• Minimal UI — A clean modal search interface for distraction-free workflow.

Installation

From Obsidian Community Plugins (once released)

1. Open Settings → Community plugins.
2. Disable Safe mode.
3. Click Browse and search for "Popcorn-MD".
4. Install and enable the plugin.

Manual (developer preview)

1. Download the latest release from Releases.
2. Extract main.js, manifest.json, and styles.css into <vault>/.obsidian/plugins/popcorn-md/.
3. Reload Obsidian and enable the plugin in Settings → Community plugins.

Getting Started

1. Get a TMDb API key or TMDb Access Token — Sign up at themoviedb.org and request an API key.
2. Open Plugin Settings — Navigate to Settings → Popcorn-MD.
3. Select template — Select file from list
4. Enter your API key or TMDb Access Token — Paste your TMDb API key or TMDb Access Token and click Save.
5. Select default folder - Select folder where you want to store your movie notes.
6. Open the movie search — Use the command palette (Cmd+P / Ctrl+P) and run "Popcorn MD: Create new movie note", or click the 🍿 ribbon icon.
7. Select a movie — Type a title (or IMDb ID starting with tt...) and choose from the results.
8. Note created! — A new note is generated using your selected template.

Commands

Settings

Template System

This template helps you automatically generate .md files with movie metadata.
All variables are placeholders wrapped in double braces {{variable}} and are usually filled from APIs (e.g., TMDb/IMDb).

Note on array fields: The fields genres, origin_country, production_companies, production_countries, and spoken_languages are currently stored as Obsidian links (for example, [[Action]], [[Drama]]). In future versions, you’ll be able to choose how these values are stored — as links, lists, or comma‑separated strings — through template configuration options.

Template Fields

This is a sample template where data is stored as metadata, but you can use these fields in any way you like.

    ---
    adult: "{{adult}}"
    belongs_to_collection: "{{collection}}"
    budget: "{{budget}}"
    genres: "{{genres}}"
    homepage: "{{homepage}}"
    TMDbID: "{{id}}"
    IMDbID: "{{imdb_id}}"
    origin_country: "{{origin_country}}"
    original_language: "{{original_language}}"
    original_title: "{{original_title}}"
    overview: "{{overview}}"
    popularity: "{{popularity}}"
    poster_path: "{{poster_path}}"
    production_companies: "{{production_companies}}"
    production_countries: "{{production_countries}}"
    release_date: "{{release_date}}"
    revenue: "{{revenue}}"
    runtime: "{{runtime}}"
    softcore: "{{softcore}}"
    spoken_languages: "{{spoken_languages}}"
    status: "{{status}}"
    tagline: "{{tagline}}"
    title: "{{title}}"
    vote_average: "{{vote_average}}"
    vote_count: "{{vote_count}}"
    ---

📊 Template Field Reference

How to Create Your Own Template

1. Create a file named Template.md, but you can name it anything you like.
2. Add the required fields using the format {{variable}}.
3. Use an API (TMDb/IMDb) to populate values dynamically.
4. Save the file in your notes system (e.g., Obsidian).

Development

Prerequisites

• Node.js 18+
• npm

Setup

git clone https://github.com/VitaliiRomanenko/popcorn-md
cd popcorn-md
npm install

Build & Watch

npm run dev    # Development with watch mode
npm run build  # Production build

Lint

npm run lint

License

MIT

Contact

For questions, feedback, or contributions, reach out to Vitalii Romanenko at [email protected].

Disclaimer

This plugin is not affiliated with, endorsed by, or sponsored by TMDb or Obsidian. Movie data is provided by The Movie Database (TMDb). You must obtain your own API key from TMDb to use this plugin.

Popcorn-MD — Because your movie collection deserves better than plain text.