Skip to content

Latest commit

 

History

110 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Tab Candy emblem

🍬 Tab Candy 🍬

A customizable new tab screen for Obsidian — backgrounds, quotes, search, and more.

CI License: MIT

A screenshot showing the Tab Candy screen

What is this?

Tab Candy turns Obsidian's blank new-tab screen into something worth looking at: a background image, the time, a greeting, quick search, your recent files, your bookmarks, and a quote, all in one customizable view.

It's an evolution of Beautitab — not a continuation of it. Beautitab fell into disrepair, as unmaintained projects tend to. Tab Candy started as a fork, but the codebase underneath it has since been rebuilt from the ground up: modernized against the current Obsidian API, made to work properly on both desktop and mobile, backed by an actual automated test suite, and given a CI pipeline that gates every change. What you're looking at today shares Beautitab's spirit and its original idea, but very little of its original code.

Note

A word of thanks. None of this exists without Andrew McGivery's original work on Beautitab — the concept, the settings-first design philosophy, the whole idea of what a "pretty new tab" could be for Obsidian. Building something fun enough that someone else wants to keep it alive for years afterward is its own kind of success. Thank you for making Tab Candy possible in the first place. 🙏

Features

Open automatically on new tabs

By default, opening a new empty tab in Obsidian shows Tab Candy automatically. If you'd rather trigger it manually instead, that's a setting too — either way, the Open new tab command in the command palette always works.

A screenshot showing the Tab Candy new tab setting

Background

A background image fills the screen behind everything else. It stays the same for the rest of the day (or until Obsidian restarts), and you can choose where it comes from:

  • Local — a folder in your vault, synced automatically; add individual images one at a time if you'd rather not sync a whole folder.
  • Custom — a single image URL you provide yourself.
  • Transparent / Transparent with shadows — let your current Obsidian theme's own background show through instead.
A screenshot showing the Tab Candy background settings

Search

Two independent search entry points — a small icon in the top-left corner, and a larger inline search box in the center of the screen. Each can be shown or hidden on its own, and each can be configured to trigger a different command: Obsidian's built-in Quick Switcher by default, or a command from any other plugin you have enabled.

Tip

Want a specific plugin supported as a search provider that isn't showing up? Open an issue or start a discussion.

A screenshot showing the Tab Candy search settings

Time & greeting

The current time (12-hour or 24-hour) and a customizable greeting, shown front and center. Either can be hidden independently.

A screenshot showing the Tab Candy time settings

Recent files

Your 5 most recently edited files, one click away.

A screenshot showing the Tab Candy search settings

Bookmarks

5 bookmarks, pulled either from your entire Bookmarks list or from one specific bookmark group you choose.

A screenshot showing the Tab Candy bookmarks settings

Quote

A quote at the bottom of the screen, picked at random from your own list of custom quotes.

A screenshot showing the Tab Candy search settings

Installation

Via Community Plugins (recommended)

In the Community Plugins tab under Obsidian settings, search for "Tab Candy". Install and enable, et voila!

Via BRAT

Pre-releases will occasionally arise. If you want to be on the bleeding edge of new features and desire to contribute feedback to help improve Tab Candy, you can install Tab Candy through BRAT:

  1. Install the BRAT plugin from Obsidian's community plugin browser, if you don't already have it.
  2. In BRAT's settings, choose Add beta plugin and enter this repository's URL.
  3. Enable Tab Candy under Settings → Community plugins.

BRAT will also keep you on the latest release, betas included, if you opt into pre-releases in its settings.

Manually

  1. Download main.js, manifest.json, and styles.css from the latest release.
  2. Create a folder named tabcandy inside your vault's .obsidian/plugins/ directory, and place the three files there.
  3. Reload Obsidian, then enable Tab Candy under Settings → Community plugins.

Screenshots

Tab Candy screenshot plain Tab Candy screenshot corner search
Tab Candy screenshot inline search Tab Candy screenshot time
Tab Candy screenshot greeting Tab Candy screenshot recent files
Tab Candy screenshot bookmarks Tab Candy screenshot quote

Reporting issues

Found a bug? Open an issue and include as much detail as you can — what you expected, what happened instead, and a screenshot if it's visual. The more context, the faster it gets fixed.

Contributing

Tab Candy has a real test suite (Vitest, run against mocked Obsidian internals) and a CI pipeline that runs typecheck, lint, tests, and a coverage floor on every pull request. If you're looking to contribute code, that's the bar a PR needs to clear.

pnpm install
pnpm test      # run the test suite
pnpm lint      # lint
pnpm build     # production build → dist/

Requires Node 24 or newer, and pnpm (version pinned in package.json).

Credits

  • Originally inspired by the Chrome extension Momentum.
  • Built on the foundation laid by Beautitab — see the note up top.

Support

If Tab Candy's made your new tab screen a little nicer to look at, you can buy me a coffee.

About

Decorate your Obsidian tabs with custom backgrounds, quotes, search, and more!

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages