媒体服务器演员头像仓库。
旨在满足数量需求前提下，尽可能收集和处理高质量女友头像，并提供导入媒体服务器方案。
There is no correlation between this repo and Korean girl group GFRIEND.
对于一般用户来说，可以通过以下方案导入头像。
无需下载本仓库的女友头像，仅需下载 Gfriends Inputer 一键导入工具，编辑 Config.ini 文件并运行程序。
该工具将自动从本仓库搜索头像并导入你的服务器。
Gfriends Inputer 基础使用说明
Windows 用户 解压后直接运行可执行程序 Gfriends Inputer.exe
Mac / Linux 用户 解压后打开命令终端：运行 chmod +x "Gfriends Inputer" 来赋予权限，然后执行 ./"Gfriends Inputer" 启动程序
程序首次运行将自动生成配置文件 Config.ini。配置文件的必填项为 “媒体服务器的地址” 和 “API 密钥”。
媒体服务器 API 密钥的获取：进入 Emby / Jellyfin 控制台，高级 — API 密钥 — 新 API 密钥 ，根据提示即可生成 API 密钥。
命令: "Gfriends Inputer" [-h] [-c [CONFIG]] [-q] [-v]
选项说明:
-h, --help 显示本帮助信息。
-c [CONFIG], --config [CONFIG]
指定配置文件路径，默认为运行目录。
-q, --quiet 静默模式运行，并保存日志到文件。
-v, --version 显示当前版本。
或者试试安装插件导入？
由 JavScraper 提供
无需下载本仓库的女友头像，仅需为你的 Emby / Jellyfin 服务器安装 JavScraper 插件。
该插件将自动从本仓库搜索头像并导入你的服务器，亦提供了元数据刮削功能。
由 ddd354 提供
无需下载本仓库的女友头像，仅需为你的 Plex 服务器安装 JAVnfoMoviesImporter 插件。
该插件将自动从本仓库搜索头像并导入你的服务器，亦提供了元数据刮削功能。
本项目以抓取官方高质量大图为主要目标，头像图片为自动化抓取，部分人工筛选。
推荐搭配任一刮削整理项目 AVDC(GUI)、JavScraper、JAVSDT、JAVOneStop。
Gfriends Inputer v2.5 及后续版本支持导入本地头像到媒体服务器。
程序首次启动时会自动创建 Avatar 文件夹（可在配置文件中修改）。将本地头像图片重命名为演员姓名.jpg，或将第三方头像包移动至该文件夹。此后，导入工具优先从该文件夹查找并导入头像，本地路径中不存在的则会尝试从本仓库搜索并导入。
Gfriends Inputer v2.7 及后续版本支持使用百度AI精准裁剪头像。
此服务需使用中国大陆居民身份证进行实名认证、并理解同意百度智能云的 服务协议 、隐私政策 以及百度AI开放平台的 服务协议。
您可以在通过如下途径申请相关 API：
- 访问 https://ai.baidu.com 百度 AI 开放平台，登录并进入控制台。
- 进入 “人体分析” —— “创建应用”，按要求填写表单，并勾选 “人体分析” 接口。
- 进入 “人体分析” —— “管理应用”，获取
BD_App_ID、BD_API_Key、BD_Secret_Key。编辑Config.ini文件中百度AI API部分并运行程序。
Gfriends Inputer v2.73 及后续版本支持自定义头像来源。
在仓库中，可能收录了多张不同来源的同一女友头像。这时，默认根据头像质量及尺寸，自动选优后导入头像。
但是，每个人的喜好不同。比如，有的人可能不喜欢 Graphis 的头像，因为上面有标记女友名。有些人可能不喜欢 EBODY 的头像，因为女友衣着太暴露了。
编辑 Config.ini 文件 “厂牌黑名单”，填入厂牌后，相应的头像将不会被获取。具体厂牌名可以在下述 图片来源 或从 Content 目录获取。
欢迎提交优质的演员头像图片或写真。以下条件应 尽可能 满足：
- 对应演员头像缺失或现有头像不堪入目。
- 新头像是以女友为主体的特写或近景、近似 3:2 的长宽比，且宽度宜在 300px 以上。
如果您的图片符合上述要求，则可以通过如下步骤上传图片：
- 轻击主仓库右上角
Fork按钮，然后会自动克隆主仓库，并跳转到属于您的个人仓库。 - 移步至个人仓库
Content下的人工存储 HandStorage目录，该目录拥有最高优先级，能保证上传的图片被优先使用。 - 轻击
Add files菜单下的Upload files按钮，然后上传头像图片到仓库，图片应该以演员日文姓名.jpg来命名（请注意，仅支持jpg），女友仓库会自动匹配多语种姓名。在上传等待过程中，可以随便写一点Commit Changes说明，比如上传了哪些女友的图片。上传完成后轻击Commit提交。 - 进入
Pull Requests板块下，点击New Pull Requests发起新的合并请求。稍等片刻，待仓库自动检查完成后，点击Create Pull Requests并轻击Commit提交，请同时勾选Allow edits by maintainers。 - 至此，在经过人工审核和文件树自动刷新后，您的美图就可以和大家分享了。
P.S. 如果您发现某些女友未自动匹配别名，请提交 issue 告诉我她的日文姓名和别名。
您可以使用 文件检索 来搜索仓库中存储的头像文件，该功能仅支持日文名。
请务必先阅读 法律信息及免责声明
快速开始 所列出的工具均已开源，可供阁下在开发时参考。
位于根目录的Filetree.json，是 内容 Content 文件夹的 Json 文件树，在头像图片变化时自动更新。
该文件已按头像 质量升序 排列，可供程序调用搜索。以下是 Json 文件树 的格式示例：
{
"Content": {
"CompanyNameA": {
"ActorNameA.jpg": "AI-Fix-ActorNameA.jpg",
"ActorNameB.jpg": "ActorNameB.jpg"
},
"CompanyNameB": {
"ActorNameA.jpg": "AI-Fix-ActorNameA.jpg",
"ActorNameB.jpg": "ActorNameB.jpg"
},
}仓库已匹配女友的多语种姓名、艺名、片假名，甚至是素人佚名等别名。
使用任一姓名，均可在上述 Json 文件树 Filetree.json 中搜索到对应女友，示例如下：
艺 名：妃月るい
简中译名：妃月由衣
繁中译名：紀月留衣
片 假 名：るいぺち
罗马拼音：Hiduki Rui、Rui Hiduki
素人佚名：Rui
曾 用 名：川島今日子、如月るい、日向美月、森平みさき、石原美紀、紀月るい
回收站 Recycled 目录是通过 AI 鉴别并移除的违法头像（基于中国大陆法律）。
上述 Json 文件树中不包含该目录，如有调用该目录需求请自行遍历。
除了上述的通过 AI 鉴别并移除的违法头像，女友仓库还借助 AI 无损放大并优化的低质量头像图片、去除图片中的水印（如果有）。
女友仓库无法保证这些经优化的头像完美无瑕。若您不想调用获取到这些经 AI 优化的图片，只需删除文件树中的 AI-Fix- 前缀即可，仓库存储着未经 AI 处理的原始图片副本。
鉴于 GitHub 在全球网络中的连通性不一，此全球可达的仓库镜像供阁下备用：https://cdn.jsdelivr.net/gh/xinxin8816/gfriends/
该链接仅供调用，无法使用浏览器直接访问
女友仓库目前已趋于稳定，一段时间内不会有大型更新迭代。GfriendBot 将自动定期更新仓库内容。
✔ 自动定期抓取新入职女友头像至仓库（仅后述标注 🌟）
✔ 匹配多语种姓名（简体中文 / 繁体中文 / 日文）
✔ 匹配女友的多个艺名
✔ AI 放大并优化低分辨率头像（仅后述标注 ➡）
✔ AI 鉴别并移除违法违规头像
✔ AI 移除头像水印
排序不分前后，表格更新可能滞后。
标注🌟的图片为原生高质量大图，标注➡的图片为经过 AI 算法放大优化的图片。
除下表外，仓库中还收录了热心网友提供或上传的头像，位于 人工存储 HandStorage 目录，后述法律信息同样适用于此。
| 品牌 | 尺寸 | 数量 | 简介 | 备注 |
|---|---|---|---|---|
| GRAPHIS | 360×508 | 600+ | 知名的美女摄影写真机构 | 🌟 |
| Juicy Honey | 640×960 | 30+ | X-City 旗下的写真分支 | 🌟 |
| LovePop | 384×576 | 70+ | 美少女写真摄影机构 | 🌟 |
| FANZA | inconsistent | 1.5W+ | FANZA 官方（原DMM） | ➡ |
| Warashi | 250×300 | 2800+ | 来自法国的演员数据库 | ➡ |
| Javrave | inconsistent | 6800+ | 知名的演员资料数据库 | ➡ New Add! |
| Nanairo | 400×400 | 700+ | S-cute 旗下流媒体 | 🌟 New Add! |
| AVDBS | 380×460 | 800+ | 来自韩国的演员数据库 | ➡ New Add! |
| Derekhsu | inconsistent | 3700+ | 来自中国台湾的演员维基 | New Add! |
| 品牌 | 尺寸 | 数量 | 旗下知名小姐姐 | 备注 |
|---|---|---|---|---|
| S1 No. 1 Style | 470×600 | 300+ | 三上悠亜、羽咲みはる、桜羽のどか、架乃ゆら | 🌟 人气与美形著称 |
| MUTEKI | 640×906 | 50+ | 深山あすか、水瀬ちあき、松本菜奈実、夢川エマ | 🌟 |
| FaleNO | 1500×2125 | 10+ | 桥本有菜、吉高寧々、美乃すずめ、佐藤ゆか | 🌟 U-next 旗下公司 |
| Attackers | 216×270 | 1000+ | 明里つむぎ、岬ななみ、二宮ひかり、結城のの | ➡432×540 |
| Moodyz | 600x783 | 1300+ | 高桥しょう子、西宫このみ、伊东ちなみ、千早希 | 🌟 |
| Premium | 544x724 | 100+ | 樱木凛、星野美优、冬月枫、二宫沙树 | 🌟 |
| Idea Pocket | 300×300 | 100+ | 天海つばさ、相沢みなみ、桃乃木かな、希崎ジェシカ | ➡600×600 |
| KM Produce | 330×330 | 10+ | 川上优、麻生岬、麻仓忧、神咲诗织 | ➡660×660 |
| kawaii* | 640×896 | 300+ | ひなみちゃん、伊藤舞雪、宇佐木あいか、有栖るる | 🌟 |
| Prestige 蚊香社 |
119×170 | 200+ | 永瀬みなも、有村のぞみ、園田みおん、藤江史帆 | 绝对美少女制造商 ➡476×680 |
| 未満 | 290×390 | 100+ | あやみ旬果、さくらゆら、高岡美鈴、高梨ゆあ | ➡580×780 |
| 无垢 | 110×70 | 300+ | 河南実里、高杉麻里、本橋実来、大島美緒 | ➡440×280 |
| 桃太郎映像 | 451×600 | 200+ | 宝生リリー、泉りおん、入江愛美、阿部乃みく | 🌟 专业企划制造商 |
| えむっ娘ラボ | 168×191 | 200+ | 有坂深雪、有村のぞみ、笹倉杏、上原亜衣 | ➡336×382 |
| OPPAI | 312×364 | 100+ | 浜崎真緒、成海さやか、美緒みくる、柊るい | ➡624×728 |
| E-BODY | 702x900 | 500+ | Julia、红城まゆ、羽野理沙、蒂亚 | 🌟 |
| Wanz Factory | 280×280 | 200+ | 椎名そら、つぼみ、水野朝陽、浅井ルリ子 | ➡560×560 |
| Honnaka 本中 |
335×375 | 300+ | さわきりほ、さくらみゆき、つくしみか、あいだ飛鳥 | ➡670×750 |
| kira☆kira | 180×180 | 170+ | 加瀬エリナ、水谷心音、霧嶋りお、有村リア | ➡360×360 |
| BeFree | 215×215 | 100+ | つぼみ、浜崎真緒、安藤美奈子、坂口れな | ➡430×430 |
| 痴女天堂 | 300×300 | 300+ | 大槻ひびき、沖田杏梨、大浦真奈美、渚みつき | ➡600×600 |
| Fitch | 300×392 | 500+ | 春菜はな、美園和花、月森ゆの、河北はるな | ➡600×786 |
| Madonna | 230×420 | 1700+ | 美森けい、谷花紗耶、桜井ゆみ、今井ひまり | 🌟 |
| 溜池ゴロー | 100×100 | 500+ | めぐり、本田岬、かすみ果穂、さとう遥希 | MOODYZ 旗下公司 ➡400×400 |
| Das! | 280×280 | 300+ | あべみかこ、冴月りん、跡美しゅり、一ノ瀬梓 | ➡560×560 |
| ラグジュTV | 116×236 | 900+ | 藤本ゆうり、美園和花、浜崎真緒、あやみ旬果 | ➡332×472 |
鉴于女友仓库目前受众多为中国大陆地区用户，为积极配合中国大陆地区相关部门开展专项行动，女友仓库将依托于 AI 技术，尽最大可能鉴别和删除违规头像。在此呼吁广大用户自觉守法、相互监督，共同打造绿色健康的网络环境。
投诉邮箱：Gfriends#keemail.me
- 本项目作者旨在学习 Python 后端，提高编程水平。
- 项目仅用于技术、学术交流，严禁用于商业和其他盈利目的。
- 请自觉遵守当地法律法规，产生的一切后果由用户自行承担。
- 头像图片版权归相应网站及演员所属经纪公司所有。
- 作者保留最终决定权和最终解释权。
若您不同意上述任一条款，请勿直接或间接使用本项目。