AVDC

目录

• 1.简介
  
• 2.反馈
• 3.常见番号命名规范(必看!!!!!!!!!)
• 4.效果图
  • 界面截图
  • 文件结构
  • 媒体库
• 5.如何使用
  • 下载
  • 简明教程
  • 模块安装
  • 配置设置
• 6.工具
• 7.异常处理（重要）
• 8.关于群晖NAS
• 9.FAQ
• 10.故事
• 11.申明
• 12.写在后面

1.简介

命令行版(原作者)：

GUI版(本项目)：

主要功能

• 日本电影元数据 抓取工具 | 刮削器，配合本地影片管理软件EMBY,KODI，PLEX等管理本地影片，该软件起到分类与元数据抓取作用，利用元数据信息来分类，供本地影片分类整理使用。
  
• 可批量抓取，也可单个抓取。可抓取多集视频（-cd1/-cd2）,带字幕作品（-c., -C.）。
  
• 可抓取子目录下视频：遍历视频目录及子目录（除指定的排除目录），对遍历到的所有视频进行刮削，成功则同元数据、封面图一起输出到JAV_output目录，失败移入failed目录。
• 目前可抓取网站：jav321,javbus,javdb,avsox,fc2club,dmm,mgstage。
  
• 批量添加Emby演员头像。
  
• 封面可添加无码、字幕、流出水印。
  

2.反馈

• 欢迎使用体验,有程序BUG问题（带截图提问）、功能建议,可进电报群反馈 点击进群
  

3.常见番号命名规范

刮削前尽量命名规范！！！！ 不区分大小写

1、标准有码

• Javdb、Javbus、Jav321: SSNI-111
• Dmm: ssni00111

  2、无码

• Javdb、Javbus、Avsox: 111111-1111、111111_111、HEYZO-1111、n1111
• Ja321: HEYZO-1111

  3、素人

• Jav321、Mgstage: 259LUXU-1111
• Jav321、Javdb: LUXU-1111
• Fc2club: FC2-111111、FC2-PPV-111111

  4、欧美

• Javdb、Javbus: sexart.11.11.11(系列.年.月.日)

  5、自带字幕影片

  可以把电影命名为类似ssni-xxx-c.mp4,ssni-xxx-C.mp4，abp-xxx-CD1-C.mp4的规则。

  6、多集影片

  可以把多集电影按照集数后缀命名为类似ssni-xxx-cd1.mp4,ssni-xxx-cd2.mp4，abp-xxx-CD1-C.mp4的规则，只要含有-CDn/-cdn类似命名规则，即可使用分集功能.不支持-A -B -1 -2,容易跟字幕的-C混淆.

  7、多集、字幕顺序

  abp-xxx-CD1-C.mp4，分集在前，字幕在后，字幕必须与拓展名靠近，-C.mp4.

  8、外挂字幕文件

  字幕文件名必须与影片文件名一致，才可以一起移动到新目录，目前支持srt ass sub类型的字幕文件。

  9、流出影片

  影片文件名包含流出即可。

4.效果图

4.1.界面截图

主界面，设置，工具，关于

4.2.查看成功番号的信息(GIF演示)

4.3.文件结构

4.4.媒体库

以下为刮削、导入后的EMBY

5.如何使用

5.1.下载

• Release 的程序可脱离python环境运行，源码包需要 安装模块
  

• Release 下载地址(仅限Windows): 点击下载
  

• 源码包 下载地址(Windows,Linux,MacOS): 点击下载
  

• Windows Python环境: 点击前往 选中executable installer下载

• MacOS Python环境： 点击前往

• Linux Python环境：Linux用户懂的吧，不解释下载地址

5.2.简要教程:

• (1).运行AVDC.exe/AVDC_Main.py，配置设置页各项（配置方法请看以下教程）
  
• (2).把视频所在目录填在设置->目录设置->视频目录。
  
• (3).在主页面点击开始等待完成(出错请开调试模式后截图)
  
• (4).软件会自动把元数据获取成功的电影移动到成功输出目录中，根据演员分类，失败的电影移动到失败输出目录中（可选不移动）。
  
• (5).把JAV_output导入至KODI,EMBY,PLEX中。
  

5.3..模块安装

如果运行源码版，运行前请安装Python环境和安装以下模块

在终端/cmd/Powershell中输入以下代码来安装模块,两种方法任选其一。

• 5.3.1、批量从py-require.txt安装
  

  pip install -r py-require.txt
  

• 5.3.2、单个按需安装
  

  pip install requests
  pip install pyquery
  pip install lxml
  pip install Beautifulsoup4
  pip install pillow
  pip install pyqt5
  

