# Game and Visual Novel Metadata A comprehensive plugin to search video game and visual novel databases (**RAWG**, **Steam**, **VNDB**, and **HowLongToBeat**), retrieve rich metadata, cover & banner artwork, completion durations, ratings, and descriptions, for multiple platforms, and embed them into your vault with [Banners](https://community.obsidian.md/plugins/obsidian-banners), [Dataview](https://community.obsidian.md/plugins/dataview), and **Configurable Subfolder Hierarchy** support.
- You can manage everything related to the note's creation and placement. That includes the folder, Visual Novel folder seperation, subfolder organization (including a custom pattern) and file name.
>
- You can also manage the integration with [Banners](https://community.obsidian.md/plugins/obsidian-banners) and [Dataview](https://community.obsidian.md/plugins/dataview) as you see fit.
>
- Finally, you can write your own template for the created note, or stick with the default one, with support of a massive list of variables to choose from.
>
---
## Dataview Examples
### 1. Completed Games with Days to Beat & Playtime
````markdown
```dataview
TABLE
status as Status,
user_playtime as "Playtime",
days_to_beat as "Days to Finish",
date_started as "Started",
date_finished as "Finished",
user_rating as "Score"
FROM #game
WHERE status = "Completed"
SORT days_to_beat ASC
```
````
### 2. Backlog & In-Progress Games with HLTB Durations
````markdown
```dataview
TABLE
status as Status,
hltb_main as "Main Story (h)",
hltb_extra as "Main + Extra (h)",
user_platform as "Platform",
user_rating as "Rating"
FROM #game
WHERE status = "Playing" OR status = "Backlog"
SORT hltb_main ASC
```
````
---
## Example Frontmatter Structure
```yaml
---
banner: "https://shared.akamai.steamstatic.com/store_item_assets/steam/apps/292030/f7f564ecedd09b3e503b071a637aeefdedbeedd8/ss_f7f564ecedd09b3e503b071a637aeefdedbeedd8.1920x1080.jpg?t=1790693338"
banner_y: 0.5
id: "292030"
title: "The Witcher 3: Wild Hunt — Remastered"
type: game
released: 18 May, 2015
year: "2015"
genres:
- RPG
platforms:
- PC (Windows)
developers:
- CD PROJEKT RED
publishers:
- CD PROJEKT RED
metacritic: 93
status: Backlog
hltb_main: 56.8
hltb_extra: 123.7
hltb_completionist: 188.9
links:
- https://store.steampowered.com/app/292030
- https://www.thewitcher.com/witcher3
cover: https://shared.akamai.steamstatic.com/store_item_assets/steam/apps/292030/e8afc4252e3fee8ed2525ab2fd7675cca39aa38d/header_alt_assets_1.jpg?t=1790693338
description: "The Witcher 3: Wild Hunt — Remastered modernizes the acclaimed role-playing game with a range of upgrades and enhancements. Become monster slayer for hire Geralt of Rivia and journey across a dark fantasy open world in an epic quest to find your adopted daughter Ciri."
short_description: "The Witcher 3: Wild Hunt — Remastered modernizes the acclaimed role-playing game with a range of upgrades and enhancements. Become monster slayer for hire Geralt of Rivia and journey across a dark fantasy open world in an epic quest to find your adopted daughter Ciri."
website: https://www.thewitcher.com/witcher3
steam_id: "292030"
tags:
- game
user_playtime: 120 hrs
user_rating: 10/10
user_platform: PC
version: "v4.0 Next-Gen"
date_started: "2026-08-01"
date_finished: "2026-09-20"
days_to_beat: 50
---
```
---
## Template Placeholders
| Variable | Description | Example |
|---|---|---|
| `{{title}}` | English/Main Title | Steins;Gate / Elden Ring |
| `{{original_title}}` | Native/Original Title (e.g. Japanese) | STEINS;GATE 比翼恋理のだーりん |
| `{{type}}` | Media type | `game` or `visual_novel` |
| `{{released}}` | Release Date | 2009-10-15 |
| `{{year}}` | Release Year | 2009 |
| `{{rating_display}}` | Formatted rating | 4.65/5 or 8.8/10 |
| `{{metacritic_display}}` | Metacritic score with parens | (Metacritic: 92) |
| `{{genres_csv}}` | Comma-separated genres | RPG, Action, Adventure |
| `{{platforms_csv}}` | Comma-separated platforms | PC, Switch, PS5 |
| `{{developers_csv}}` | Comma-separated developer studios | FromSoftware, MAGES. |
| `{{publishers_csv}}` | Comma-separated publishers | Bandai Namco |
| `{{hltb_main}}` | HowLongToBeat Main Story hours | 51.5 hrs |
| `{{hltb_extra}}` | HowLongToBeat Main + Extra hours | 103 hrs |
| `{{hltb_completionist}}` | HowLongToBeat 100% Completion hours | 173 hrs |
| `{{user_playtime}}` | Entered playtime string | 45 hrs / 45h 30m |
| `{{start_date}}` | Date Started | 2026-09-10 |
| `{{end_date}}` | Date Finished | 2026-09-20 |
| `{{days_to_beat}}` | Formatted days calculation | 10 days / 0 days (same day) |
| `{{days_to_beat_display}}` | Days suffix | ` (took 10 days)` |
| `{{user_rating}}` | Personal score | 9.5/10 |
| `{{user_platform}}` | Device played on | Steam Deck / PC |
| `{{version}}` | Version, patch, or edition | v1.0, Remaster, Fan TL |
| `{{notes}}` / `{{user_notes}}` | Personal markdown notes | Guide links, checklist |
| `{{links_list}}` | Formatted bullet list of markdown links | - [VNDB](https://vndb.org/) |
| `{{user_review}}` | Personal review text | Masterpiece storyline. |
| `{{description}}` | Game summary/synopsis | Story overview... |
| `{{cover}}` | Cover Image URL | https://... |
| `{{banner}}` | Banner Artwork URL | https://... |
| `{{status}}` | Current play status | Completed |
| `{{steam_id}}` | Steam App ID | 1086940 |
| `{{vndb_id}}` | VNDB ID | v17 |
| `{{website}}` | Official game website | https://... |
---
## License
MIT License