GuideVault

[Shredder_guitar]

I’ve been working on a new project called Guidevault.

It’s a self-hosted web reader and library manager for video game manuals, strategy guides, and gaming magazines. The idea is pretty simple: keep your own files where they are, scan them into a clean library, and read them through a browser-based interface.

It supports things like manuals, strategy guides, magazines, local folder scanning, metadata editing, reader preferences, Docker deployment, and OPDS access for compatible readers.

Still a work in progress, but it’s finally public on GitHub for anyone interested in checking it out:

https://github.com/Shredder5262/Guidevault

 

A bit more info https://guidevault.net

Edited June 7 by Shredder_guitar

[Shredder_guitar]

Taking shape after getting metadata cleaned up a bit. 

Edited June 16 by Shredder_guitar

[rexryan]

Interesting what about comics? Metadata?

 

[Shredder_guitar]

On 6/9/2026 at 5:52 PM, rexryan said:

Interesting what about comics? Metadata?

 

You can use Kavita Reader for Comics, I want to get away from having to depend on comicrack for organizing cbz. I may support other things for video games in the future, for now it is specifically manuals, strategy guides and magazines. 
Regarding Metadata enrichment...................  stay tuned. 

Edited June 10 by Shredder_guitar

[rexryan]

Just now, Shredder_guitar said:

You can use Kavita Reader for Comics, I want to get away from having to depend on comicrack for organizing cbz.
Regarding Metadata enrichment...................  stay tuned. 

Thanks..Will follow..

 

[Shredder_guitar]

Color scape can be applied to main menu's (optional) 

 

Local Stat Visual Polish

 

Enhanced user section, added local/server based review area. 

• OPDS extra-click issue resolved.
• Docker/GHCR package released successfully.
• New container package looks good so far.
• Source/repo icon mismatch is cleaned up.
• Bad nested docs/images/images folder was removed/moved correctly.
• Release pipeline is working again.
• BUNCH of visual improvements 
   

[Shredder_guitar]

Here is a sample of json data that would be stored with a manual/strategy guide/ magazine after data enrichment....which is infinitely better for storing relevant data to an object. This would replace comicinfo.xml.  The idea is to bridge the gap between a guide/manual and the game title itself so a mixture of datapoints related both to the guide itself and the game title are stored together to make the bridge. 
guidevault-guide-metadata.json

Edited June 13 by Shredder_guitar

[Shredder_guitar]

GuideVault has been moving fast since 0.9.200.
What started as a focused reader/library app for manuals, strategy guides, and magazines has turned into a much more polished self-hosted platform.
Recent updates include:
✅ Docker runtime improvements
Poppler is now included in the Docker image so PDF-to-CBZ conversion works properly in published containers.
✅ Better manual metadata
Manuals now support shared game metadata fields like game title, franchise/series, developer, game publisher, game release year, and genre.
✅ Cover loading and cache stability
Several updates focused on making large libraries feel better: bounded cover loading queues, stale request cancellation, faster visible cover loading, and better recovery when files are renamed, moved, or replaced.
✅ Home Assistant integration
GuideVault can now publish reader/library state into Home Assistant and accept commands back from automations.
✅ Reader control from Home Assistant
Commands now support opening manuals, strategy guides, and magazines by content type, plus next page, previous page, page jump, zoom, overlay control, close reader, fullscreen, background changes, and brightness control.
✅ Magazine-specific targeting
Magazine open commands can now target an issue number and optional volume, which is important when a series has multiple issues.
✅ Task/notification cleanup
Integration messages, update notices, and running task counts now flow through the top Tasks menu instead of scattered inline messages or floating popups.
✅ Reader/cache bug fixes
Recent fixes also improve how replaced or corrected files are handled so the library cover and reader pages stay in sync instead of showing stale pages.
GuideVault is still a personal project, but it keeps getting closer to the thing I originally wanted: a clean, self-hosted way to organize, read, preserve, and automate access to game manuals, strategy guides, and gaming magazines.
Still a lot to do, but this has been a solid stretch of progress.

https://guidevault.net

Edited June 16 by Shredder_guitar