5.4.配置设置

设置界面

普通设置

5.4.1.模式

1、刮削模式：通过番号刮削数据，包括元数据、封面图、缩略图、背景图。
2、整理模式：仅根据女优把电影命名为番号并分类到女优名称的文件夹下。

5.4.2.软链接模式

使用此模式，要以管理员身份运行。
刮削完不移动视频，而是在相应目录创建软链接（类似于快捷方式），方便PT下载完既想刮削又想继续上传的仓鼠党同志。
但是，只能在媒体库展示，不能在媒体库播放。

5.4.3.调试模式

输出番号的元数据，包括封面，导演，演员，简介等。

5.4.4.检测更新

点击开始后，检测是否有新版本。

5.4.5.保存日志

开启后日志保存在程序目录的Log目录下的txt文件内，每次运行会产生一个txt文件，txt文件可以删除，不影响程序运行。

5.4.6.失败后移动文件

如果刮削不到影片信息，可选择不移动视频，或者自动移动到失败输出目录中。

5.4.7.网站选择

可以使用所有网站，或者指定网站（jav321,avsox,javbus,dmm,javdb,fc2club，mgstage）进行刮削。
仅使用javdb进行刮削，尽量不要用，刮削30左右会被JAVDB封IP一段时间。

目录设置

5.4.8.命名规则

1、目录命名：存放视频数据的目录名，支持多层目录，支持自定义符号，例：[actor]/studio/number-【title】。
2、视频标题（媒体库中）：nfo中的标题命名。例：number-[title]。可以自定义符号。
3、视频标题（本地文件）：本地视频、图片的命名。例：number-[title]。可以自定义符号。
4、可选项为title（片名）、actor（演员）、studio（制作商）、director（导演）、release（发售日）、year（发行年份）、number（番号）、runtime（时长）、series（系列）、publisher（发行商）

5.4.9.目录设置

1、视频目录：要整理的视频的目录，带盘符的绝对路径，会遍历此目录下的所有视频，包括子目录中。
2、排除目录：在多层目录刮削时，排除所填目录。
3、视频、字幕类型：程序搜索不到想要的文件类型，可自行按格式添加。
4、失败输出目录：开启失败移动视频后，失败的视频会移动到此目录。
5、成功输出目录：刮削成功的视频，会在此目录创建文件夹，并移动视频、下载图片、写入nfo到此目录。

水印设置

5.4.10.水印设置

1、封面图、缩略图添加水印：可选择封面图、缩略图是否添加水印。
2、水印类型：可选择添加无码、字幕、流出三种水印。
3、首个水印位置：可选择添加左上、左下、右上、右下四个位置。
4、水印大小：有五个等级可调节。
5、说明：多个水印时，从首个水印开始顺时针添加。水印文件可自定义，要求长宽500x300、背景透明、png格式。

其它设置

5.4.11.代理设置

1、代理：设置本地代理地址和端口。代理软件开全局模式 ,使用DMM网站时需要使用日本代理。
2、超时重试设置：单位：秒，可选范围3-10。
3、连接重试次数：可选范围2-5。

5.4.12.排除设置

1、排除字符:指定字符删除，例如排除字符： \()，删除创建文件夹时的\()字符。
2、排除字符串:提取番号时，先删除指定字符串，提高成功率，字符串之间用','隔开。

5.4.13.无码封面

1、封面类型:可选官方(完整、不清晰)、裁剪(清晰、不完整)
2、说明:官方无图，会自动使用缩略图裁剪。

5.4.14.无码番号

添加HEYZO、n1111、111111-111、111111_111以外的无码番号前缀。例如S2M、SMD、LAF。

6.工具

工具界面 1、视频移动：可将视频目录下除排除目录下的所有视频以及同名字幕，移动到视频目录下的Movie_moved目录下。

2、单文件刮削：偶尔有失败情况时，选择这个视频文件，使用文件名当番号进行刮削。
  建议的使用流程：到某网站找到这个番号,把番号改成网站上的规范番号,选用对应的网站刮削。
  条件：文件名至少与一个网站上的番号相同，没有多余的内容只有番号为最佳，可以让软件更好获取元数据。
对于多影片重命名，可以用ReNamer来批量重命名

3、Emby批量添加头像：头像文件放在程序所在目录的Actor目录下，填写emby网址、api密钥即可使用。头像包下载
可查看有头像，无头像女优，可往emby添加头像的女优。

功能更强大、头像更丰富的头像仓库及上传工具 ===>>> GFriend头像库

4、裁剪封面：针对封面图比例错误，分辨率低的情况，判断人脸位置，裁剪缩略图(thumb)为封面图(poster)。

