Skip to main content

Help

Frequently Asked Questions

Everything you need to know about MoodHaven. Can't find your answer? Open an issue on GitHub.

Common questions

How secure is my data?

All your data is stored locally on your device, encrypted with AES-256-GCM before it ever touches disk. Nothing is uploaded or shared. Your journal entries never leave your machine unless you choose to export them. The web app stores entries in your browser's IndexedDB — same encryption, no cloud.

Can I export my journal?

Yes. You can export your entries as an encrypted .moodhaven backup file or as a plaintext file. Find it under Settings → Data Management.

Will there be a mobile app?

The web app is available now at journal.moodhaven.app — it works on any device with a browser. A Wear OS companion for voice memos launched with v0.7.0, and LAN peer sync lets you keep multiple devices in sync without a cloud account.

Is MoodHaven free?

Yes — completely free, forever. MoodHaven is open source under the MIT license. There is no Pro tier, no subscription, and no paid features. Everything ships to everyone.

Is this really open source?

Yes. Every line of code is on GitHub, MIT licensed. You can build it yourself, fork it, audit it, or contribute to it. No closed core, no open-core bait-and-switch.

View on GitHub

How do I contribute?

We'd love your help — pull requests, bug reports, documentation, and testing are all welcome. No code experience required to make a meaningful contribution.

Contribute guide

Technical details

What encryption does MoodHaven use?

AES-256-GCM with PBKDF2 key derivation (600,000 iterations). Each entry has its own random 16-byte salt — compromising one entry's key doesn't expose others. Keys are derived from your password in memory and never stored anywhere.

Can I verify the source code?

Yes. MoodHaven is fully open source. The security model is documented in SECURITY.md.

How does AI work without sending my data?

AI features analyze anonymized metadata only: mood scores, sentiment categories, time-of-day patterns, and entry frequency. Your actual journal text is never sent to any external API. AI is opt-in and disabled by default.

What is peer sync and how secure is it?

Peer sync connects your devices over your local network using an Ed25519 device identity and AES-256-GCM encrypted transport. No cloud intermediary. A passive observer on your network sees only ciphertext.

How do I install on Linux?

Download the .AppImage from the Downloads page. Make it executable (chmod +x) and run it directly — no installation required. A .deb package is also available for Ubuntu-based distributions.

StillHaven — bilateral sessions

What is StillHaven?

StillHaven is a bilateral audio stimulation tool built into MoodHaven Journal. It plays alternating left-right tones — the same kind of rhythm your brain uses during deep sleep to process the day. Many people find it helps their nervous system settle, especially after stressful events, persistent anxiety, or times when they feel wound up but can't explain why.

Is it safe to use on my own?

StillHaven is a general wellness tool suitable for most people in everyday stress situations. It may not be appropriate if you are currently experiencing dissociation, flashbacks, or acute crisis. If you are working through significant past experiences, please consult a qualified mental health professional before using it — and ideally work alongside one rather than using StillHaven as a replacement.

How is StillHaven different from professional guided sessions?

A trained mental health professional using bilateral stimulation works with you to identify specific targets — a memory, a belief, a body sensation — and guides the processing. StillHaven provides the bilateral rhythm without that structure. It's a general settling tool, not a guided processing protocol. Think of it like the difference between a stretching routine and a clinical rehabilitation program: both are useful, but they aren't the same thing.

What will I notice during a session?

Responses vary. Some people notice physical sensations, a shift in how something feels, or thoughts that arise and pass. Others notice nothing obvious at all during the session but feel calmer afterward. Both are normal — the absence of a noticeable shift doesn't mean it isn't working. Consistent short sessions tend to produce more effect over time than occasional long ones.

StillHaven is a wellness tool, not a medical device. It is not a substitute for professional mental health support. If you are working through significant distress, please work with a qualified professional.