/gfriends

媒体服务器演员头像仓库

Primary LanguagePython

Gfriends 女友头像仓库

TotalNumber AutoUpdate GfriendBot
媒体服务器演员头像仓库。
旨在满足数量需求前提下，尽可能收集和处理高质量女友头像，并提供导入媒体服务器方案。

There is no correlation between this repo and Korean girl group GFRIEND.

目录

快速开始

对于一般用户来说，可以通过以下方案导入头像。

Emby / Jellyfin

无需下载本仓库的女友头像，仅需下载 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 插件。
该插件将自动从本仓库搜索头像并导入你的服务器，亦提供了元数据刮削功能。

Plex

由 ddd354 提供

无需下载本仓库的女友头像，仅需为你的 Plex 服务器安装 JAVnfoMoviesImporter 插件。
该插件将自动从本仓库搜索头像并导入你的服务器，亦提供了元数据刮削功能。

进阶说明

本项目以抓取官方高质量大图为主要目标，头像图片为自动化抓取，部分人工筛选。

推荐搭配任一刮削整理项目 AVDC(GUI)、JavScraper、JAVSDT、JAVOneStop。

导入本地头像图片到媒体服务器

Gfriends Inputer v2.5 及后续版本支持导入本地头像到媒体服务器。

程序首次启动时会自动创建 Avatar 文件夹（可在配置文件中修改）。将本地头像图片重命名为演员姓名.jpg，或将第三方头像包移动至该文件夹。此后，导入工具优先从该文件夹查找并导入头像，本地路径中不存在的则会尝试从本仓库搜索并导入。

使用百度AI精准裁剪头像

Gfriends Inputer v2.7 及后续版本支持使用百度AI精准裁剪头像。

此服务需使用**大陆居民身份证进行实名认证、并理解同意百度智能云的 服务协议 、隐私政策 以及百度AI开放平台的 服务协议。

您可以在通过如下途径申请相关 API：

  1. 访问 https://ai.baidu.com 百度 AI 开放平台，登录并进入控制台。
  2. 进入 “人体分析” —— “创建应用”，按要求填写表单，并勾选 “人体分析” 接口。
  3. 进入 “人体分析” —— “管理应用”，获取 BD_App_ID、BD_API_Key、BD_Secret_Key。编辑 Config.ini 文件中 百度AI API 部分并运行程序。

自定义头像来源（不导入某些来源的头像）

Gfriends Inputer v2.73 及后续版本支持自定义头像来源。

在仓库中，可能收录了多张不同来源的同一女友头像。这时，默认根据头像质量及尺寸，自动选优后导入头像。
但是，每个人的喜好不同。比如，有的人可能不喜欢 Graphis 的头像，因为上面有标记女友名。有些人可能不喜欢 EBODY 的头像，因为女友衣着太暴露了。

编辑 Config.ini 文件 “厂牌黑名单”，填入厂牌后，相应的头像将不会被获取。具体厂牌名可以在下述 图片来源 或从 Content 目录获取。

上传新的头像图片到仓库

欢迎提交优质的演员头像图片或写真。以下条件应 尽可能 满足：

  1. 对应演员头像缺失或现有头像不堪入目。
  2. 新头像是以女友为主体的特写或近景、近似 3:2 的长宽比，且宽度宜在 300px 以上。

如果您的图片符合上述要求，则可以通过如下步骤上传图片：

  1. 轻击主仓库右上角 Fork 按钮，然后会自动克隆主仓库，并跳转到属于您的个人仓库。
  2. 移步至个人仓库 Content 下的 人工存储 HandStorage 目录，该目录拥有最高优先级，能保证上传的图片被优先使用。
  3. 轻击 Add files 菜单下的 Upload files 按钮，然后上传头像图片到仓库，图片应该以演员日文姓名.jpg来命名（请注意，仅支持jpg），女友仓库会自动匹配多语种姓名。在上传等待过程中，可以随便写一点 Commit Changes 说明，比如上传了哪些女友的图片。上传完成后轻击 Commit 提交。
  4. 进入 Pull Requests 板块下，点击 New Pull Requests 发起新的合并请求。稍等片刻，待仓库自动检查完成后，点击 Create Pull Requests 并轻击 Commit提交，请同时勾选 Allow edits by maintainers。
  5. 至此，在经过人工审核和文件树自动刷新后，您的美图就可以和大家分享了。

P.S. 如果您发现某些女友未自动匹配别名，请提交 issue 告诉我她的日文姓名和别名。
您可以使用 文件检索 来搜索仓库中存储的头像文件，该功能仅支持日文名。

对女友仓库的开发及调用

请务必先阅读 法律信息及免责声明

快速开始 所列出的工具均已开源，可供阁下在开发时参考。

Json 文件树

位于根目录的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
曾 用 名：川島今日子、如月るい、日向美月、森平みさき、石原美紀、紀月るい

Recycled 回收站

回收站 Recycled 目录是通过 AI 鉴别并移除的违法头像（基于**大陆法律）。

上述 Json 文件树中不包含该目录，如有调用该目录需求请自行遍历。

AI 技术的应用

除了上述的通过 AI 鉴别并移除的违法头像，女友仓库还借助 AI 无损放大并优化的低质量头像图片、去除图片中的水印（如果有）。

女友仓库无法保证这些经优化的头像完美无瑕。若您不想调用获取到这些经 AI 优化的图片，只需删除文件树中的 AI-Fix- 前缀即可，仓库存储着未经 AI 处理的原始图片副本。

CDN 加速的镜像仓库

鉴于 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

法律信息及免责声明

  1. 本项目作者旨在学习 Python 后端，提高编程水平。
  2. 项目仅用于技术、学术交流，严禁用于商业和其他盈利目的。
  3. 请自觉遵守当地法律法规，产生的一切后果由用户自行承担。
  4. 头像图片版权归相应网站及演员所属经纪公司所有。
  5. 作者保留最终决定权和最终解释权。

若您不同意上述任一条款，请勿直接或间接使用本项目。