Skip to content
Khiip Khiip Khiip

Configuration

Paths

PurposePathOverride
Config~/.config/khiip/XDG_CONFIG_HOME
Data (SQLite index)~/.local/share/khiip/XDG_DATA_HOME
Vault (Markdown captures)~/khiip-vault/[daemon] vault_path
Source-tier raw bytes~/.local/share/khiip/ (data_root)[storage] data_root

Point data_root at iCloud, Dropbox, an external SSD, or a network mount for cross-machine sync of the raw Source tier.

Config file

Settings live in ~/.config/khiip/config.toml. Common sections:

[daemon]
host = "127.0.0.1"
port = 8478


[storage]
data_root = "~/.local/share/khiip"


[extractors.reddit]
client_id = "…"        # optional since v0.1.3; widens rate limits + gallery dims
client_secret = "…"    # credential-free old.reddit HTML is the default channel


[extractors.youtube]
api_key = "…"          # optional; widens the YouTube fallback chain


[media]
download_videos = false  # opt-in video preservation, off by default


[archive]
wayback_enabled = false  # default off; opt in for best-effort anonymous Wayback
                         # (archive.org's anonymous SPN is rate-limited/unreliable)

Most per-source credentials can also be supplied as environment variables (e.g. KHIIP_REDDIT_CLIENT_ID).

The KHIIP_HOME test knob

KHIIP_HOME redirects config + data + vault under a single root — useful for hermetic tests and demos:

Terminal window
KHIIP_HOME=$(mktemp -d) khiipd serve