• 若碰到问题，换含 mpv 的便携版测试。
• 还不行就换视频或者软解（mpv.conf只保留log-file 选项）并检查 mpv 日志。
  mpv_embed > portable_config > mpv_log.txt
mpv.conf > log-file = <save path>
• 弹幕插件推荐：
  https://github.com/Tony15246/uosc_danmaku
  https://github.com/Kosette/danmaku

mpv_embed

• mpv.conf 是我个人使用的简易配置。
• 相较原版 mpv，只修改了少部分快捷键和配置。
• 想更新版本可点击 mpv_embed > updater.bat

mpv_embed 快捷键

mpv.net

• 设置播放完自动关闭。不加载下个文件。（方便触发回传进度，.ini配置有播放列表选项）
  右击 > Settings > Playback > idle:no, auto-load-folder:no （大概是这样

• 提示 渲染 Pin 失败 无法播放。或者日志提示 KeyError: 'stream.mkv'
  或者 pot stop, stop_sec=None 或者 请求的操作需要提升 解决方案：
  按以下依次修改，每次修改后尝试播放，还不行就无解，欢迎 PR。

  1. 初始化 PotPlayer 设置。
  2. 换 Pot 为 20240618 版本。
  3. 换 Pot 为 最新版本 版本。
  4. 本地用户查看通用 FAQ > 如何切换模式 使用读盘模式。
  5. 换 mpv 测试此否正常播放。 240618 版本下载链接。
     potplayer-1-7-22286.exe (v240618) | Scoop | winget
     sha256sum 66d03fc13f4949948890675cf62b839b704b542a34a13a180466f93be20d5bc6

• 本地用户可考虑：MPC-HC 自带 LAV，同样支持 madVR MPCVR BFRC 等。
  网络用户或没有特殊需求的话，mpv 系的播放器综合体验较好。

• [可选] 选项 > 播放 > 播放窗口尺寸：全屏

• 配置/语言/其他 > 收尾处理 > 播放完当前后退出（触发回传进度）

• 若使用 http 播放，可能提示地址关闭。Win8 32bit 碰到。
  解决方案：本地用户使用读盘模式，或者换 pot 便携版。
  安全性未知：PotPlayerPortable-220914.zip
  先打开 PotPlayerPortable.exe 一次，但播放用 C:\<path_to>\PotPlayerPortable\App\PotPlayer\PotPlayer.exe
  不然会要求管理员权限运行。

• 读盘模式可能和美化标题和混合S0的功能冲突，不过不影响使用。（FAQ > 隐藏功能 有解决方案）

MPC：

• 会自动开启 WebUI，系统防火墙提示的时候可以拒绝（不影响使用）。
• 会自动开启 WebUI，建议仅允许从 localhost 访问： 查看 > 选项 > Web 界面：
  打勾 仅允许从 localhost 访问
• MPC 播放 http 具有加载和拖动慢，视频总时长可能有误的缺点。
  以及点击关闭播放器后，进程可能残留在后台。
• MPC 播放 http 无外挂字幕：
  MPC-HC 设置 > 回放 > 输出 > 字幕渲染器 > 内部字幕渲染器
  MPC-BE 设置 > 字幕 > 字幕渲染器 > 内部字幕渲染器

IINA

• 播放完不完全退出会影响进度回传和静态管道名称配置。
  解决方法：设置 > 通用
  启用 没有打开的窗口时退出
  禁用 播放完成后保存窗口打开
• 非读盘模式不支持播放列表。

iso 原盘 bdmv 相关

• 推荐使用 vlc 支持菜单展示，支持网络流。
• Pot mpv 也可以播放 iso bdmv，但需要读盘模式，即路径转换和本地文件挂载。
• strm 内需要填路径，然后启用 strm 直接播放和读盘模式。
• iso 不支持回传进度。
• player_by_path = vlc: __bdmv, .iso 配置文件里的这个设置项可以仅播放原盘的时候用 vlc。

本地 重定向/替换 播放网址

