--- title: "Media Index" description: "Media Index is a Marketplace integration for Home Assistant. It has 132 installs sharing analytics, works locally and was last updated July 29, 2026." canonical: "https://vulpo.app/integrations/marketplace/markaggar-ha-media-index" url: "https://vulpo.app/integrations/marketplace/markaggar-ha-media-index.md" last-updated: "2026-10-22" version: "1.4" --- # Media Index > Media Index is a Marketplace integration for Home Assistant. It has 132 installs sharing analytics, works locally and was last updated July 29, 2026. 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](https://vulpo.app/contact) [Open in My Home Assistant](https://my.home-assistant.io/redirect/hacs_repository/?owner=markaggar&repository=ha-media-index&category=integration) On Home Assistant 2026.11 or newer? [Open it in the Marketplace](https://my.home-assistant.io/redirect/marketplace_repository/?owner=markaggar&repository=ha-media-index&category=integration) ## 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. ## 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](https://github.com/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](https://github.com/markaggar/ha-media-index#readme), [MIT License](https://spdx.org/licenses/MIT.html). Shortened. ## At a glance - Kind: Marketplace integration - Number: 132 installs sharing analytics; 19 GitHub stars - Connection: Works locally - Upkeep: Updated in the last 6 months - Needs: Needs the Marketplace (HACS on 2026.10 and older) - Latest version: v1.9.2, last updated July 29, 2026 - Domain: `media_index` - Source: - Issues: In Vulpo: Chart card, Apple Watch Independent directory, made by the developer of Vulpo. Not affiliated with Home Assistant or the Open Home Foundation. [About these numbers](https://vulpo.app/integrations/about) Last updated 2026-10-22. Source: https://vulpo.app/integrations/marketplace/markaggar-ha-media-index --- - HTML version of this page: https://vulpo.app/integrations/marketplace/markaggar-ha-media-index - Site index for agents: https://vulpo.app/llms.txt - Everything in one document: https://vulpo.app/llms-full.txt - All pages: https://vulpo.app/sitemap.xml