Command-line scraper for javdatabase.com. Search movies, extract metadata, and download preview images or NFO files for media centers.
pip install javdbSearch for a movie by ID or title and interactively select from results:
javdbjavdb --query SONE-763Search and save metadata to a Kodi-compatible NFO file:
javdb --query SONE-763 --output SONE-763.nfoSearch and save metadata as JSON:
javdb --query SONE-763 --json --output metadata.jsonSkip the search and go directly to a movie page:
javdb --link https://www.javdatabase.com/movies/sone-763/Download preview images directly from a movie URL:
javdb --link https://www.javdatabase.com/movies/sone-763/ --downloadSearch, save metadata, and download images:
javdb --query SONE-763 --output SONE-763.nfo --download--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--jsonis used)--download, -d: Download poster and preview images todvd_id/preview/and write NFO there--json: Output metadata as JSON instead of NFO/XML
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
--downloadis 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.
You can also call the scraping helpers from Python code:
from javdb.__main__ import fetch_movie_metadata, fetch_preview_images, fetch_poster_url
url = "https://www.javdatabase.com/movies/sone-763/"
meta = fetch_movie_metadata(url)
previews = fetch_preview_images(url)
poster = fetch_poster_url(url)The functions and HTML structure are not considered a stable API, but this can be handy for quick scripts.
MIT License
See LICENSE for details.