Subfinder 字幕查找器完整指南:三步装好,自动为视频匹配并下载字幕【免费下载链接】subfinder字幕查找器项目地址: https://gitcode.com/gh_mirrors/subfi/subfinderSubfinder 是一个用 Python 编写的开源字幕查找器:你给它一个视频文件或一个装满剧集的文件夹,它会自动从文件名里提取关键词,依次向射手字幕网、字幕库、SubHD 三个字幕源发起搜索,把匹配到的字幕下载并解压到视频旁边。它同时提供命令行、图形界面和系统右键菜单三种入口,不敲命令行的普通观众也能直接用。为什么手动搜字幕这么费劲先看它替你省掉的那几步:打开两三个字幕网站、输入片名、逐个比对分辨率和封装格式、下载下来往往还是 zip 或 rar 压缩包,再手动解压改名。Subfinder 把这条链路压缩成一句丢个文件进来。它从文件名里自动提取搜索关键词,比如Avengers.Endgame.2019.1080p.BluRay.x264-SPARKS.mkv会被解析成 Avengers Endgame 2019 去搜索;找到的字幕若是压缩包会自动解压;下载完成后字幕文件名前缀一个数字编号,编号越小优先级越高,播放器按名字排序时优先级最高的那条就排在最前面。三步装好 Subfinder 并完成第一次字幕查找这一步只做两件事:装软件,然后跑通第一次查找。整个过程不需要额外配置。安装。前提是本机有 Python 3.8 及以上版本,pip 一条命令装好:pip install subfinder如果你更习惯从源码装,也可以克隆仓库后本地安装:git clone https://gitcode.com/gh_mirrors/subfi/subfinder验证安装。装完后命令行里多了一个subfinder可执行文件,输入帮助信息能看到就说明可用:subfinder -h第一次查找。把视频文件的完整路径作为参数传进去,它默认使用 shooter(射手字幕网)搜索:subfinder ~/Videos/奥本海默.2023.1080p.WEB-DL.mkv运行结束后,同目录下会多出字幕文件,文件名带一个数字编号,代表它的优先级。图:macOS 终端里运行 subfinder 命令,为单个视频文件查找并下载字幕的完整过程。核心用法:单片、整季与多字幕源搜索装好之后,按你要处理的对象挑对应用法即可,下面四种覆盖绝大多数情况。单个视频:直接传文件路径,如上一步所示。整季剧集:传目录路径,subfinder 会递归扫描所有子目录里的视频文件,逐集查找:subfinder ~/Videos/老友记.第七季指定多个字幕源:用-m传多个搜索器,它会按顺序尝试,只要第一个源找到字幕就不再问后面的:subfinder ~/Movies/流浪地球2.2023.2160p.UHD-BLURAY.mkv -m zimuku subhd注意:同时指定多个搜索器时不要再加-l语言参数,因为各源支持的语言代码不同,混用可能触发LanguageError。指定语言和格式:用-l和-e过滤结果。语言代码里zh_en是中英双语、zh_chs简体、zh_cht繁体、en英文;格式里ass支持特效样式,srt最通用:subfinder ~/Movies/奥本海默.2023.1080p.mkv -l zh_en zh_chs -e ass srt列表里排在前面的值优先级更高,编号也更靠前。另外,如果文件名不规范导致自动提取的关键词搜不到,用-k手动给关键词,例如subfinder ~/Videos/某片.2023.mkv -k 奥本海默 2023 诺兰。给资源管理器加一个查找字幕右键菜单不想记命令和路径,就把查找入口直接挂到文件管理器上,Windows 和 macOS 各有对应方案,一次配置永久生效。Windows:项目 assets 目录里提供了一个subfinder.reg注册表文件,双击导入后,在任意视频文件或文件夹上右键,菜单里就会出现查找字幕选项,点击即开始搜索。图:Windows 下右键点击视频文件夹,从查找字幕菜单项一键启动字幕搜索。macOS:用 Automator 的服务工作流实现同样的效果。把subfinder.workflow复制到~/Library/Services目录后,选中视频文件或文件夹,右键选择服务 → 查找字幕即可。注意工作流里写死的可执行文件路径是/usr/local/bin/subfinder,如果 subfinder 装在别处,需要先改一下工作流内容。图:macOS 上 Automator 服务的工作流配置界面,用于把字幕查找挂进右键菜单。图形界面:点三次按钮拿到字幕打包发布的可执行文件本质上是一个 GUI 应用:不带任何参数运行时,它会直接打开图形界面,适合完全不想碰终端的情况。图:Windows 版 Subfinder 图形界面,提供选择文件/选择目录与开始按钮。点击选择文件或选择目录按钮,选中目标视频或包含视频的文件夹;点击开始,界面里会滚动显示搜索进度;结束后在结果区域确认字幕文件已下载到视频旁边。图形界面默认同时使用 shooter 和 zimuku 两个搜索器来提高命中率,并且同样接受命令行里的那些参数,所以它并不比命令行模式功能少。进阶配置:语言偏好、排除规则与 API 地址这些设置只在默认行为不够用时才需要,平时可以完全跳过。subfinder 默认读取~/.subfinder.json配置文件(JSON 格式),其中的 key 与命令行参数一一对应,例如-m/--method对应method;命令行里显式指定的选项优先于配置文件。一份典型配置长这样,可以预置搜索源、语言偏好和排除规则:{ method: [shooter, zimuku], languages: [zh_en, zh_chs], exts: [ass, srt], video_exts: [.mp4, .mkv], exclude: [*trailer*, 花絮/], api_urls: { zimuku: http://www.zimuku.la/search, subhd: https://subhd.tv/search } }几个值得知道的细节:--exclude支持 shell 风格通配符,末尾带/表示匹配目录,例如--exclude *abc*/排除含 abc 的目录;记得加引号防止 shell 提前展开。--api_urls的意义在于:字幕库这类站点域名不太稳定,一旦换了域名,自己改一下 JSON 就能继续用,不必等发版。视频目录里已有字幕时,subfinder 默认跳过该文件;加--ignore可以无视已有字幕强制重查(会覆盖旧文件)。不想给字幕文件加数字编号,加--no-order-marker即可。常见问题:查不到字幕怎么排查查不到结果,或结果不对,基本都出在下面四个环节,按顺序排查即可。刚上映的新片搜不到:shooter 的索引依赖爬虫抓取,时效性有限,新片可能要等几天。这时换源试试:-m zimuku subhd。网站上有字幕却提示找不到:多半是文件名提取的关键词不够准,用-k手动指定关键词,或调整文件名让它包含片名、年份这类关键信息。下载的字幕语言不对:shooter 接口偶发要英文返回中文的情况,换搜索源通常能解决;也可以用-l zh_chs这类参数收紧语言范围。rar 压缩包解压失败:字幕库返回的字幕多为 zip/rar 压缩包,Windows 版内置了unrar.exe无需处理;Linux 和 macOS 需要自行安装,Debian/Ubuntu 用sudo apt install unrar,macOS 用brew install unrar。一个视频丢进去,字幕自动落在它旁边——这就是 subfinder 想替你干完的全部事情。项目把每个字幕源拆成独立的搜索器模块,想接入新的字幕网站,照subfinder/subsearcher/目录下的现有实现写一个新搜索器即可,这也是社区贡献最直接的切入点。【免费下载链接】subfinder字幕查找器项目地址: https://gitcode.com/gh_mirrors/subfi/subfinder创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考