Obsidian At Home

A local-only desktop app for writing, organizing, and linking Markdown notes.

Vue 3 · Tauri 2 · Rust

Notes stay as Markdown files in folders you choose. No account is required, and notes are not sent to a server.

This is not a complete Obsidian replacement: cloud sync, attachments, graph view, automation, and community plugins are not supported.

[!NOTE] This project is not affiliated with or endorsed by Obsidian or Dynalist Inc.

Features

• Create, open, and switch between vaults of ordinary .md and .markdown files.
• Organize notes in nested folders with drag-and-drop and right-click file actions.
• Write in a unified live Markdown editor with inline formatting, interactive task checkboxes, tables, spellcheck, syntax-highlighted fenced code blocks, and find-in-note.
• Move through note history with back and forward controls, or revisit notes from Recent notes.
• Return to each note's cursor and scroll position, even after restarting the app.
• Zoom the app with Ctrl/Cmd + +, -, or 0.
• Personalize the app with light and dark themes, bundled typefaces, or fonts installed on your computer.
• Link notes or jump directly to headings with wiki or Markdown links, then browse outgoing links and backlinks.
• Search titles, content, folders, and tags, or jump to a note with the quick switcher.
• Use freeform tags, favorites, and reusable templates.
• Modify the UI with CSS snippets.
• Import from Obsidian or export a portable vault.

Storage and Obsidian compatibility

Each vault is a folder on your computer. Notes are ordinary Markdown files you can edit with other tools. App-only metadata, including cursor and viewport positions, stays in the vault's .obsidian-at-home folder.

Open an existing Markdown or Obsidian vault directly, or use Settings to:

• Import from Obsidian copies notes, folders, and CSS snippets into the current vault. Notes can be merged or replaced; the source is unchanged.
• Export portable vault creates an Obsidian-compatible copy of notes, templates, and CSS snippets without overwriting existing folders.

Neither option copies attachments, Canvas files, themes, plugins, hotkeys, or workspace settings. They are not backup or sync tools.

Build and install

Prerequisites

• Node.js 22.12 or newer and npm; if using Node.js 20, use version 20.19 or newer
• A stable Rust toolchain
• The Tauri prerequisites for your operating system

Clone the repository and install dependencies:

git clone https://github.com/autoboxer/obsidian-at-home.git
cd obsidian-at-home
npm ci

macOS

macOS 11 or newer is required. If needed, install Xcode Command Line Tools:

xcode-select --install

Build the app and DMG:

npm run desktop:build

Artifacts are written to src-tauri/target/release/bundle/. Open the DMG, then copy Obsidian At Home to /Applications (or ~/Applications without administrator access).

The app is unsigned and not notarized. If Gatekeeper blocks your build, Control-click it, choose Open, and confirm.

Linux

Install the system libraries and build tools listed in the Tauri Linux prerequisites. Package names and installation commands vary by distribution.

Build the Linux bundles:

npm run desktop:build

Artifacts are written to src-tauri/target/release/bundle/. Use the AppImage or install the .deb or .rpm produced for your distribution.

For example, on Fedora:

sudo dnf install ./src-tauri/target/release/bundle/rpm/*.rpm

Development

Command	Purpose
npm run desktop	Run the desktop app in development mode
npm run dev	Preview the interface at http://localhost:1420
npm run build	Type-check and build the frontend
npm run desktop:build	Build desktop artifacts for the current platform
npm run check	Build the frontend and run cargo check

The browser preview cannot open arbitrary folders or use native import/export. It uses a separate localStorage vault that is not shared with the desktop app.

License

Released under the MIT License.