• 本地替换播放网址，减少网络重定向，加速访问。
• alist strm 用户替换 alist 服务地址：解决网盘不支持302时，在外播放受 nas 上传速度限制。
  此时需要填写 strm_direct_host 及本机运行 alist。注意要带端口，不然会变成替换 emby 的服务器地址。
• 使用预读取下一集的用户：nginx 可以只反代视频流。浏览器访问源站，重定向视频流交给本机。降低 nginx 配置难度。减少 bug。
• 填写位置：.ini > [dev]

  # 网址之间逗号隔开，成对填写。原始网址, 新网址。
  stream_redirect = http://src.src.com, http://reverse.proxy.com, http://192.168.1.1:5244, http://127.0.0.1:5244
  

• 问题：strm 文件因为缺少时长信息，emby 不存储播放进度，导致无法继续播放。
• 内置方案：单机运行 etlp 时，会临时储存在内存。关闭脚本进度丢失。（默认已启用，无需配置本功能）
• 局域网方案：同时在 nas 或者其他服务器运行 etlp，播放时会向服务器的 etlp 查询和存储播放时间。需要确保服务器长期运行。
• 服务器 eltp 填写位置：.ini > [dev]

    # 是否仅监听本机地址，会更安全，但无法与让其他 etlp 通讯。在服务器运行时需要改为 no。
    listen_on_localhost = no
  

• 客户端 eltp 填写位置：.ini > [dev]

    # 在服务器运行的 eltp 通讯监听地址，例如：http://192.168.1.23:58000
    # 限客户机填，服务器取消监听本机地址即可，服务器的日志会有提示。
    server_side_href =
  

• 通过 script-message 传递部分数据给 mpv，以便其他脚本使用。
• 'script-message', 'etlp-cmd-pipe', cmd_pipe : 命令行 ipc 管道名称。
• 'script-message', 'etlp-playlist-data', playlist_data : emby 的播放列表数据。
• 'script-message', 'etlp-playlist-done' : 表明 mpv 播放列表已添加完成。
• 填写位置：.ini > [dev]

  # 播放列表数据较大，默认不传递。若需要启用，则填写此项。
  mpv_ipc_playlist_data = yes
  

• 播放时检查视频章节时长与标题，符合条件时自动跳过该章节或仅提示。
• 前提：
  • Emby 成功扫描片头。（测试：禁用脚本，用网页播放时有跳过片头按钮）
  • 或者视频文件自带片头片尾章节。（若章节的标题标准会更准确，例如 "Opening"）
• 原理：视频文件本身无章节时，脚本会自动给 mpv 加片头章节。并在播放时候检测。
• 填写位置：.ini > [dev]

  # 片头有90秒，片尾有91秒，允许5秒钟的误差，片头在前30%里，片尾在70%以后，片头片尾可能的章节名称（逗号隔开，辅助判断，不分大小写）
  # 若要禁用就删除掉，或者在前面加 # 号注释掉。mpv 章节跳转快捷键是 ; ' Page Up Page Down
  # 若含有特殊值 hint_only（可删除），为启用仅提示模式，不自动跳过。需要跳过就按章节跳转快捷键。
  skip_intro = 90, 91, 5, 30, 70, opening, ending, op, ed, hint_only
  

mpv bangumi trakt 独立同步脚本

• 使用情景：不想用本工具网页调用播放，但也想标记 bangumi trakt 中对应条目为已观看。
• 条件：mpv 播放器，播放网络视频流，播放进度超过 90% 时同步。
• 使用方法：
  1. 下载 etlp-python-embed-win32.zip 并解压到任意文件夹。
     （之前就在用本脚本的，更换为便携版，不要运行两份。或者参考 FAQ > 观看记录存储服务相关 自行安装 Python 和依赖。）
  2. 将 lua： 刚才解压的文件夹\utils\others\etlp_sync_bgm_trakt.lua 移动至 mpv 的脚本文件夹。
     例如：mpv.exe 所在目录 > portable_config > scripts > etlp_sync_bgm_trakt.lua
  3. 修改 etlp_sync_bgm_trakt.lua 内 etlp 的保存目录（刚才解压的文件夹路径）
  4. 参考上方 FAQ > 观看记录存储服务相关 修改配置文件：embyToLocalPlayer_config.ini
  5. 参考 隐藏功能 > 预读取继续观看 设置 [dev] > server_data_group。用于获取user_id
  6. 播放一个视频，进度拖到 90% 以上，查看 etlp 日志：刚才解压的文件夹 > log.txt。或者查看 mpv 日志。
