Command-line scraper for javdatabase.com. Search movies, extract metadata, and download preview images or NFO files for media centers.
Verified details
These details have been verified by PyPIProject links
GitHub Statistics
Maintainers
Project description
javdb-python
Command-line scraper for javdatabase.com. Search movies, extract metadata, and download preview images or NFO files for media centers.
Installation
pip install javdb
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--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
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
--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.
Programmatic Use (experimental)
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.
License
MIT License
See LICENSE for details.
Project details
Verified details
These details have been verified by PyPIProject links
GitHub Statistics
Maintainers
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file javdb-0.1.2.tar.gz.
File metadata
- Download URL: javdb-0.1.2.tar.gz
- Upload date:
- Size: 10.0 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
527513f29d74515e534ba3417f3f2f863fb8ebc6165d89e3d6f498d7d9f9e916
|
|
| MD5 |
e457e9ddee5e3c9c42898a0566b15235
|
|
| BLAKE2b-256 |
397c1f5e818fdc5547161e06fa55fcbb23571569bb0cffb60031c0cdac75446e
|
Provenance
The following attestation bundles were made for javdb-0.1.2.tar.gz:
Publisher:
publish.yml on phoenixthrush/javdb-python
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
javdb-0.1.2.tar.gz -
Subject digest:
527513f29d74515e534ba3417f3f2f863fb8ebc6165d89e3d6f498d7d9f9e916 - Sigstore transparency entry: 894153922
- Sigstore integration time:
-
Permalink:
phoenixthrush/javdb-python@f2676d6de726b4756fc4ccb0c3efb0556e49c63a -
Branch / Tag:
refs/tags/v.0.1.2 - Owner: https://github.com/phoenixthrush
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@f2676d6de726b4756fc4ccb0c3efb0556e49c63a -
Trigger Event:
release
-
Statement type:
File details
Details for the file javdb-0.1.2-py3-none-any.whl.
File metadata
- Download URL: javdb-0.1.2-py3-none-any.whl
- Upload date:
- Size: 9.3 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
23e0609376032f5af4af83f31a56c3c8982ce64828238ee0bd01d0c56f67f2f6
|
|
| MD5 |
f80e73ba3cc0f97471cc3ecfb05a8aa8
|
|
| BLAKE2b-256 |
62bd66dece7e78ad8868bd8025d177e249b78bac270c527b8c997798e6f22d4b
|
Provenance
The following attestation bundles were made for javdb-0.1.2-py3-none-any.whl:
Publisher:
publish.yml on phoenixthrush/javdb-python
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
javdb-0.1.2-py3-none-any.whl -
Subject digest:
23e0609376032f5af4af83f31a56c3c8982ce64828238ee0bd01d0c56f67f2f6 - Sigstore transparency entry: 894153934
- Sigstore integration time:
-
Permalink:
phoenixthrush/javdb-python@f2676d6de726b4756fc4ccb0c3efb0556e49c63a -
Branch / Tag:
refs/tags/v.0.1.2 - Owner: https://github.com/phoenixthrush
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@f2676d6de726b4756fc4ccb0c3efb0556e49c63a -
Trigger Event:
release
-
Statement type:
