Korean Movie Search - Obsidian Plugin

💡 Inspired by Korean Book Search 이 플러그인은 lazerfit님의 Korean Book Search 플러그인에서 영감을 받아 제작되었습니다. This plugin is inspired by Korean Book Search by lazerfit.

한국 영화 정보를 자동으로 가져오는 Obsidian 플러그인입니다. 파일명을 기반으로 KOBIS(영화진흥위원회)와 TMDB API에서 영화 메타데이터를 검색하여 frontmatter를 자동으로 채워줍니다.

An Obsidian plugin that automatically fetches Korean movie information. Based on the filename, it searches KOBIS (Korean Film Council) and TMDB APIs to auto-fill frontmatter with movie metadata.

Features

• 🎬 Automatic Movie Information Fetching: Search by Korean movie title
• 📊 Dual API Integration:
  • KOBIS (Primary): Official Korean Film Council database for authoritative Korean film data
  • TMDB (Secondary): The Movie Database for poster images and ratings
• 🌐 Bilingual Support: Korean and English UI
• ⚙️ Customizable Fields: Toggle optional metadata fields and add custom fields
• 🖼️ Poster Images: High-resolution poster support via TMDB

Setup

1. Get KOBIS API Key (Required)

1. Visit KOBIS Open API
2. Sign up and request an API key
3. Once approved, copy your API key

2. Get TMDB API Key (Optional, for Poster Images)

1. Visit TMDB
2. Create an account
3. Go to Settings → API → Create API Key
4. Copy your API key (v3 auth)

3. Configure Plugin

1. Open Obsidian Settings → Korean Movie Search
2. Enter your KOBIS API key (required)
3. Enter your TMDB API key (optional)
4. Click "Save" for each key

Usage

Basic Usage

1. Create a new markdown file with a Korean movie title as the filename

   • Example: 기생충.md, 올드보이.md, 살인의 추억.md

2. Activate the plugin using one of these methods:

   • Click the 🎬 film icon in the left ribbon
   • Use Command Palette (Ctrl/Cmd + P) → "Update movie frontmatter"

3. The plugin will automatically:

   • Search KOBIS for the movie
   • Fetch detailed metadata
   • Search TMDB for poster image (if API key provided)
   • Update frontmatter with all information
   • Rename file to safe title if needed

Example Result

For a file named 기생충.md, the plugin generates:

---
tags: [드라마, 스릴러, 코미디]
title: 기생충
titleEn: Parasite
director: 봉준호
actors: 송강호, 이선균, 조여정, 최우식, 박소담
genre: 드라마
releaseDate: 2019-05-30
runtime: 131
nation: 한국
company: CJ엔터테인먼트
poster: https://image.tmdb.org/t/p/w500/...
movieCd: 20184889
tmdbId: 496243
myRate: 0
watchStatus: 보고싶음
watchDate: 2026-02-02
---

Configuration

Metadata Fields

Toggle these optional fields in Settings:

• myRate: Personal rating (0-10)
• watchStatus: Watch status (보고싶음/보는중/봤음)
• watchDate: Date watched (auto-set to today)
• tmdbRating: TMDB average rating
• tmdbVotes: TMDB vote count
• overview: Movie plot synopsis

Display Options

• Limit actors: Number of actors to include (1-10, default: 5)
• High-resolution poster: Use w500 instead of w342 for TMDB posters

Custom Fields

Add your own custom frontmatter fields:

• Click "➕ Add" in Custom Frontmatter Fields section
• Enter key-value pairs
• Example: location: CGV 강남, rating: ★★★★★

Development

Build from Source

# Install dependencies
npm install

# Build the plugin
npm run build

# Development mode (auto-rebuild on changes)
npm run dev

Project Structure

korean-movie-search/
├── main.ts              # Main plugin class
├── manifest.json        # Plugin metadata
├── src/
│   ├── movieService.ts  # API integration (KOBIS + TMDB)
│   └── localeService.ts # Localization service
└── locales/
    ├── ko/messages.ts   # Korean translations
    └── en/messages.ts   # English translations

Credits

• Korean Film Council (KOBIS): Movie metadata API
• The Movie Database (TMDB): Poster images and ratings
• Inspired by: korean-book-search by lazerfit

License

MIT License

---

Made with ❤️ for Korean cinema enthusiasts