• 排错方法：使用本项目浏览器调用播放测试。

预读取下一集

• 预读取并丢弃下一集首尾文件数据，加速集数切换播放。
• 需要配合 nginx 反代管理缓存，比较麻烦。(在本机或者 nas 运行一个 nginx，缓存并切片视频流)
  读取并丢弃 首8% 尾2% 的数据。按理 rclone 配置缓存也可以，但实测效果不佳。
• 浏览器访问局域网的反代站，或配合 本地 重定向/替换 播放网址。才能起到缓存效果。
• 填写位置：.ini > [playlist]

  # 播放进度超过 50% 时触发预读取，预读取下一集。
  prefetch_percent = 50
  
  # 服务端路径包含以下前缀才预读取，逗号隔开，全部启用就留空或删除。
  prefetch_path = /mnt/od/TV, /mnt/gd
  
  # 启用本功能的域名的关键词，逗号隔开。全部启用就留空或删除。
  prefetch_host = 
  

• 网盘和本地硬盘混合使用的话。[可选] 配置本地文件用读盘模式：.ini > dev > force_disk_mode_path
• 用自签证书反代 https 的站，可以仅反代视频流，并配置跳过证书验证。.ini > dev > skip_certificate_verify
  不过部分播放器也会校检证书，这个需要自行解决。

预读取继续观看

• 类似预读取下一集。仅处理最近上映的集（7天内），适合追更。
• 尝试获取 strm 文件的媒体信息，加速起播。
• [可选] 在不关机的机器里配置并运行更合适一点。
• 填写位置：.ini > [dev]

  # 服务器信息，各项之间逗号隔开，最后分号结尾。复数服务器需要配置就分号后面继续写。
  # api_key：设置 > API 密钥。user_id：设置 > 用户 > [用户名] > 看浏览器网址。
  server_data_group = myself, http://localhost:8096, api_key, user_id;
                      others, https://www.abc.org, api_key, user_id;
  # 配置格式：上方配置的服务器名，一个或者多个服务端媒体路径前缀，复数服务器同样分号隔开。
  # 服务端路径包含路径前缀才预读取，全部就写 /
  # strm 是特殊值，只用来刮出媒体时长信息。此时无视上映时间和路径限制。
  prefetch_conf = myself, strm, /, /od/另一个路径前缀;
  

• 若需要 nginx 缓存：网址填反代站。如果填源站，需要配置上方的重定向视频流到反代站。
  注意播放链接与预读取链接不一致。 proxy_cache_key "$arg_MediaSourceId$slice_range";

追更 TG 通知

• 继续观看更新时，通过 Telegram 机器人发送通知。（每10分钟检测一次）
• 前置依赖：启用 预读取继续观看。
• 填写位置：.ini 顶部或底部（单独的配置区域即可，不要填到别的配置里）

  ##################################################################
  ### v v # # # # # # # # 追更 TG 通知 # # # # # # # # # # # v v ###
  
  [tg_notify]
  
  # 找 @BotFather 创建一个机器人。复制并填写 token。
  bot_token = 
  
  # 点击你创建的机器人，然后点击开始或随便发送信息给你的机器人，最后启动本脚本。机器人会告诉你 chat_id。
  chat_id = 
  
  # chat_id 填写后，重启脚本，会自动测试，提示测试成功的话，本项可以关闭。 
  get_chat_id = yes
  
  # 如果不需要预读取服务，仅通知。就启用本项。
  disable_prefetch = no
  
  # 静音通知时间段，范围间逗号隔开。例如：0-9 0点后9点前。类似针式时钟的时间范围。
  silence_time = 0-9, 12-14
  
  # [可选] 可指定 api, 自行搜索 "TG Bot API 反代", 解决网络连接问题。
  base_url = https://api.telegram.org
  

