Skip to content

Repository files navigation

HODD

HODD

Your hoard. Your story.
A local-first desktop companion for the things you collect.

Platform Electron Version License


HODD is a desktop app for collectors who want a beautiful, private home for their things. Games, books, movies, coins, comics, vinyl — or anything else. Your data lives on your device. No subscriptions, no cloud sync, no accounts.

Screenshots

Home Collection Detail
Home — greeting, featured shelf, quick stats Collection detail with procedurally generated covers
Item Detail Statistics
Item detail — facts, story, and provenance Statistics — completeness across all collections

Features

Collections that feel like yours Six built-in types (Game, Book, Movie, Coin, Comic, Vinyl) plus unlimited custom collections. Each item gets a procedurally generated cover — no images required — or you can attach your own photos.

Every detail, your way Track format, condition, edition, pressing, completeness, acquisition date, and more. Write a provenance story for any item, or let the on-device AI write one.

On-device AI with Ollama Connect a local Ollama instance for AI-powered item enrichment, natural-language search, and story generation. Everything stays on your machine.

Online metadata lookups Fetch metadata from OpenLibrary, MusicBrainz, RAWG (games), and OMDB (movies) — API keys optional.

Views for every mood Home, Collections, Wishlist, Favorites, Timeline, Discover, Statistics, Search. Two layout modes for home and collections. Light and dark themes with six accent palettes.

Your data, always SQLite database in your app data folder. Full archive export and import as JSON. Nothing leaves your machine without your say-so.

Download

Grab the latest release for your platform from the Releases page:

Platform Format
macOS .dmg
Windows .exe installer
Linux .AppImage

Development

npm install
npm run dev        # Vite + Electron, hot-reloading

The renderer runs on http://localhost:5173. Electron auto-restarts when main-process files change.

Checks before shipping:

npm run typecheck  # TypeScript across renderer + main + preload
npm test           # Vitest unit tests
npm run build      # Full production build
npm run package    # Build + electron-builder → release/

Output directories: dist/ (React bundle), dist-electron/ (main + preload), release/ (packaged app).

Keyboard shortcuts

Key Action
Cmd/Ctrl+K Open quick-add modal
/ Browse items within a collection
F Toggle favorite (item detail)
Escape Close any overlay or modal

Stack

Layer Technology
Desktop shell Electron 42, context-isolated preload
Renderer React + TypeScript + Vite
Storage SQLite via sql.js, persisted to userData/hodd.db
Styling Custom CSS design system
AI Ollama (llama3.2, mistral, phi3)
Packaging electron-builder
Testing Vitest

Theming

HODD ships with a full theme engine: light/dark mode, six accent palettes (Indigo, Forest, Ocean, Gold, Brick, Sky), two headline font choices, and shelf art modes (covers or spines).

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages