MediaLens
Docker app from ecoblaster's Repository
Read-only media library analyzer for movies and TV shows, with detailed HDR, Dolby Vision, audio, codec, subtitle, and hardware compatibility analysis.
Overview
Readme
View on GitHubMediaLens
MediaLens is a read-only media library analyzer for movies and TV shows. It scans local media with FFprobe and MediaInfo, presents HDR and audio capability information, evaluates playback-device compatibility, and automatically imports new files after they finish copying.

MediaLens 1.1.0
The stable image is published as:
ecoblaster/medialens:1.1.0
ecoblaster/medialens:latest
A GitHub Container Registry mirror is also available:
ghcr.io/ecoblaster/medialens:1.1.0
ghcr.io/ecoblaster/medialens:latest
Docker run
docker run -d \
--name medialens \
--restart unless-stopped \
-p 8090:8080 \
-e MEDIALENS_AUTO_SCAN_ENABLED=true \
-e MEDIALENS_FILE_STABILITY_SECONDS=60 \
-e MEDIALENS_RECONCILE_MINUTES=15 \
-v /mnt/user/appdata/medialens:/data \
-v "/mnt/user/Media/Movies:/media/movies:ro" \
-v "/mnt/user/Media/TV Shows:/media/tv:ro" \
ecoblaster/medialens:1.1.0
Open MediaLens at http://<server-address>:8090.
Docker Compose
Copy docker-compose.production.yml, then set the paths for your server:
export MEDIALENS_DATA_PATH=/mnt/user/appdata/medialens
export MEDIALENS_MOVIES_PATH="/mnt/user/Media/Movies"
export MEDIALENS_TV_PATH="/mnt/user/Media/TV Shows"
docker compose -f docker-compose.production.yml up -d
Unraid template settings
Use these values when adding the container manually:
| Setting | Value |
|---|---|
| Repository | ecoblaster/medialens:latest |
| WebUI | http://[IP]:[PORT:8080] |
| Container port | 8080 |
| Suggested host port | 8090 |
| App data container path | /data |
| Movies container path | /media/movies (read-only) |
| TV container path | /media/tv (read-only) |
Using latest allows Unraid to detect newly published stable images. To pin the installation to a specific release instead, use a numbered tag such as ecoblaster/medialens:1.1.0; pinned containers must be changed manually when moving to a later version.
Recommended variables:
| Variable | Default |
|---|---|
MEDIALENS_AUTO_SCAN_ENABLED |
true |
MEDIALENS_FILE_STABILITY_SECONDS |
60 |
MEDIALENS_RECONCILE_MINUTES |
15 |
First-run setup wizard
MediaLens 1.1 includes a guided setup wizard for empty installations.
- Open
http://<server-address>:8090. - Choose whether to add Movies, TV Shows, or both.
- Confirm the prefilled container paths
/media/moviesand/media/tv. - Optionally change the library names or container paths.
- Choose whether to begin the initial full scans immediately.
- Finish setup and follow scan progress from the dashboard.
The wizard appears only when no libraries are registered. Existing installations that reuse the same /data mapping continue directly to the dashboard with their libraries and scan history intact.
Advanced library management remains available through the API documentation at http://<server-address>:8090/docs.
Main features
- Guided first-run library setup
- Dolby Vision profile, HDR10, HDR10+, and SDR analysis
- Reliable Profile 7 FEL/MEL identification through Dolby Vision RPU analysis
- Dolby Atmos, DTS:X, lossless audio, subtitle, bitrate, and codec analysis
- Hardware compatibility profiles for NVIDIA Shield, Apple TV, Fire TV Cube, Google TV, Homatics, Xiaomi, and Ugoos devices
- Automatic scanning with file-copy stability checks and periodic reconciliation
- Full-library search plus video-codec, Dolby Vision format, and quality-health filters
- Read-only library mounts; MediaLens never modifies source media
Data and upgrades
MediaLens stores its SQLite database under /data. Keep that directory persistent when recreating or upgrading the container.
For an Unraid installation using the latest tag:
- Select Check for Updates on the Docker page.
- Apply the MediaLens update when a new image is available.
- Keep the existing
/data,/media/movies, and/media/tvmappings unchanged.
For a command-line installation:
docker pull ecoblaster/medialens:latest
Then recreate the container while preserving the same /data, movie, and TV mappings.
Categories
Download Statistics
Related apps
Explore more like this
Explore allLinks
Details
ghcr.io/ecoblaster/medialens:latestRuntime arguments
- Web UI
http://[IP]:[PORT:8080]- Network
bridge- Shell
bash- Privileged
- false
Template configuration
MediaLens web interface port.
- Target
- 8080
- Default
- 8090
Persistent MediaLens application data and SQLite database. Keep this path when upgrading or recreating the container.
- Target
- /data
- Default
- /mnt/user/appdata/medialens
Read-only path to your Movies library. The container path /media/movies is used by the MediaLens setup wizard.
- Target
- /media/movies
- Default
- /mnt/user/Media/Movies
Read-only path to your TV Shows library. The container path /media/tv is used by the MediaLens setup wizard.
- Target
- /media/tv
- Default
- /mnt/user/Media/TV Shows
Automatically detect newly added or changed media files.
- Target
- MEDIALENS_AUTO_SCAN_ENABLED
- Default
- true
Number of seconds a new or changed file must remain stable before MediaLens analyzes it.
- Target
- MEDIALENS_FILE_STABILITY_SECONDS
- Default
- 60
How often MediaLens reconciles the library for missed changes.
- Target
- MEDIALENS_RECONCILE_MINUTES
- Default
- 15