媒体服务器演员头像仓库。
旨在满足数量需求前提下,尽可能收集和处理高质量女友头像,并提供导入媒体服务器方案。
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
曾 用 名:川島今日子、如月るい、日向美月、森平みさき、石原美紀、紀月るい
回收站 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 后端,提高编程水平。
- 项目仅用于技术、学术交流,严禁用于商业和其他盈利目的。
- 请自觉遵守当地法律法规,产生的一切后果由用户自行承担。
- 头像图片版权归相应网站及演员所属经纪公司所有。
- 作者保留最终决定权和最终解释权。
若您不同意上述任一条款,请勿直接或间接使用本项目。