the visual novel database

Report an issue on this page.

VNDB Development

1. The Source

VNDB is open source. The full source code of the site is available as a git repository.You can use it to track changes to the code, run your own instance of VNDB and contribute to issues or pull requests. Check the README in the git repository for instructions.

VNDB is built on the following technologies:

2. Contributing

Code contributions are more than welcome! For small bug fixes or minor and undisputed improvements, feel free to send a patch or pull request without prior discussion. If you have an idea for a new feature, I strongly recommend opening a thread on the forums to get some feedback before you start coding. Otherwise you may be wasting your time on features that aren't even welcomed in the community or could have been better integrated with other parts of the site. For ideas of projects to work on, check out the list of open issues.

If you are stuck, don't hesitate to ask for help on IRC or on the forums.

3. Development Database

File: vndb-dev-latest.tar.gz (more files).

Updated: Sporadically.

When working on the VNDB code, it helps to have a local development database with some realistic data. This database dump includes a small subset of the production database to play around with. Usage instructions can be found in the README in the git repository.

The dump includes:

  • The complete tags and traits database
  • All 'doc' pages
  • All threads made on the 'announcement' board
  • A small selection of popular visual novel entries
  • All releases, producers, characters and staff related to these visual novels
  • All images related to the above database entries
  • The full edit history of these entries
  • An admin user and a few test users (their password is 'hunter2' if the crypt_salt configuration option is the same as the example file).

4. Wishlist

VNDB can be improved in an infinite number of ways. Here's a very incomplete list of a few features we'd like to have at some point, in no particular order.

  • More modern, mobile-friendly design (without sacrificing performance and functionality, of course).
  • Custom title languages for releases, characters, producers and staff entries.
  • User-contributed "similar visual novels".
  • Cover images for releases (t14195)
  • Character relations (t3314.1994 & t15655)