Javinizer GUI使用手册：可视化界面操作与批量处理技巧

Javinizer是一款强大的日本成人视频(JAV)库管理工具，专门设计用于自动整理、分类和丰富本地JAV视频文件的元数据。这款开源工具通过直观的可视化界面，让用户能够轻松管理庞大的视频收藏库。Javinizer GUI版本提供了比命令行更友好的操作体验，特别适合新手和普通用户进行批量处理和媒体库管理。

🚀 Javinizer GUI快速入门指南

安装Javinizer可视化界面

Javinizer GUI提供两种安装方式，满足不同用户的需求：

Docker安装（推荐）

Docker是最简单快捷的安装方式，只需一条命令即可启动：

docker run --name javinizer -p 8600:8600 -d javinizer/javinizer:latest

安装完成后，访问http://localhost:8600即可进入Javinizer图形界面。

Windows本地安装

对于Windows用户，可以通过PowerShell进行安装：

# 以管理员身份运行PowerShell Javinizer -InstallGUI Javinizer -OpenGUI

首次访问配置

首次访问Javinizer GUI时，如果遇到/not-running页面，只需移除URL中的该部分并刷新页面即可。如果问题依旧，可以访问管理页面http://localhost:8600/admin进行配置。

📊 Javinizer GUI核心功能详解

1. 批量排序功能

Javinizer GUI的核心功能是批量整理视频文件。通过可视化界面，您可以轻松：

• 选择输入目录：指定未整理的视频文件所在位置
• 设置输出目录：定义整理后的文件存储位置
• 配置排序规则：自定义文件命名和文件夹结构
• 预览排序结果：在应用更改前查看整理效果

2. 智能元数据抓取

Javinizer支持从多个来源自动获取视频元数据：

• JAVLibrary：最全面的JAV数据库
• R18：官方成人视频网站
• DMM/FANZA：日本最大的成人内容平台
• JAVBus：中文用户友好的数据库

在GUI设置中，您可以灵活选择数据源优先级，确保获取最准确的元数据。

3. 手动搜索功能

当自动识别失败时，Javinizer GUI提供手动搜索功能：

1. 在文件列表中选择需要搜索的视频
2. 点击"手动搜索"按钮
3. 输入视频编号或关键词
4. 从搜索结果中选择正确的匹配项

4. 演员信息管理

Javinizer能够自动识别和管理演员信息：

• 演员图片下载：自动下载演员头像
• 演员别名处理：支持多种语言名称
• 演员分组：按演员整理视频文件

5. Emby/Jellyfin集成

Javinizer与主流媒体服务器完美兼容：

• 自动生成NFO文件：创建标准的XML元数据文件
• 封面和海报：下载高质量封面图片
• 分类标签：自动添加流派和标签信息


🔧 Javinizer GUI高级配置技巧

文件匹配规则设置

在src/Javinizer/jvSettings.json配置文件中，您可以自定义文件匹配规则：

"match.includedfileextension": [ ".mp4", ".mkv", ".avi", ".wmv" ], "match.regex": "([a-zA-Z|tT28]+-\\d+[zZ]?[eE]?)(?:-pt)?(\\d{1,2})?"

文件夹结构自定义

Javinizer支持灵活的文件夹命名规则：

"sort.format.folder": "<ID> [<STUDIO>] - <TITLE> (<YEAR>)", "sort.format.outputfolder": ["<ACTORS>", "<YEAR>"]

这样的配置会生成按演员和年份分组的清晰目录结构。

元数据优先级配置

您可以根据个人偏好设置不同数据源的优先级：

"sort.metadata.priority.title": [ "r18dev", "javlibrary", "javbus", "mgstageja", "aventertainment" ]

💡 实用技巧与最佳实践

批量处理优化建议

1. 分批处理：对于大量文件，建议分批处理以避免网络请求超时
2. 网络路径配置：如果文件存储在NAS或网络共享中，需要在管理员权限下挂载网络驱动器
3. 代理设置：在中国大陆使用时，建议配置代理以确保正常访问数据源

常见问题解决

Q: GUI无法启动怎么办？A: 检查PowerShell Universal服务是否正常运行，访问http://localhost:8600/admin查看服务状态。

Q: 文件匹配失败怎么办？A: 检查文件命名是否符合规范，或调整正则表达式匹配规则。

Q: 元数据抓取不完整怎么办？A: 尝试启用更多数据源，或使用手动搜索功能补充信息。

操作历史记录

Javinizer GUI会记录所有操作历史，方便追踪和回滚：

🎯 高效工作流程示例

日常整理流程

1. 准备阶段：将新下载的视频放入指定输入目录
2. 批量处理：在GUI中选择目录并开始排序
3. 质量检查：查看生成的NFO文件和图片质量
4. 媒体库更新：将整理好的文件导入Emby或Jellyfin

批量重命名场景

当您需要统一整理不同来源的视频文件时：

1. 使用dashboard/pages/1.0 sort.ps1中的批量处理功能
2. 配置统一的命名规则
3. 应用更改并验证结果
4. 使用历史记录功能跟踪变更

📈 性能优化建议

网络设置优化

• 调整请求间隔：在设置中增加"sleep": 5减少被封风险
• 启用代理：对于访问受限地区，配置代理服务器
• 选择稳定数据源：优先使用响应速度快的网站

存储优化

• 图片质量设置：根据需要调整下载的图片分辨率
• 缓存管理：定期清理临时文件和历史记录
• 备份配置：定期备份jvSettings.json配置文件

🔍 高级功能探索

JSON元数据编辑

对于高级用户，Javinizer GUI提供JSON编辑器，可以直接修改元数据：

管理面板功能

通过管理面板，您可以：

• 查看系统日志
• 管理用户权限
• 监控处理进度
• 配置系统参数

🎉 结语

Javinizer GUI通过直观的可视化界面，将复杂的JAV视频库管理变得简单高效。无论您是拥有几十部还是几千部视频的收藏家，这款工具都能帮助您建立整洁、有序的媒体库。通过本文介绍的技巧和最佳实践，您可以充分发挥Javinizer的潜力，享受自动化整理的便利。

记住，良好的整理习惯是高效管理数字资产的关键。现在就开始使用Javinizer GUI，让您的JAV视频库焕然一新吧！✨

提示：更多详细配置和高级功能，请参考项目文档中的配置文件示例和API说明。