# MediaLens

MediaLens is a read-only media library analyzer for movies and TV shows that scans local media to help homelab users verify HDR, Dolby Vision, audio, codec, subtitle, and playback-device compatibility. It is open source and self-hosted, installable on Docker Hub and Unraid.

Canonical page: https://ourlocalhost.com/app/2451/medialens

## Description

MediaLens is a read-only media library analyzer for movies and TV shows that scans local media to help homelab users verify HDR, Dolby Vision, audio, codec, subtitle, and playback-device compatibility.

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

43/100 (Fair), based on 3 of 4 factors.
- Maintained: 73 (last commit 94 days ago)
- Popular: 0 (0 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)

## Links

- Docker Hub: https://hub.docker.com/r/ecoblaster/medialens
- GitHub: https://github.com/ecoblaster/MediaLens
- Unraid: https://ca.unraid.net/apps/medialens-1ljipu40xcdwc0?q=MediaLens

## Common questions

### Which port should I expose for MediaLens?

Expose container port 8080 to a host port, such as 8090, and open MediaLens on that host port. The container listens on 8080 internally.

### What data should I back up or persist when moving MediaLens?

Persist the /data volume, because it stores library registrations and scan history. The movie and TV media mounts should be read-only and are not written to by MediaLens.

### How does MediaLens pick up newly copied files?

Enable MEDIALENS_AUTO_SCAN_ENABLED, set MEDIALENS_FILE_STABILITY_SECONDS so copied files are considered stable before scanning, and use MEDIALENS_RECONCILE_MINUTES for periodic reconciliation.

### Why doesn't the setup wizard appear after I mount /data from an old installation?

The wizard appears only when no libraries are registered. Reusing the same /data mapping makes MediaLens continue directly to the dashboard with existing libraries and scan history intact.

### Should I use latest or a pinned image tag?

Use latest so Unraid can detect newly published stable images, or pin to a numbered tag such as 1.1.0 and manually change the tag when moving to a later version.

---
Source: Our Local Host (https://ourlocalhost.com/app/2451/medialens), the self-hosted and open-source app directory.
