dengji85/avm

这是什么？

核心功能

• 01归一番号，并从文件名识别字幕、无码、VR、4K 等标记。
• 02可插拔数据源刮削，包括 JavBus、JavDB、AV-Wiki 与本地 NFO 文件。
• 03按文件大小与内容哈希识别重复文件，并归并多版本。
• 04支持网页内播放，也能监控 VLC、PotPlayer、mpv 记录观看进度。
• 05提供观影统计、智能片单、女优资料页与年度回顾。
• 06支持局域网内手机和平板扫码访问。

适用场景

• 把硬盘中命名混乱的大型影片收藏整理成统一的可浏览库。
• 清理重复文件，为每部影片保留最佳版本。
• 在群晖等 NAS 上用 Docker 部署，并从局域网其他设备访问。
• 记录观看历史，回顾个人观影偏好的变化。

快速上手

1. 1

   安装 Python 依赖

   pip install -r requirements.txt
2. 2

   启动后端服务

   python run.py serve
3. 3

   安装并运行前端开发服务器（然后打开 http://localhost:5173）

   cd web_src && npm install && npm run dev

使用前须知

• !README 写明为 MIT 许可证，但仓库元数据未标注许可证，复用前请先确认条款。
• !从源码运行需要同时安装 Python 和 Node.js，Windows exe 或 Docker 方式更简便。
• !部分刮削源需要本机安装 Chrome 才能最佳工作，未安装时会回退为普通请求。

标签

常见问题

avm 是什么？

本地优先的私人 AV 影片库管理工具，支持刮削元数据、去重、网页播放与观影统计。 AVM（Adult Video Manager）是一款可自托管的本地 AV 影片库管理工具，把硬盘里命名混乱的视频文件整理成可搜索的个人资料库。它能识别并归一番号，扫描时跳过样片和预告，并从 JavBus、JavDB、AV-Wiki 及本地 .nfo 等可插拔数据源补全封面、女优、类型、系列和评分。

avm 可以免费使用吗？用的什么许可证？

avm 没有声明许可证。代码虽然公开，但没有许可证就没有明确的使用授权，正式使用前建议先联系作者。

avm 还在维护吗？

活跃维护中。avm 最近一次提交是在 2026年10月18日。

avm 适合用来做什么？

把硬盘中命名混乱的大型影片收藏整理成统一的可浏览库。 清理重复文件，为每部影片保留最佳版本。 在群晖等 NAS 上用 Docker 部署，并从局域网其他设备访问。 记录观看历史，回顾个人观影偏好的变化。

avm 怎么安装和运行？

安装 Python 依赖: pip install -r requirements.txt 启动后端服务: python run.py serve 安装并运行前端开发服务器（然后打开 http://localhost:5173）: cd web_src && npm install && npm run dev

在哪里获取 avm？

源代码和安装说明在 GitHub 上：https://github.com/dengji85/avm