🎬 JAV TUI

JavBus 终端客户端 — 搜索影片、浏览女优、管理磁力链接，支持终端内图片预览

🇺🇸 English

---

✨ 功能

	功能	说明
🔍	影片搜索	按关键词、番号搜索，支持有码/无码切换
👩	女优浏览	网格视图带头像，按名字或代号搜索
🖼️	图片预览	通过 Kitty 图形协议在终端内显示真实图片
🧲	智能磁链	自动排序：字幕 > 高清 > 文件大小，一键复制到剪贴板
✅	多选	跨搜索选择，批量导出磁力链接
📋	历史 & 收藏	SQLite 持久化，封面图片缓存
☁️	115 网盘	扫码登录，推送磁力到 115 离线下载
▶️	115 播放	一键从 115 云盘播放，支持 IINA / mpv / VLC
🎨	主题切换	Catppuccin Frappé (深色) / Latte (浅色) / 自动跟随终端
⚙️	可配置	图片开关、排序偏好、播放器选择，全部存 SQLite

🚀 安装

macOS / Linux：

curl -fsSL https://raw.githubusercontent.com/hyperq/jav/master/install.sh | sh

Windows (PowerShell)：

irm https://raw.githubusercontent.com/hyperq/jav/master/install.ps1 | iex

从源码编译：

git clone https://github.com/hyperq/jav.git
cd jav
cargo build --release
cp target/release/jav ~/.local/bin/

📖 使用

# 直接运行
jav

# 使用代理
jav --proxy socks5://127.0.0.1:1080

# 自定义站点
jav --base https://www.javbus.com

⌨️ 快捷键

🔍 搜索

按键	功能
f	搜索影片
F	搜索女优
S	女优代号直达（如 okq）
N	跳转到指定页

🧭 导航

按键	功能
j / k	上 / 下
h / l	左 / 右（网格列）
Enter	打开详情
Tab	切换面板
n	加载更多
滚轮	鼠标滚动
点击	点击选中

📦 操作

按键	功能
空格	切换选中
a	全选/取消全选
g	获取最佳磁链（复制到剪贴板）
e	导出磁力链接到文件
s	收藏/取消收藏

☁️ 115 网盘

按键	功能
L	扫码登录
d	推送当前到 115 离线下载
D	批量推送选中到 115
P	从 115 云盘播放（自动提交+等待+播放）

🛠️ 其他

按键	功能
c	设置（图片、排序、播放器、主题）
~	显示/隐藏日志
q	退出

▶️ 115 云盘播放

在影片详情页按 P 一键播放：

1. 自动提交 — 磁链未提交到 115 时自动提交
2. 等待下载 — 实时显示下载进度
3. 智能回退 — 任务不在最近列表时，按番号搜索 115 云盘
4. 启动播放器 — 打开配置的播放器（IINA / mpv / VLC），自带认证直链
5. 首次设置 — 第一次按 P 弹出播放器选择，之后自动记住

📁 数据

所有数据存储在 ~/.jav/：

~/.jav/
├── data.db          # SQLite：历史、收藏、配置、磁链缓存
├── cache/           # 图片缓存（缩略图、封面、头像）
└── 115_cookie.json  # 115 网盘登录会话

🖥️ 终端支持

终端	图片	状态
Ghostty	✅ Kitty 协议	推荐使用
Kitty	✅ 原生支持	完全支持
WezTerm	✅ Kitty 协议	完全支持
iTerm2	❌	纯文本模式
Alacritty	❌	纯文本模式
Terminal.app	❌	纯文本模式

不支持图片的终端会自动切换到纯文本模式。 主题会自动检测终端背景色，选择深色或浅色配色。

🔗 社区

• LinuxDO — 开源技术爱好者社区

📄 协议

MIT © hyperq