配置方法

• 填写位置：.ini 顶部或底部（单独的配置区域即可，不要填到别的配置里）

  ##################################################################
  ### v v # # # # # # # 持久性缓存（边下边播） # # # # # # # # v v ###
  
  [gui]
  
  # 未适配播放列表，不接受播放列表相关问题反馈，建议禁用播放列表使用。
  # 是否需要缓存文件到本地硬盘，播放时会弹菜单。油猴不用开读取硬盘模式。
  enable = no
  
  # 缓存路径：NTFS 支持不很理想，解决方法详见下方 FAQ
  cache_path = D:\cache
  
  # [可选] 在服务端文件路径包含指定关键词时才弹菜单，否则直接播放。关键词间逗号隔开。
  enable_path = 
  
  # 当播放进度超过 98% ，此时若关闭播放器，则删除缓存。禁用填 100
  delete_at = 98
  
  # 缓存超过 100GB 时删除旧缓存。
  cache_size_limit = 100
  
  # 重启后是否自动开始下载未完成任务
  auto_resume = no
  
  # 下载时的代理，用不到就留空。 http://127.0.0.1:7890
  http_proxy =
  
  # 需要禁用 gui 的域名：所包含的字符串列表，逗号隔开，将根据油猴设置直接播放。
  except_host = localhost, 127.0.0.1, 192.168. , 192-168-, example.com:8096
  

持久性缓存（边下边播）FAQ

