整理日期：2026-11-10。适用：macOS、IINA。以下方案已在本次用户环境中验证成功。
一、问题现象与原因
视频加入播放列表时显示原始文件名，例如 05_deepagents_入门.mp4；播放后变成 EV录屏5.1.3软件录制。
原因是视频内部包含录屏软件写入的 title 元数据。IINA 底层播放器在打开视频后读取到该标题，播放列表随之更新显示。Finder 中的实际文件名没有被修改。
目标：播放列表持续使用真实文件名，并保留原视频文件和内部元数据。
二、创建标题脚本
打开 iTerm，完整粘贴执行以下命令：
mkdir -p ~/.config/iina/scripts
cat > ~/.config/iina/scripts/filename-title.lua <<'LUA'
local mp = require("mp")
mp.register_event("start-file", function()
local filename = mp.get_property("filename")
if filename then
mp.set_property("force-media-title", filename)
end
end)
LUA
该命令创建脚本目录并写入 Lua 脚本；如同名脚本已存在，会覆盖其内容。本次使用的脚本路径为：
/Users/xxx/.config/iina/scripts/filename-title.lua
脚本监听每次开始播放文件的事件，读取 filename，再将 force-media-title 设置为该文件名。脚本只调整播放器内的显示属性，不修改视频文件。
三、配置 IINA 加载脚本
- 打开 IINA → 设置（⌘,）→ 高级。
- 开启 启用高级设置。
- 找到 额外 mpv 选项 / Additional mpv options。
- 删除之前试验添加的
force-media-title和script行，保留其他无关设置。 - 点击
+，填写下面这一行：
| 名称 | 值 |
|---|---|
scripts | /Users/xxx/.config/iina/scripts/filename-title.lua |
关键细节：
- 名称是 scripts，末尾有 s。
- 名称前不加
--。 - 路径不加引号，使用完整绝对路径。
- 如果已有 scripts 配置加载其他脚本，先保留其内容，不要直接覆盖。本表描述本次只有该脚本的配置。
- 在其他电脑使用时，将路径中的用户名替换成实际用户名。
四、重启并验证
- 按 ⌘Q 完全退出 IINA。
- 重新打开 IINA。
- 从 Finder 重新拖入视频文件，避免继续使用之前已缓存错误标题的播放列表。
- 播放并切换多个视频，确认列表持续显示各自的原始文件名。
本次验证结果：使用 scripts 加载上述 Lua 脚本后，播放列表文件名显示恢复正常。
六、恢复原行为
在 IINA 高级设置中删除本次添加的 scripts 行，然后完全退出并重启。如果该行后来增加了其他脚本，仅移除 filename-title.lua 对应配置，保留其他脚本。
Lua 文件可以保留；没有加载配置时不会因本次设置而执行。
七、适用范围
此配置对加载脚本的 IINA 实例中的媒体生效，也会覆盖音乐或网络媒体原本有意义的标题。需要保留这些标题时，可临时停用该脚本。其他版本的 IINA 如表现不同，应检查其内嵌 mpv 的脚本支持。
参考
转载自 CSDN-专业IT技术社区
