Hearth — a home screen for Obsidian
English · 简体中文
Hearth turns your Obsidian vault into a welcoming front page. A fast fuzzy
search bar, quick file-type filters, and a freely arrangeable grid of live
widgets — notes, tasks, kanban boards, calendars, web pages, stats, clocks and
launchers — on desktop and mobile.
Think of it as a new-tab dashboard, start page and command launcher in one.
- 🔍 Search everything — fuzzy, full-text, tags, frontmatter and commands
- 🧩 40+ cards — embeds, tasks, calendars, Dataview, Git, Jira, Operon, and more
- 🔌 26 integrations — picked up automatically when the plugin is enabled
- 🎛️ Free-form layout — drag, resize and snap cards anywhere
- 🎨 Two designs — Classic, or Material 3 Expressive in tones of your accent
- 🪟 Frosted glass — per-card opacity, blur, color and corner radius
- 🗂️ Multiple dashboards — switch with a click or a hotkey
- 🪄 Plugin view dashboards — give a whole board to one plugin's view
- 📱 Works on a phone — the board stacks into one readable column
Screenshots
Material 3 Expressive
The same board in the Expressive design — every surface drawn in tonal steps
of your accent color.
Contents
Quick start · Setup wizard ·
Search · Cards · Integrations ·
Layout · Appearance · Mobile ·
Settings & shortcuts · Privacy & network ·
Development ·
Contributing
Looking for more detail? The Hearth User Guide is a
full, chapter-by-chapter manual: every card, every setting, every integration,
plus troubleshooting and a glossary. This README is the tour; the guide is the
reference.
Quick start
- Install Hearth from Obsidian's community plugin browser — or drop
main.js, manifest.json and styles.css into
<vault>/.obsidian/plugins/hearth/ and enable it.
- Hearth opens on startup and replaces empty new tabs (both toggleable in
Settings → Hearth).
- Open it any time from the ribbon home icon or the Open home
dashboard command.
- Hit Arrange (top-right) to add, move, resize and configure cards right
on the board.
Setup wizard
On a fresh install Hearth offers to build your first dashboard for you, in
three steps: what the vault is for (with the plugins Hearth found), the look —
design, background and, for Classic, card style, each shown as a small
painting — and a preview of the board. It lays out a board from the answers
rather than dropping you on a generic starter grid: working cards in a main
column, small ones (clock, calendar, weather, statistics) beside them, and no
empty cards — anything that needs a feed or a place asks for it in the wizard.
It also looks at what you already have. Every plugin below that is installed
and enabled is offered with the one thing accepting it will do:
| Found | What Hearth does with it |
|---|
| TaskNotes | Adds a Tasks card on the TaskNotes source, using TaskNotes' own field names and completed statuses |
| Kanban | Adds a Tasks card showing your board as draggable columns |
| Dataview / Datacore | Adds a card, seeded with an editable query |
| Templater | Adds a launchpad with a button per template you already have |
| Git | Adds a Git card with status, commit and sync |
| Operon | Adds an Operon tasks card (desktop only — Operon still asks you to approve Hearth) |
| Bases | Embeds a base from your vault |
| Daily notes / Bookmarks | Adds the matching card |
The TaskNotes case is the one worth calling out: its field names are
user-remappable and its statuses user-defined, so Hearth reads them from the
plugin and copies them onto the card it builds. A vault that renamed due to
deadline gets a Tasks card that works on its first render.
The wizard offers the integrations above; everything else in
Integrations is added by hand from the Add card picker.
The wizard only ever writes to the dashboard it builds. The title, its icon,
the accent, the card surface, the spacing and the background all land as
per-board overrides on that one dashboard, and the TaskNotes field mapping
lands on the Tasks card itself — so your vault-wide settings, and every other
board you have, come out of a setup run exactly as they went in. That is also
why it no longer asks about things that can only be vault-wide (whether Hearth
opens on startup, where notes open, which search engine to use, whose file
icons to show): those live in Settings → Hearth, one toggle each, and apply
to everything by design.
This is the beginning of the README. Read the rest at the original. Read the full README ↗
