Command Reference

Command Reference

All commands read paths from config.toml (resolved relative to that file).

mediahound init <dir>

Scaffold a new site folder (template + config.toml). --force overwrites template files.

mediahound build

Process new cover photos and (re)generate the catalog. Incremental — only unseen images (tracked by sha256) are processed.

Flag	Meaning
--online	Allow metadata / where-to-watch lookups. Default is offline (regenerate from existing data).
--refresh-streaming	Re-check where-to-watch for every title (implies --online).
--force	Reprocess every image, not just new ones.
--reidentify <hash>	Reprocess a single image by its sha256.
--limit <N>	Process at most N new images this run.
--mock	Demo with bundled sample data (no providers/keys).

mediahound serve

Preview the generated site locally over http (avoids file:// fetch limits).

Flag	Default	Meaning
--admin	off	Enable the localhost write API — admin-portal edits save straight to data/corrections.json and survive every rebuild. See Editing and Persisting Changes.
--port <N>	8765	Port.
--host <H>	127.0.0.1	Bind address (keep admin on localhost).
--no-open	off	Don't auto-open a browser.

Security: --admin is a local authoring tool. It binds to 127.0.0.1 and refuses cross-origin writes. Never expose it publicly; public hosting serves the plain static files.

mediahound import <file.csv>

Bulk-add movies & music from a CSV (no photos needed). --online enriches each row.

mediahound export -o catalog.csv

Write the whole catalog to a CSV (backup / migration).