Repolode
提交项目
frederikemmer

frederikemmer/MediaLyze

自托管的媒体库分析工具，用 ffprobe 扫描视频、音乐和有声书，并在网页中查看技术元数据。

在 GitHub 查看官网
Star
509
Fork
17
未关闭 Issue
8
最近提交
24小时前

这是什么？

MediaLyze 扫描本地的视频、音乐和有声书媒体库，用 ffprobe 逐个分析文件，把格式、音视频流和字幕等信息统一整理成可检索的数据。分析结果通过 FastAPI 与 React 构建的网页界面查看，提供图表、历史分析、对比页面以及整库质量评分。

项目可以以单个 Docker 容器加 SQLite 数据库的方式部署，也提供基于 Electron 的桌面版，支持 Windows、macOS 和 Linux。全量与增量扫描依据路径、文件大小和修改时间判断变化，并支持用 glob 规则忽略指定文件或目录。

项目还包含测试版的 FFmpeg 转码功能，会生成与原文件关联的视频变体，并探测 Intel、AMD、NVIDIA 和 Apple 的硬件编码能力。除非用户明确确认替换，原始文件都不会被改动。

核心功能

  • 01用 ffprobe 分析媒体文件，统一整理格式、音视频流和字幕信息
  • 02基于路径、文件大小和修改时间进行全量与增量扫描
  • 03提供多种图表、历史分析和整库质量评分
  • 04识别剧集、季和花絮内容
  • 05支持用 glob 规则忽略指定文件和目录
  • 06测试版 FFmpeg 转码，支持硬件加速探测，输出不覆盖原文件

适用场景

  • 检查大型家庭视频或音乐库的编码、分辨率和字幕覆盖情况
  • 找出在目标设备上播放前需要重新编码的文件
  • 长期跟踪 NAS 媒体库的变化
  • 在 Docker 中以只读方式分析网络挂载的媒体文件

快速上手

  1. 1

    复制示例环境变量文件

    cp docker/env.example .env
  2. 2

    使用 Docker Compose 构建并启动容器

    docker compose -f docker-compose-dev.yaml up --build
  3. 3

    在浏览器中打开 http://localhost:8080

使用前须知

  • 采用 AGPL-3.0 许可证，这是一种强 Copyleft 许可证，对修改后通过网络提供服务的版本同样适用。
  • 转码功能仍处于测试版（Beta）阶段。
  • 没有内置身份验证，需要自行提供认证层。

收录于专题

自托管应用

标签

#media-library#ffprobe#ffmpeg#self-hosted#media-analysis#transcoding#docker#video-metadata

常见问题

MediaLyze 是什么？
自托管的媒体库分析工具，用 ffprobe 扫描视频、音乐和有声书，并在网页中查看技术元数据。 MediaLyze 扫描本地的视频、音乐和有声书媒体库，用 ffprobe 逐个分析文件，把格式、音视频流和字幕等信息统一整理成可检索的数据。分析结果通过 FastAPI 与 React 构建的网页界面查看，提供图表、历史分析、对比页面以及整库质量评分。
MediaLyze 可以免费使用吗？用的什么许可证？
MediaLyze 以 AGPL-3.0 许可证开源。用于商业产品前，请先确认许可证条款。
MediaLyze 还在维护吗？
活跃维护中。MediaLyze 最近一次提交是在 2026年11月6日。
MediaLyze 适合用来做什么？
检查大型家庭视频或音乐库的编码、分辨率和字幕覆盖情况 找出在目标设备上播放前需要重新编码的文件 长期跟踪 NAS 媒体库的变化 在 Docker 中以只读方式分析网络挂载的媒体文件
MediaLyze 怎么安装和运行？
复制示例环境变量文件: cp docker/env.example .env 使用 Docker Compose 构建并启动容器: docker compose -f docker-compose-dev.yaml up --build 在浏览器中打开 http://localhost:8080
在哪里获取 MediaLyze？
源代码和安装说明在 GitHub 上：https://github.com/frederikemmer/MediaLyze

概要由 AI 根据项目 README 生成；GitHub 数据每日更新。

相关项目