7.异常处理（重要）

7.1.关于软件打不开

• 请确保软件是完整的！，AVDC.exe，ACDV-ico.png,config.ini需要在同一目录下，确保ini文件内容是和下载提供ini文件内容的一致的！
  

7.2.关于软件闪退

• 尝试重新运行
  
• 还解决不了，查看log日志，尝试以下7.3、7.4解决
  

7.3.网络错误

* (1).报Connect Failed! Please check your Proxy or Network!错误

* (2).报Updata_check 和 JSON 相关的错误

* (3).关于Nonetype,xpath报错

* (4).关于KeyError报错

• 上述错误都可能是代理问题，尝试以下办法解决:
  • 使用DMM，如不是日本代理，请更换日本代理，确保可以打开这个网址
    
  • 把代理设置中的代理：后面的地址和端口删除
    
  • 开启代理软件全局模式
    

7.4.关于番号提取失败或者异常

• 查看命名是否符合常见番号命名规范。
  
• 目前可以提取信息的网址:JAV321、JAVBUS、JAVDB、AVSOX、dmm、FC2CLUB、mgstage，请确保视频名能在这些网站找到
  
• 使用工具页里的单个视频刮削，选择刮削网站，进行刮削。
  

7.5.PLEX不显示封面

请安装插件：XBMCnfoMoviesImporter

8.关于群晖NAS

开启SMB在Windows上映射为本地磁盘(要分配盘符)即可使用本软件，也适用于其他NAS

9.FAQ

9.1.这软件能下片吗？

• 该软件不提供任何影片下载地址，仅供本地影片分类整理使用。

  9.2.什么是元数据？

• 元数据包括了影片的：封面，导演，演员，简介，类型......

  9.3.软件收费吗？

• 软件永久免费。除了作者钦点以外

  9.4.软件运行异常怎么办？

• 认真看 异常处理（重要）

10.故事

点击跳转至原作者博客文章

11.申明

当你查阅、下载了本项目源代码或二进制程序，即代表你接受了以下条款

• 本软件仅供技术交流，学术交流使用

• 请勿在热门的社交平台上宣传此项目

• 本软件作者编写出该软件旨在学习 Python ，提高编程水平

• 本软件不提供任何影片下载的线索

• 用户在使用本软件前，请用户了解并遵守当地法律法规，如果本软件使用过程中存在违反当地法律法规的行为，请勿使用该软件

• 用户在使用本软件时，若用户在当地产生一切违法行为由用户承担

• 严禁用户将本软件使用于商业和个人其他意图

• 源代码和二进制程序请在下载后24小时内删除

• 本软件作者yoshiko2保留最终决定权和最终解释权

• 若用户不同意上述条款任意一条，请勿使用本软件

  When you run the software, you accept the following terms

• This software is only for technical exchange and academic exchange

• Please do not promote this project on popular social platforms

• The software author wrote this software to learn Python and improve programming

• This software does not provide any clues for video download

• Before using this software, please understand and abide by local laws and regulations. If there is any violation of local laws and regulations during the use of this software, * please do not use this software

• When the user uses this software, if the user has any illegal acts in the local area, the user shall bear

• It is strictly forbidden for users to use this software for commercial and personal intentions

• Please delete the source code and binary program within 24 hours after downloading

• The author of this software yoshiko2 reserves the right of final decision and final interpretation

• If the user does not agree with any of the above terms, please do not use this software

  このソフトウェアを実行すると、次の条件に同意したことになります

• このソフトウェアは、技術交換、学術交換専用です。

• 人気のソーシャルプラットフォームでこのプロジェクトを宣伝しないでください

• ソフトウェアの作成者は、Pythonを学習してプログラミングを改善するためにこのソフトウェアを作成しました

• このソフトウェアは、ビデオダウンロードの手がかりを提供しません

• 本ソフトウェアを使用する前に、現地の法令を理解し、遵守してください本ソフトウェアの使用中に現地の法令に違反する場合は、本ソフトウェアを使用しないでください

• 本ソフトウェアをご利用の際、地域で違法行為を行った場合は、お客様の負担となります。

• ユーザーがこのソフトウェアを商業的および個人的な目的で使用することは固く禁じられています

• ダウンロード後24時間以内にソースコードとバイナリプログラムを削除してください

• このソフトウェアの作者yoshiko2は、最終決定および最終解釈の権利を留保します。

• ユーザーが上記の条件のいずれかに同意しない場合は、このソフトウェアを使用しないでください

12.写在后面

怎么样，看着自己的日本电影被这样完美地管理，是不是感觉成就感爆棚呢?