VNDB Calendar

中文介绍请看 README_zh-Hans

Intro

For now VNDB only offers RSS for Recent Changes, but not Upcoming Releases or Just Released. This tool allows you to create a calendar of VNDB upcoming releases, and serves as an extension of my blog post iCalendar (ICS) 的养成方式 (written in Chinese).

After initial setup, everything would be automatically updated. If you choose to publish the ICS file, you can subscribe it in any calendar app that supports iCalendar.

These example calendars are provided for quick test, if they already satisfy you, no need to read further:

• en: upcoming en & ja releases
• enpatch: unofficial en localization/content restoration patches released since mid-2025

Setup

If you want a more personalized calendar, you may want to fork the repo and customize your query. More details about parameter are available in USAGE.

You can choose between wishlist/advanced setup. Wishlist is recommended for most users.

Wishlist

1. Find your VNDB ID, e.g. Yorhel's ID is u2

2. Fork the repo, delete release.yml

3. Replace commands in .mise.toml build:custom task, commit the change

   [tasks."build:custom"]
   description = "build my custom calendar"
   -run = "uv run vndb_calendar.py"
   +run = "uv run wishlist.py -u 'u2'" # Replace 'u2' with your VNDB ID
   alias = ["run", "custom", "default"]

4. Get your personalized calendar at output/vndb-calendar.ics (change your username in URL)

Advanced

1. Head to Browse releases page on VNDB, customize your filters here and copy the filters

   • For example, the URL for enpatch query would be something like this:
     • https://vndb.org/r?q=&o=a&s=title&f=052genNg1174172_0ceSsN483hen
     • https://vndb.org/r?f=052genNg1174172_0ceSsN483hen&o=a&s=released
   • The filters here are 052genNg1174172_0ceSsN483hen, which is needed later

2. Fork the repo, delete release.yml

3. Replace default_filters in vndb_calendar.py with your filters here, commit the change

   # fmt: on
   
   # ↓↓↓ change this line ↓↓↓
   default_filters = "052genNg1174172_0ceSsN483hen"
   # ↑↑↑ change this line ↑↑↑
   
   default_data = {
       ...
   }

4. Get your personalized calendar at output/vndb-calendar.ics (change your username in URL)

Contrib

Any contribution is appreciated!

If you happen to know Perl, you'd better contribute to VNDB directly (reference: vndb/lib/VNWeb/Misc/Feeds.pm - yorhel/vndb).

Acknowledgement

• Inspired by SteamWishlistCalendar, which I highly recommend in favor of email notifications
• VNDB Steam Enhancer is another learning source for interacting with VNDB API
• Thanks to all VNDB contributors & editors for making such a great site available