必须通过修改hosts文件绕过TMDB访问限制并正确配置Java环境,才能使tinyMediaManager成功为群晖NAS电影文件夹批量下载中文元数据;需挂载NAS为网络驱动器、设置媒体库、启用TheMovieDB刮削器并选择简体中文,最后可通过GUI手动、命令行或任务计划程序实现自动刮削。

要在Windows电脑上让tinyMediaManager自动为群晖NAS里的电影文件夹批量下载海报、剧情简介、导演演员等完整元数据,必须绕过TMDB官方API在国内的访问限制,并确保刮削结果能稳定写入网络路径。
安装Java与TMM并验证运行环境
从Oracle官网下载并安装JRE 11(【必须是11或更高版本,JRE 8会导致v5.x启动失败】),安装时勾选“添加到PATH”。打开命令提示符,输入 java -version,确认输出中包含 11. 开头的版本号。接着访问 tinyMediManager 官网,下载 Windows 64-bit 版本(如 v5.1.7),解压后双击 tinyMediaManager.exe 启动——若弹出黑窗闪退,说明Java未正确识别,需手动编辑快捷方式目标,在末尾加空格后追加 -Djava.home="C:Program FilesJavajre-11"(路径按你实际安装位置调整)。
强制改写hosts绕过TMDB网络拦截
用记事本(**务必以管理员身份运行**)打开 C:WindowsSystem32driversetchosts,在文件末尾另起一行,粘贴以下三行(IP每日可能变动,此处采用2026年11月实测可用地址):
13.224.161.90 api.themoviedb.org18.160.41.129 www.themoviedb.org169.150.247.35 image.tmdb.org
让 Windows 桌面程序在开机时静默自启并隐藏到系统托盘。特别适用于 Flutter、Electron 等无视 VBS/ProcessStartInfo 窗口样式、难以隐藏的顽固应用。提供「VBS 启动器 + Python ctypes/Win32 API」的隐藏窗口方案,可稳定把窗口收进托盘且不闪控制台。
保存后关闭所有浏览器和TMM窗口。这一步不做,后续所有刮削请求都会超时失败——TMM不会报错,只会静默跳过影片。
挂载NAS影视目录并添加为媒体库
第一步:在Windows文件资源管理器地址栏输入 \你的群晖IP(例如 \192.168.1.100),输入专用影视账户(非admin)凭据,右键点击Movies共享文件夹 → “映射网络驱动器”,分配固定盘符如 Z:。
第二步:打开TMM → 左侧菜单“设置” → “媒体库” → 点击“+”号 → 在弹出窗口中选择 Z:Movies → 勾选“递归扫描子文件夹” → 点击“确定”。
第三步:返回主界面,点击左下角“更新媒体库”按钮 → 等待右下角进度条走完,确认列表中出现全部电影文件数量(若显示0,请检查Z盘是否能正常打开、账户是否有读写权限)。
配置刮削参数与触发自动流程
方法一:GUI手动触发全量刮削
进入“设置” → “刮削器” → “TheMovieDB” → 勾选“启用” → 在下方“语言”中选择“中文(简体)” → 返回主界面 → 点击顶部工具栏“刮削” → “刮削所有未刮削项目” → 勾选“自动匹配” → 点击“下一步”。此时TMM将逐个发起请求,下载海报、背景图、nfo文件,全程无需干预。
方法二:命令行定时自动刮削(推荐长期使用)
在TMM安装目录下新建文本文件,重命名为 auto-scan.bat,用记事本打开,粘贴以下内容:
@echo offcd /d "D: mm"tinyMediaManagerCMD.exe -m movie -u -n -r -l zh-CN
其中 -m movie 指定处理电影模块,-u 扫描新增文件,-n 刮削新项目,-r 自动重命名并清理冗余文件,-l zh-CN 强制中文元数据。双击该bat即可后台执行,完成后自动生成日志。
方法三:Windows任务计划程序绑定
搜索并打开“任务计划程序” → 右侧“创建基本任务” → 命名为“TMM每日刮削” → 触发器设为“每天凌晨2:00” → 操作选“启动程序” → 程序/脚本填入 auto-scan.bat 的完整路径(如 D: mmuto-scan.bat)→ 完成。下次开机后系统将全自动执行,无需人工点开TMM。










