Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Sign up
Appearance settings

hyperq/jav

Repository files navigation

🎬 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

About

🎬 A beautiful Rust TUI client for JavBus — search, browse, preview images in terminal (Kitty protocol), manage favorites & push magnets to 115 cloud. Catppuccin Frappé theme.

Topics

Resources

License

Stars

Watchers

Forks

Packages

Contributors

Languages

AltStyle によって変換されたページ (->オリジナル) /