适用于 Emby/Jellyfin 的媒体服务器头像导入工具，Gfriends 女友头像仓库 衍生项目。
There is no correlation between this repo and Korean girl group GFRIEND.
请在 Release 下载并解压 Gfriends Inputer 程序压缩包。
提示：程序可以连接远程媒体服务器，因此请选择自己顺手的系统。
进入 Emby / Jellyfin 控制台，高级 — API 密钥 — 新 API 密钥 ，根据提示即可生成 API 密钥。
Mac / Windows 用户 直接运行可执行程序 Gfriends Inputer.exe
Linux 用户 打开命令终端：运行 chmod x "Gfriends Inputer" 来赋予权限，然后执行 ./"Gfriends Inputer" 启动程序
程序首次运行将自动生成配置文件 Config.ini，配置文件的必填项为 媒体服务器的地址 和获取的 API 密钥。
提示：v2.x 旧版本的 Mac/Linux 配置文件在用户根目录，常见在：/Users/username/、/home/username/、/root/
CLI 命令: "Gfriends Inputer" [-h] [-c [CONFIG]] [-q] [-v]
选项说明:
-c [CONFIG], --config [CONFIG]
指定配置文件路径，默认为运行目录。
-h, --help 显示本帮助信息。
-q, --quiet 开启静默模式，不打印任何信息。
--skip-update 跳过更新检查，强制运行旧版本。
--debug 输出调试日志，即使配置文件未开启调试模式。
-v, --version 显示当前版本。
您亦可在 Python 3.6 及以上版本环境下直接运行源码
git clone https://github.com/gfriends/gfriends-inputer.git
cd ./gfriends-inputer
pip install -r requirements.txt
python3 "./Gfriends Inputer.py"
按需完成进阶配置有助于提升使用体验。
仓库中的头像可能尺寸不标准，媒体服务器会自动拉伸使头像变形，这时需要裁剪头像。虽很少遇到这种情况，但为避免裁剪到演员面部，您应当配置 AI 精准裁剪。
1. OpenCV DNN AI
Gfriends Inputer v3.0 及后续版本支持
默认开启，无需配置。OpenCV 提供本地无感知的人脸识别，兼具准确度与速度且无需联网。
2. 百度 AI
Gfriends Inputer v2.7 及后续版本支持
此服务需使用中国大陆居民身份证进行实名认证、并理解同意百度智能云的 服务协议 、隐私政策 以及百度AI开放平台的 服务协议。
您可以在通过如下途径申请相关 API：
- 访问 https://ai.baidu.com 百度 AI 开放平台，登录并进入控制台。
- 进入 “人体分析” —— “创建应用”，按要求填写表单，并勾选 “人体分析” 接口。
- 进入 “人体分析” —— “管理应用”，获取
BD_App_ID、BD_API_Key、BD_Secret_Key，并编辑配置文件中百度AI API部分。
Gfriends Inputer v3.0 及后续版本支持
仅需在配置文件中开启。程序会在下载头像后，顺便搜索女友的个人信息（生日、三围、身高等），然后一并导入服务器。
Gfriends Inputer v2.6 及后续版本支持
在首次运行测试无误后，您可以把命令写入 Crontab 任务，来定时后台运行程序。
#每天零点运行，不输出日志
0 0 * * * "/home/user/gfriends Inputer"
#周一零点运行，输出日志，并指定配置文件路径
0 0 * * 0 "/home/user/gfriends Inputer" -q -c "/home/user/config.ini"
Gfriends Inputer v2.5 及后续版本支持
程序首次启动时会自动创建 Avatar 文件夹（可在配置文件中修改）。将本地头像图片重命名为演员姓名.jpg，或将第三方头像包移动至该文件夹。此后，导入工具优先从该文件夹查找并导入头像，本地路径中不存在的则会尝试从 Gfriends 仓库搜索并导入。
在仓库中，可能收录了多张不同来源的同一女友头像。这时，默认根据头像质量及尺寸，自动选优后导入头像。
但是，每个人的喜好不同。比如，有的人可能不喜欢 Graphis 的头像，因为上面有标记女友名。有些人可能不喜欢 EBODY 的头像，因为女友衣着太暴露了。
1. 手动选择头像
Gfriends Inputer v3.0 及后续版本支持
仅需在配置文件中开启。程序在遇到多头像时，自动下载对应演员的所有头像，您可以手动删除不喜欢的头像。
2. 厂牌黑名单
Gfriends Inputer v2.x 支持
编辑配置文件的 厂牌黑名单，填入厂牌后，相应的头像将不会被获取。具体厂牌名可以在主仓库 图片来源 或 Content 目录获取。
推荐与 Gfriends Inputer 搭配刮削整理项目，神兵利器助您事半功倍。
Movie Data Capture：本地电影元数据刮削器。
衍生项目：AVDC GUI、MDCx
JavScraper：一个 Jellyfin/Emby 的日本电影刮削器插件，可以从某些网站抓取影片信息。
Javtube：另一个为 Jellyfin/Emby 开发的超级好用的 JAV 插件。（部分开源）
JAVSDT：日本影片标准化工具。（已闭源）
JAVOneStop：一站 JAV，All-in-One 的 JAV 处理工具。
您知道其他相似的开源工具？欢迎提交 issues 告诉我。
本项目授权在 MIT 许可下，此外：
- 项目仅用于技术、学术交流，严禁用于商业和其他盈利目的。
- 请自觉遵守当地法律法规，产生的一切后果由用户自行承担。
- 作者保留最终决定权和最终解释权。
若您不同意上述任一条款，请勿直接或间接使用本项目。