/gfriends

媒体服务器演员头像仓库

Primary LanguagePython

女友头像仓库

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

目录

快速开始

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

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精准裁剪头像。

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

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

该 API 对免费用户的限制为 QPS=2，可满足正常使用需求。百度 AI 付费用户可选使用高速通道。

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

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

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

编辑 Config.ini 文件 “厂牌黑名单”，填入厂牌后，相应的头像将不会被获取。

上传新的头像图片到仓库

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

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

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

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

P.S. 如果您发现某些女友未自动匹配多语种姓名，请提交 issue 告诉我她的日文姓名和译名。

对女友仓库的开发及调用

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

基于 Python 的 Gfriends Inputer 官方工具和 JAVnfoMoviesImporter 第三方插件，基于 C# 的 JavScraper 第三方插件均已开源，可供阁下参考。

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 文件树 中搜索到对应女友，示例如下：

片 假 名：るいぺち
艺    名：妃月るい
英文译名：Hiduki Rui
素人佚名：Rui
简中译名：妃月由衣
繁中译名：妃月留衣
曾 用 名：川島今日子、如月るい、日向美月、森平みさき、石原美紀、紀月るい

Recycled 回收站

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

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

AI 技术的应用

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

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

CDN 加速的镜像仓库

鉴于 GitHub 在全球网络中的连通性不一，此全球可达的仓库镜像供阁下备用：https://gfriends.imfast.io/

受服务提供商业务调整影响，镜像仓库于 2020/12/31 关闭。

更新计划

✔ 自动定期抓取新入职女友头像至仓库（仅后述标注 🌟）
✔ 匹配多语种姓名（简体中文 / 繁体中文 / 日文）
✔ 匹配女友的多个艺名
✔ 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 10+ 加瀬エリナ、水谷心音、霧嶋りお、有村リア ➡360×360
BeFree 215×215 100+ つぼみ、浜崎真緒、安藤美奈子、坂口れな ➡430×430
痴女天堂 300×300 300+ 大槻ひびき、沖田杏梨、大浦真奈美、渚みつき ➡600×600
Fitch 300×392 500+ 春菜はな、美園和花、月森ゆの、河北はるな ➡600×786
Madonna 230×300 30+ 美森けい、谷花紗耶、桜井ゆみ、今井ひまり ➡792×800
溜池ゴロー 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. 作者保留最终决定权和最终解释权。

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