An extremely handy AV searcher and downloader, written in Rust. A gift to my bro Mr.Fu

Inspired by the style of astral-sh/uv.

• 🚀 One tool for search, details, listing, and downloading
• ⚡️ Async scraping for fast responses (JavDB first, Sukebei as fallback and magnet merge)
• 🧾 --json output for scripting and automation
• 🧲 Picks the magnet with the highest seeders for download
• 🖥️ Cross-platform (macOS / Linux / Windows) with optional aria2c integration

One-line install (from Releases):

curl -fsSL https://raw.github.com/auv-sh/av/master/install.sh | sh

Build from source (Rust stable toolchain required):

git clone <your-repo-url> av && cd av
cargo build --release
./target/release/av --help

Optional: add to PATH

sudo cp target/release/av /usr/local/bin/

Optional downloader dependency:

• Install aria2c for a more controllable download experience
  • macOS: brew install aria2
  • Linux/Windows: use your package manager
• Without aria2c, the system default magnet handler is used (macOS: open / Linux: xdg-open / Windows: start)

# Search (actor or code), table output by default
av search 三上悠亞
av search FSDSS-351 --json

# Show details (rich fields when available)
av detail FSDSS-351

# List all codes for an actor (table + total)
av list 橋本ありな
av ls 橋本ありな    # alias of list

# Show the latest releases (default 20; use --limit)
av top --limit 30

# Only show uncensored entries (works with search/list/top)
av search 三上悠亞 --uncen
av list 橋本ありな -u
av top --limit 30 --uncen

# Actors ranking (with pagination)
av actors --page 1 -n 50
av actors --uncen --page 3 -n 30

# Get magnet links (alias: get)
av install FSDSS-351
av get FSDSS-351

# Open in browser to watch
av view FSDSS-351
av see FSDSS-351    # alias of view

# Update to the latest version
av update

av search <keyword> [--json]

• Supports both actor names and codes
• Non-JSON uses a table: # / Code / Title, with a total count on top
• Supports uncensored-only filter: --uncen (alias -u)

av detail <code> [--json]

Displays when available:

• Code, Title, Actors, Release date, Cover
• Plot, Duration, Director, Studio, Label, Series, Genres, Rating
• Preview images
• Magnet count and a few sample links

av list <actor> [--json]
av ls <actor> [--json]    # alias of list

• Lists all codes for an actor; shows a table with total count
• Supports uncensored-only filter: --uncen (alias -u)

av top [--limit N] [--json]

• Lists latest titles from JavDB (most recent first); defaults to 20 items
• Respects AV_JAVDB_BASE / AV_HTTP_PROXY / AV_JAVDB_COOKIE
• Supports uncensored-only filter: --uncen (alias -u)

av actors [--page N] [--per-page N|-n N] [--uncen] [--json]

• Lists actors ranked by trending/hotness; supports pagination
• --uncen/-u: lists uncensored actors from actors/uncensored?page=N
• Output: table with index, actor name, hot value; top shows total and current page
• Respects AV_JAVDB_BASE / AV_HTTP_PROXY / AV_JAVDB_COOKIE

av install <code>
av get <code>        # alias of install

• Shows available magnet links sorted by seeders
• Displays detailed information (size, resolution, codec, bitrate) when available
• Provides usage instructions for downloading with external tools

av view <code>
av see <code>    # alias of view

• Opens the video in your default browser
• Requires AV_JAVDB_COOKIE environment variable for full access
• Finds the "Watch Full Movie" link from JavDB

av update

• Updates the tool to the latest version
• Downloads the installer script from GitHub
• Automatically installs the latest release
• Preserves your current installation path

• Every subcommand supports --json for structured output
• Non-JSON favors readability:
  • search / list: table + total count
  • detail: grouped fields

• Details and search: JavDB (preferred)
• Magnets and fallback: Sukebei (merge magnet details when possible)

Note: field availability depends on page structure and visibility; it may vary by region, mirror, or anti-bot measures.

Verified on:

• macOS (Apple Silicon)
• Linux (glibc-based distributions)
• Windows

The installer automatically detects your system and downloads the appropriate binary.

• README organization inspired by astral-sh/uv

For learning and research purposes only. Use at your own risk and follow local laws and site terms.