javdb 0.0.3

Python API wrapper for javdatabase.com. Search movies, extract metadata, and download preview images.

javdb-python

Python API wrapper for javdatabase.com. Search movies, extract metadata, and download preview images.

Installation

pip install .

Usage

Basic Search

Search for a movie by ID or title and interactively select from results:

javdb
javdb --query SONE-763

Search with NFO Output

Search and save metadata to a Kodi-compatible NFO file:

javdb --query SONE-763 --output SONE-763.nfo

Search with JSON Output

Search and save metadata as JSON:

javdb --query SONE-763 --json --output metadata.json

Direct Link

Skip the search and go directly to a movie page:

javdb --link https://www.javdatabase.com/movies/sone-763/

Direct Link with Download

Download preview images directly from a movie URL:

javdb --link https://www.javdatabase.com/movies/sone-763/ --download

All Options Combined

Search, save metadata, and download images:

javdb --query SONE-763 --output SONE-763.nfo --download

Options

• --query, -q: Search query (e.g., video ID or title)
• --link, -l: Direct URL to movie page (skips search)
• --output, -o: Output file path (NFO/XML by default, or JSON when --json is used)
• --download, -d: Download poster and preview images to dvd_id/preview/ and write NFO there
• --json: Output metadata as JSON instead of NFO/XML

Extracted Metadata

The tool scrapes javdatabase.com and writes a Kodi-style movie.nfo XML with:

• Title
• Series (when available)
• DVD ID and Content ID
• Release Date and Runtime
• Studio and Director
• Genres and Actresses/Idols
• Optional poster and fanart references when --download is used

When --json is used, the same metadata is returned as a JSON object with keys such as title, jav_series, dvd_id, content_id, release_date, runtime, studio, director, genres, actresses, preview_images, and poster.

License

MIT License

See LICENSE for details.