# Obsidian TMDB Cover
Add TMDB cover images and metadata to your Obsidian notes automatically.
## Features
- Fetches movie/TV show cover images from TheMovieDB (TMDB)
- Downloads and resizes images locally to your vault's `attachments/` folder
- Adds runtime and genre tags to note frontmatter
- Processes entire directories in batch mode
- Handles various cover scenarios (missing, color placeholders, external URLs)
## Installation
```bash
pip install obsidian-tmdb-cover
```
## Run without installation
Use `uvx` to run the tool without permanent installation:
```bash
# Run directly with uvx (no installation required)
env TMDB_API_KEY=your_api_key_here uvx obsidian-tmdb-cover /path/to/your/obsidian/vault
```
## Usage
**Bring Your Own API Key** - Get a free API key from [TheMovieDB](https://www.themoviedb.org/settings/api).
```bash
# Set your TMDB API key
export TMDB_API_KEY=your_api_key_here
# Process an Obsidian vault
obsidian-cover /path/to/your/obsidian/vault
# Or run as a module
python -m obsidian_tmdb_cover /path/to/your/obsidian/vault
```
The tool will:
1. Find all `.md` files in the directory
2. Extract titles from frontmatter, H1 headers, or filenames
3. Search TMDB for matching movies/TV shows
4. Download cover images and add metadata to frontmatter
## Example
Before:
```yaml
---
title: The Matrix
---
```
After:
```yaml
---
title: The Matrix
cover: attachments/The Matrix - cover.jpg
runtime: 136
tags: [movie/Action, movie/Science-Fiction]
---
```
## Requirements
- Python 3.8+
- TMDB API key (free)
- Obsidian vault with markdown files
## License
MIT
Raw data
{
"_id": null,
"home_page": null,
"name": "obsidian-tmdb-cover",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": "covers, metadata, movies, obsidian, tmdb, tv",
"author": null,
"author_email": "Your Name <your.email@example.com>",
"download_url": "https://files.pythonhosted.org/packages/e2/e0/09c31a5ff3e2c570348bd1d21ed74a1c533270a48164508e461bab74f153/obsidian_tmdb_cover-0.2.0.tar.gz",
"platform": null,
"description": "# Obsidian TMDB Cover\n\nAdd TMDB cover images and metadata to your Obsidian notes automatically.\n\n## Features\n\n- Fetches movie/TV show cover images from TheMovieDB (TMDB)\n- Downloads and resizes images locally to your vault's `attachments/` folder\n- Adds runtime and genre tags to note frontmatter\n- Processes entire directories in batch mode\n- Handles various cover scenarios (missing, color placeholders, external URLs)\n\n## Installation\n\n```bash\npip install obsidian-tmdb-cover\n```\n\n## Run without installation\n\nUse `uvx` to run the tool without permanent installation:\n\n```bash\n# Run directly with uvx (no installation required)\nenv TMDB_API_KEY=your_api_key_here uvx obsidian-tmdb-cover /path/to/your/obsidian/vault\n```\n\n## Usage\n\n**Bring Your Own API Key** - Get a free API key from [TheMovieDB](https://www.themoviedb.org/settings/api).\n\n```bash\n# Set your TMDB API key\nexport TMDB_API_KEY=your_api_key_here\n\n# Process an Obsidian vault\nobsidian-cover /path/to/your/obsidian/vault\n\n# Or run as a module\npython -m obsidian_tmdb_cover /path/to/your/obsidian/vault\n```\n\nThe tool will:\n\n1. Find all `.md` files in the directory\n2. Extract titles from frontmatter, H1 headers, or filenames\n3. Search TMDB for matching movies/TV shows\n4. Download cover images and add metadata to frontmatter\n\n## Example\n\nBefore:\n\n```yaml\n---\ntitle: The Matrix\n---\n```\n\nAfter:\n\n```yaml\n---\ntitle: The Matrix\ncover: attachments/The Matrix - cover.jpg\nruntime: 136\ntags: [movie/Action, movie/Science-Fiction]\n---\n```\n\n## Requirements\n\n- Python 3.8+\n- TMDB API key (free)\n- Obsidian vault with markdown files\n\n## License\n\nMIT\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Add TMDB cover images to Obsidian notes",
"version": "0.2.0",
"project_urls": {
"Homepage": "https://github.com/yourusername/obsidian-tmdb-cover",
"Issues": "https://github.com/yourusername/obsidian-tmdb-cover/issues",
"Repository": "https://github.com/yourusername/obsidian-tmdb-cover.git"
},
"split_keywords": [
"covers",
" metadata",
" movies",
" obsidian",
" tmdb",
" tv"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "21a7aa26c10d14fe049971a0a1d07a2d3436c8d862920eb53a96b7f547a7715e",
"md5": "fece9e41fe0114434404d10d64c36dce",
"sha256": "48e4d2e7d2de06f725cc5c9125f82ff7d8a8a17471e77188e3e072384f09280d"
},
"downloads": -1,
"filename": "obsidian_tmdb_cover-0.2.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "fece9e41fe0114434404d10d64c36dce",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 10046,
"upload_time": "2025-08-23T22:34:03",
"upload_time_iso_8601": "2025-08-23T22:34:03.113623Z",
"url": "https://files.pythonhosted.org/packages/21/a7/aa26c10d14fe049971a0a1d07a2d3436c8d862920eb53a96b7f547a7715e/obsidian_tmdb_cover-0.2.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "e2e009c31a5ff3e2c570348bd1d21ed74a1c533270a48164508e461bab74f153",
"md5": "5f7a35677c40e89cad1a779c711de19d",
"sha256": "56b50725915c7a20922d165fcf570d746eba40e615661a3d23986fbfe683e78c"
},
"downloads": -1,
"filename": "obsidian_tmdb_cover-0.2.0.tar.gz",
"has_sig": false,
"md5_digest": "5f7a35677c40e89cad1a779c711de19d",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 92249,
"upload_time": "2025-08-23T22:34:05",
"upload_time_iso_8601": "2025-08-23T22:34:05.234713Z",
"url": "https://files.pythonhosted.org/packages/e2/e0/09c31a5ff3e2c570348bd1d21ed74a1c533270a48164508e461bab74f153/obsidian_tmdb_cover-0.2.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-23 22:34:05",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "yourusername",
"github_project": "obsidian-tmdb-cover",
"github_not_found": true,
"lcname": "obsidian-tmdb-cover"
}
JSON
