Media Index for Home Assistant (Marketplace integration)

Installs: 132 sharing analytics
GitHub stars: 19
Connection: Works locally
Upkeep: Updated in the last 6 months
Version: v1.9.2, July 29, 2026
Kind: Marketplace integration
Needs: Needs the Marketplace (HACS on 2026.10 and older)
Domain: media_index
Source: github.com/markaggar/ha-media-index
Issues: Report an issue

Independent directory, made by the developer of Vulpo. Not affiliated with Home Assistant or the Open Home Foundation.

About

Media Index is a Home Assistant integration that indexes images and videos from local media folders. It scans configured folders, reads EXIF data from images and metadata from MP4 and MOV videos, and can turn GPS coordinates into location names through reverse geocoding with cached lookups. It adds services for random or ordered media selection, with filters for folder, file type, date range and favorites, plus an anniversary mode that finds photos from the same date across years. Further features include burst photo detection based on time and GPS proximity, a duplicate finder with a dry-run mode, and favorite handling based on star ratings. Cast slideshow services can run on any media player entity without a dashboard card. It works locally, is set up in the UI, and also serves as a companion to the Media Card.

Automatic summary of the README and code of markaggar/ha-media-index. Something wrong, or are you the maintainer and want your own text here? Get in touch

Supports

Works locally Talks to your devices on your own network. No vendor cloud in between.
From the Marketplace Installed through the Marketplace, formerly HACS.
Actively maintained Its author released or pushed a change in the last six months.

Provides

Sensors

Setting it up

Install it from the Marketplace and restart Home Assistant, then add it under Settings, Devices and services.

Set up Media Index

Base media folder (filesystem path: /media, /config/www, NOT media-source://)
Optional Media Source URI (e.g., media-source://media_source/local/ when using /config/www as base folder)
Watched folders (comma-separated relative paths)
Rescan on HA restart (catches changes while HA was offline; scans watched folders only when configured, otherwise full scan)
Scan schedule
Extract EXIF metadata
Enable geocoding (GPS to location names)
Coordinate precision (2-6 decimal places)
Use native language names (e.g., 日本 instead of Japan)
Max startup scan time (seconds)
Concurrent scan workers
Auto-install libmediainfo for video metadata extraction. During initial setup, Home Assistant restart required after install. When using install_libmediainfo service, integration auto-reloads (no restart needed). If you have multiple Media Index instances, only enable this for one.
Allow scanning without libmediainfo (images only). Enable this if you do not have video files and want scanning to proceed even when libmediainfo is not installed. Video metadata will not be extracted.
Batch size (files per batch)
Cache max age (days)

After setup

Media source URI (optional, only needed for custom media_dirs mappings)
Watched folders (comma-separated)
Scan schedule
Extract EXIF metadata
Enable geocoding
Coordinate precision (decimal places)
Use native language names (e.g., 日本 instead of Japan)
Max startup scan time (seconds)
Concurrent scan workers
Auto-install libmediainfo (for video metadata extraction). Only enable for one instance if multiple Media Index instances are used.
Allow scanning without libmediainfo (images only). Enable this if you do not have video files and want scanning to proceed even when libmediainfo is not installed.
Batch size (files per batch)
Cache max age (days)
Rescan on HA restart (catches changes while HA was offline; scans watched folders only when configured, otherwise full scan)
Auto Burst Indexing

Texts from the code of markaggar/ha-media-index.

From the README

A custom Home Assistant integration that indexes media files (images and videos) from local folders, extracts EXIF/metadata, provides geocoding, and offers services for random media selection, favorites management, and file operations. Specifically designed for Media Card, but can easily be used by any other card, integration or automation/script through Home Assistant Actions (Services) or WebSocket APIs.
Automatic scanning of configured media folders
File type detection for images (JPG, PNG, HEIC, etc.) and videos (MP4, MOV, AVI, etc.)
Real-time monitoring with file system watcher for instant updates
EXIF metadata extraction for images (GPS, date taken, camera info)
Video metadata extraction for MP4/MOV files (creation date, GPS coordinates - see installation prerequisites below)

From the README of markaggar/ha-media-index, MIT License. Shortened.