• 如果播放进度超过下载进度，建议关闭播放器触发回传以保存播放进度。（以下为 Windows 平台测试）：
  mpv mpv.net 会停止播放十几秒。
  Pot 会停止播放或跳到尾部。(记得拖回来再关闭）
  MPC 会退出播放器。
  VLC 会停止播放。
• Windows：（ Linux ext4, macOS APFS 没问题。）
  问题：默认的硬盘文件系统 NTFS 会造成额外磁盘开销和初始化时间久，ReFS 正常。
  解决方案：
  1. 使用 顺序下载（需要下载完毕才会用缓存播放，点播放会回退到网络播放模式）
  2. Win10 工作站版和企业版 支持 ReFS，把缓存盘或分区格式化为 ReFS（数据会清空）。
  3. 未核实：用密匙升级为工作站版，或数字权利工具转换。
  4. 开虚拟机或别的电脑有工作站版，然后直通硬盘并格式化成 ReFS 给 Win10 用（专业版测试可行）。
     Win8.1 有人改注册表支持。
• 网页点击播放时弹出菜单：
  1. 播放：当缓存进度大于播放开始时间时用缓存播放。其他情况回退网络模式。
  2. 下载 1% 后播放：等待下载首尾各 1% 后启动播放器。其他等同于播放。
  3. 下载（首尾优先）：优先下载首尾各 1% ，可边下边播。
  4. 下载（顺序下载）：不能边下边播。
  5. 删除当前下载
  6. 下载管理器

配置方法

• 填写位置：.ini 顶部或底部（单独的配置区域即可，不要填到别的配置里）

  ##################################################################
  ### v v # # # # # # # # # 弹弹播放器 # # # # # # # # # # # # v v ###
  
  [dandan]
  # 弹弹play 动漫弹幕播放器支持。
  # 播放器需开启远程访问和自动加入媒体库。以及 设置 > 文件关联 > 修复弹弹play专用链。
  
  # 总开关： no 禁用，yes 启用。
  enable = no
  
  # 播放器路径
  exe = C:\Green\dandanplay-x64\dandanplay.exe
  
  # 远程访问端口。远程访问里 ip 改为 127.0.0.1 会比较安全。
  port = 80
  
  # 若远程访问曾经启用过 Web验证，请在这里填写 api密钥，没设置则留空。（注意不是密码）
  api_key =
  
  # 仅当服务端路径包含以下路径时使用弹弹播放，逗号隔开。全部文件都用弹弹播放就留空或删除。
  enable_path = /mnt/od/TV, /mnt/disk1/anime, 路径的部分字符也可以, anime
  
  # 通过 http 播放时，是否控制开始时间。需等待播放15秒。
  http_seek = yes
  

弹弹play FAQ

• 弹弹 api 服务需要10秒左右启动，播放时间太短可能会回传失败。
• 播放器需开启远程访问和自动加入媒体库。以及 设置 > 文件关联 > 修复弹弹play专用链。
• 若通过 http 播放，有以下缺点：
  1. 每次播放需要选择弹幕。（已把文件名发送给播放器匹配）
  2. 启动时无法及时跳转到 Emby 开始时间，需要播放开始后等待15秒。（每次看完一集则不影响）
  3. 无法加载外挂字幕。
• 读盘模式：解决切换设备播放时，进度不一致（读盘模式进度由弹弹存储），同步策略：
  当 Emby 上的进度大于120秒，但弹弹播放器进度小于30秒时（且 api 启动后未曾超过120秒）， 会调整弹弹播放器进度，使其与 Emby 上的一致，需等待 api 启动。

• 修复情景：
  1. Pot 读盘模式：播放动漫第一季，会漏播 Emby 穿插的 S0 集数。
  2. Pot 读盘模式：Emby 上创建的播放列表无法传递给 Pot。
  3. Pot 读盘模式：剧集播放列表标题错位/缺少。
• 前提条件二选一：
  1. Pot 选项 > 配置 > 用当前方案创建 > 改配置文件名称为 emby（用脚本播放时会自动切换为该配置）:
     Pot 选项 > 左上角切换配置为 emby > 基本 > 相似文件打开策略 > 仅打开选定的文件 > 确定 > 关闭。（仅 emby 播放时由脚本添加播列表）
  2. Pot 选项 > 基本 > 相似文件打开策略 > 仅打开选定的文件。（缺点：用文件管理器播放无播放列表）
• 填写位置：.ini > [dev]

  # 启动 Pot 的时候指定配置文件的名称，不需要就清空。
  # 若指定的配置名称不存在，Pot 会回退使用重置后的初始配置。
  pot_conf = emby
  

• 填写位置：.ini > [playlist]

  # 解决 Pot 读盘模式漏播第零季选集及播放列表标题错位/缺少，播放列表加载会变慢，每秒1集。
  mix_s0 = yes
  

• 播放的第一个文件是 S0 的话，会连续播 S0。（通用 Bug，换 mpv 也会这样）

• 问题：标题含空格或者个别半角符号，会导致 pot 无法从命令行启动，无法播放。
• 解决方案：把半角单双引号替换为全角，空格替换为连字符。是以下配置的默认行为。
• 填写位置：.ini > [dev]

    # 此功能可能产生其他问题，建议仅在 pot 中使用。
    # 谨慎配置，只接受单个字符，全角逗号隔开，成对填写。
    # 不要有多余的空格引号，注意分隔符是全角的逗号。
    media_title_translate = '，＇，"，＂， ，-
  

• 效果示例：把 1080p 版本的内封字幕提取出来给 2160p 的无字幕视频使用。
• 触发条件：视频含多版本，当前版本的视频无外挂字幕，且内封字幕标题无下方配置所包含字符时。
• 解决方案：播放时，提取其他版本视频内，符合下方语言偏好的字幕，给当前版本视频使用。
• 填写位置：.ini > [dev]

  # 视频含多版本且字幕标题不包含下方字符时，提取其他版本视频的字幕供当前视频使用。下方配置字母需小写。选项逗号隔开，前面优先。
  sub_extract_priority = 中英特效, 双语特效, 简中特效, 简体特效, 特效, 中上, 中英, 双语, 简, simp, 中, chi