Today Alias

Today Alias — Obsidian Plugin

Version 2.0.6

Configure how a title's date prefix appears in the browser/tab name! Shows configurable aliases (e.g. ✘ Today, Mar 10th / ↩ Yesterday, Mar 9th) for today's and yesterday's notes in the file explorer, and hides the leading date prefix from all other notes. Works out of the box with Obsidian's default Daily Notes format (YYYY-MM-DD). This is a purely visual change; no files are ever renamed or modified.

Quick Start

1. Install the Plugin

Via Obsidian Community Plugins

• Open Settings → Community plugins
• Search for "Today Alias"
• Install and enable

Via BRAT (for beta testing) (GitHub page)

• Install BRAT
• Add beta plugin: tanoshia/obsidian-today-alias

Features

• Date prefix hiding — strips the configured date prefix from the displayed title in the file explorer
• Moment.js format strings — uses the same format system as Obsidian's own Templates and Templater plugins (YYYY, MM, DD, HH, mm, Do, MMMM, etc.); no regex required
• Sort order preserved — Obsidian browser still sorts by the actual filename; only what you see changes. Ordering by date still applies!
• "Today" label — a Daily Note whose filename matches today's date is shown with a configurable label (default ✘ Today, Mar 10th), updating automatically when the day rolls over via a window-focus listener, a 60-second background check, and a precise midnight timeout
• "Yesterday" label — yesterday's bare Daily Note and pattern-matched notes each get their own configurable label/prefix (default ↩ Yesterday, Mar 9th / ↩ Yesterday's ), mirroring the Today feature exactly
• Ignore patterns — Moment.js format patterns to keep certain filenames fully untouched; bare Daily Notes and Meetings notes are pre-filled by default; * is supported as a wildcard; a live preview of each pattern with today's date updates in real time
• Custom ignore Today label — ignored-pattern matches that start with today's date get their own configurable label prefix (default ✘ Today's )
• Live preview — every format field shows a real-time preview of how today's date renders with the current string
• Live rename support — display updates correctly on every filename rename, no lag or skipped updates
• Tab title aliasing — open editor tabs (tab strip + header bar) show the same alias or date-stripped title as the file explorer, updating automatically when tabs are opened, switched, or renamed
• Auto-migration — settings saved with the old {TOKEN} syntax are silently upgraded to Moment.js equivalents on first load
• Clean unload — all elements are restored to plain text when the plugin is disabled or unloaded

Example

How it works

1. On load the plugin attaches MutationObservers to file-explorer container(s) and workspace tab titles (main window and popouts), watching for DOM mutations (child additions, text swaps, character data changes).
2. A vault.on('rename') listener acts as a safety net to catch any edge cases the observers miss.
3. Whenever a .nav-file-title-content element is painted or updated:
   • If the filename exactly equals today's date and Today bare-note toggle is on → replaced with the configured Today label (e.g. ✘ Today, Mar 10th)
   • If the filename exactly equals yesterday's date and Yesterday bare-note toggle is on → replaced with the configured Yesterday label (e.g. ↩ Yesterday, Mar 9th)
   • If the filename matches any ignore pattern and the Today pattern-prefix toggle is on and it starts with today's date → replaced with the configured prefix + the rest of the filename
   • If the filename matches any ignore pattern and the Yesterday pattern-prefix toggle is on and it starts with yesterday's date → replaced with the configured prefix + the rest of the filename
   • If the filename matches any ignore pattern otherwise → left completely untouched
   • Otherwise the date prefix is wrapped in a hidden <span class="ta-date"> and the rest shown in <span class="ta-rest">
4. Day-rollover is detected by three complementary triggers: a window focus listener (fires when you switch back to Obsidian or the system wakes from sleep), a 60-second interval (catches windows left open without regaining focus), and a precise midnight timeout (fires at 00:00:05 for fully-awake sessions). Any trigger that detects a date change calls a shared checkDateChange() which prevents duplicate refreshes.
5. On unload every element is restored to its original plain-text form across all open windows; no trace is left behind.

Format reference

All format fields use Moment.js format strings — the same system Obsidian's own Templates and Templater plugins use.

Full reference: momentjs.com/docs/#/displaying/format/

Settings

Wrap literal text in square brackets to prevent it being treated as a token (e.g. [Today -]DD).

Installation (manual / development)

cd ~/MiscCode/obsidian-today-alias
npm install
npm run build          # produces main.js

Copy main.js, manifest.json, and styles.css into your vault's plugin folder:

<your vault>/.obsidian/plugins/today-alias/

Reload Obsidian (Ctrl/Cmd+R in developer mode, or close and reopen), then go to Settings → Community plugins and enable Today Alias.

Upgrading from v1.3.x

Settings using the old {YYYY}-{MM}-{DD} token syntax are automatically migrated to Moment.js equivalents on first load — no manual action needed.

Why not rename the files?

Renaming would break internal links and require vault reorganisation. This plugin is purely visual — filenames, links, frontmatter and every other Obsidian feature are never touched.

Possible future work

• Handle future-dated notes differently
• Option to pin Today/Yesterday notes to the top of their parent folder (and optionally pin folders relatively) — tracked in issue #1