README_EN.md

🎬 JAV TUI

A beautiful terminal client for JavBus with image preview support

🇨🇳 中文文档

---

✨ Features

	Feature	Description
🔍	Movie Search	Search by keyword, number, censored/uncensored
👩	Actress Browser	Grid view with avatars, search by name or code
🖼️	Image Preview	Native terminal images via Kitty graphics protocol
🧲	Smart Magnets	Auto-sort by subtitle > HD > size, one-key copy to clipboard
✅	Multi-select	Select across searches, batch export magnets
📋	History & Favorites	Persistent with SQLite, cover image cache
☁️	115 Cloud	QR login, push magnets to 115 offline download
▶️	115 Playback	One-key play from 115 cloud via IINA / mpv / VLC
🎨	Theme	Catppuccin Frappé (Dark) / Latte (Light) / Auto-detect terminal
⚙️	Configurable	Toggle images, sort preferences, player choice, all in SQLite

🚀 Install

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

From source:

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

📖 Usage

# Basic
jav

# With proxy
jav --proxy socks5://127.0.0.1:1080

# Custom site
jav --base https://www.javbus.com

⌨️ Keybindings

🔍 Search

Key	Action
f	Search movies
F	Search actresses
S	Actress code direct (e.g. okq)
N	Jump to page number

🧭 Navigation

Key	Action
j / k	Up / Down
h / l	Left / Right (grid columns)
Enter	Open detail
Tab	Switch panel
n	Load more
Scroll	Mouse scroll
Click	Click to select

📦 Actions

Key	Action
Space	Toggle select
a	Select all
g	Grab best magnet (copy to clipboard)
e	Export magnets to file
s	Toggle favorite

☁️ 115 Cloud

Key	Action
L	QR code login
d	Download current to 115
D	Batch download selected
P	Play from 115 cloud (auto-submit if needed)

🛠️ Other

Key	Action
c	Settings (images, sorting, player, theme)
~	Toggle log panel
q	Quit

▶️ 115 Cloud Playback

Press P on a movie detail page to play directly from 115 cloud:

1. Auto-submit — If the magnet hasn't been submitted to 115, it's submitted automatically
2. Wait for download — Polls task status with real-time progress display
3. Smart fallback — If task exists but not in recent list, searches 115 cloud by movie number
4. Launch player — Opens your configured player (IINA / mpv / VLC) with authenticated CDN URL
5. First-time setup — Prompts player selection on first use, remembered in settings

📁 Data

All data stored in ~/.jav/:

~/.jav/
├── data.db          # SQLite: history, favorites, config, magnets
├── cache/           # Image cache (thumbnails, covers, avatars)
└── 115_cookie.json  # 115 cloud login session

🖥️ Terminal Support

Terminal	Images	Status
Ghostty	✅ Kitty protocol	Recommended
Kitty	✅ Native	Full support
WezTerm	✅ Kitty protocol	Full support
iTerm2	❌	Text-only mode
Alacritty	❌	Text-only mode
Terminal.app	❌	Text-only mode

Unsupported terminals automatically fall back to text-only mode. Theme auto-detects light/dark from your terminal background.

🔗 Community

• LinuxDO — Tech community for open-source enthusiasts

📄 License

MIT © hyperq