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
pip install obsidian-tmdb-cover
Run without installation
Use uvx to run the tool without permanent installation:
# 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.
# 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:
- Find all
.mdfiles in the directory - Extract titles from frontmatter, H1 headers, or filenames
- Search TMDB for matching movies/TV shows
- Download cover images and add metadata to frontmatter
Example
Before:
---
title: The Matrix
---
After:
---
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
1 maintainer
Metadata
1 maintainer
Release files for obsidian-tmdb-cover 0.2.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| obsidian_tmdb_cover-0.2.0.tar.gz | 92.2 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| obsidian_tmdb_cover-0.2.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 102.3 kB
Release files / obsidian_tmdb_cover-0.2.0.tar.gz
| Download URL | obsidian_tmdb_cover-0.2.0.tar.gz |
|---|---|
| Size | 92.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
56b50725915c7a20922d165fcf570d746eba40e615661a3d23986fbfe683e78c
|
|
BLAKE2b-256 checksum How to use checksums |
e2e009c31a5ff3e2c570348bd1d21ed74a1c533270a48164508e461bab74f153
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.8.13
|
Release files / obsidian_tmdb_cover-0.2.0-py3-none-any.whl
| Download URL | obsidian_tmdb_cover-0.2.0-py3-none-any.whl |
|---|---|
| Size | 10.0 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
48e4d2e7d2de06f725cc5c9125f82ff7d8a8a17471e77188e3e072384f09280d
|
|
BLAKE2b-256 checksum How to use checksums |
21a7aa26c10d14fe049971a0a1d07a2d3436c8d862920eb53a96b7f547a7715e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.8.13
|
