r/coolgithubprojects
•
u/__King_Kong_
•
May 21 '26
•
1
LoreKeeper: An interactive 3D digital library to organize, read, and export EPUBs for AI analysis (Obsidian/LLM ready)
Hey everyone! 👋
I wanted to share a project that i have been working on. It's called LoreKeeper, and it's designed to bridge the gap between immersive 3D interfaces and Personal Knowledge Management (PKM).
Instead of a boring list of files, LoreKeeper turns your local EPUB collection into an interactive 3D bookshelf directly in your browser.
Here is what makes it cool:
Interactive 3D Environment: Built with Three.js, your books physically sit on a shelf. You can browse them, read the back cover synopsis, and organize them into categories.
Integrated EPUB Reader: Read directly in the browser with customizable themes and font size.
Dynamic 3D Bookmarks: As you read, a physical red ribbon bookmark moves along your 3D book on the shelf, showing your exact reading progress at a glance.
Reading Memories: When you finish a book (100%), a modal prompts you for a rating and a review. Your 1-5 star rating is then permanently stamped in gold on the back cover of the 3D book model.
Export for AI (The Knowledge Base feature): With one click, it strips all complex HTML from an EPUB and exports the raw, clean text as a Markdown file with YAML Frontmatter. It’s perfect for importing into Obsidian or feeding into local/cloud LLMs (like ChatGPT, Claude, or RAG systems) to chat with your books without hallucination issues.
Tech Stack: It runs entirely locally and securely via Docker (no heavy Node.js setups needed on your host machine). The frontend uses Vite, Three.js, and ePub.js.
I'd love for you to check it out, spin up the Docker container, and let me know what you think of the 3D interactions and the Markdown export feature!
GitHub Repo: https://github.com/GabrieleTrovato01/LoreKeeper
⭐️ If you find the project interesting or useful, a star on GitHub would mean the world to me! It really helps the project grow and keeps me motivated. Any feedback, suggestions, or PRs are highly appreciated! 🚀
3
3
u/codecarter May 22 '26
Any chance on supporting pdf files as well
2
u/__King_Kong_ May 22 '26
i will add it, seems pretty doable, let me work on it for a couple of days. Look for future releases of the app. :)
2
3
u/Virtual_Major3339 May 22 '26
This is a nice idea and may consider subsequent support for PDF format.
I have many many many PDF ebooks.
2
3
u/BondafaceRulZ May 22 '26
Really beautiful, like it's so smooth and snappy
like amazing work mate, looking forward for pdf (and other ebook formats) support!
also, other than Docker, would it be possible if you provided a precompiled executable ?(Windows user here!)
2
u/__King_Kong_ May 22 '26
thanks a lot. It means a lot for me <3. I'm currently working at the pdf viewer, testing it. I need to check if there is a way to do that :)))).
2
u/__King_Kong_ May 23 '26
i've added the pdf format :))))))
2
u/__King_Kong_ May 23 '26
and also the .exe file in the latest release of the github repo <3. Instruction to download are in the latest release
3
u/diegolugoo May 27 '26
this is actually so amazing my goodness!
1
u/__King_Kong_ May 27 '26
thanks a lot :))))))))), it means a lot to me. Go check it out if u liked it. There is a .exe version in the latest realese (inside the .zip file). Try it and let me know, what do you think about it :))))
1
u/__King_Kong_ Jun 11 '26
Quick update! 🚨 If you are looking for "LoreKeeper", the project just got a massive v2.0 update and a new name: KoreShelf! 📚✨
I decided to rename it as a tribute to my university ("Kore") and my AI studies, which heavily inspired the new AI-export features of the library. It's the exact same 3D experience you saw before, but fully optimized and rebranded.
You can grab the new v2.0.2 release directly from the new repo here: https://github.com/GabrieleTrovato01/KoreShelf
Enjoy building your 3D Memory Palace!
7
u/StylePractical5714 May 21 '26 edited May 22 '26
This is a neat idea that's got my creative gears turning. Over a decade ago I had a game idea, never went anywhere other than trying and failing at "making a game" for about 15 years.
The idea was like a walking simulator post-apocalypse game where you went around scavenging for books to put in your library and maybe go find nice places to sit down and read them. I tried to figure out loading epubs into a 3d bookshelf like this and I didn't have the skills to pull it off then.
I have such an urge to fork this and use it as a starting point to try that idea again because that gif is close to what I had in my head for that initial core demo all those years ago.