Skip to main content

Download visual novel metadata and screenshots from

Project description


vndb_dl is a command-line utility that allows to download VN metadata and screenshots from


vndb_dl can be used from the command line. You can either specify an id to use with the -i option:

$ vndb_dl -i 7

or an url:

$ vndb_dl -u

Bulk downloading is supported with ranges:

$ vndb_dl -i 7-12, 14 # Will download vns with id [7; 12] and vn with id 14

By default, vn_dl will output metadata about each vn in a metadata.txt and metadata.json file. To disable either or both of these, set their flags to false:

$ vndb_dl -i 7 -j False -p False

By default, vndb_dl will output into the working directory. You can change the directory with the directory flag:

$ vndb_dl -i 7-12 -d download_folder

This covers full usage of vndb_dl.

$ vndb_dl --help
usage: vndb_dl [-h] [-j JSON] [-p PLAIN] [-i ID [ID ...]] [-u URL [URL ...]]
               [-d DIRECTORY]

Download visual novel information from

optional arguments:
  -h, --help            show this help message and exit
  -j JSON, --json JSON  Parse the visual novel metadata as a JSON file in the
                        visual novel folder ([True]/False)
  -p PLAIN, --plain PLAIN
                        Parse the visual novel metadata as a plain text file
                        in the visual novel folder ([True]/False)
  -i ID [ID ...], --id ID [ID ...]
                        vndb id of the visual novel; where in,
                        the ### is the vn's id. --id accepts both list of
                        numbers (eg. 5 6 7) and ranges (eg. 5-7) as well as
                        both (eg. 5-7 9 11). Commas and spaces are accepted
                        (eg 5-7, 40 49, 51), as long as each character is
                        separated by a space (57,59 will give you vn n.5759).
  -u URL [URL ...], --url URL [URL ...]
                        vndb url of the visual novel
  -d DIRECTORY, --directory DIRECTORY
                        Source directory where the data for each visual novel
                        will be stored

For developers

Any contributions are very appreciated. Please submit a pull request if you find improvements.


All documentation can be found in sphinx format under the docs folder.

Unit tests

Tests are located in the tests folder.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for vndb-dl, version 0.1.0
Filename, size File type Python version Upload date Hashes
Filename, size vndb_dl-0.1.0.tar.gz (18.3 kB) File type Source Python version None Upload date Hashes View
Filename, size vndb_dl-0.1.0-py3-none-any.whl (19.7 kB) File type Wheel Python version py3 Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page