obsidian-plugin/izz4n_obsidian-calendar-clock-plugin
1
0
Fork 0
mirror of https://github.com/izz4n/obsidian-calendar-clock-plugin.git synced 2026-07-22 08:28:07 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions
No description
16 commits 1 branch 1 tag 16 MiB
JavaScript 100%
Find a file
izz4n b061d8c65d
Update manifest.json
2026-07-15 03:18:34 +08:00
images Add files via upload 2026-07-15 02:53:01 +08:00
LICENSE Initial commit 2026-07-15 02:06:42 +08:00
main.js Add files via upload 2026-07-15 02:34:22 +08:00
manifest.json Update manifest.json 2026-07-15 03:18:34 +08:00
README.md Update README.md 2026-07-15 02:53:25 +08:00

README.md

Calendar Clock Companion for Obsidian

Simple Obsidian plugin that injects a live clock directly into the top of Liam Cain's Calendar plugin interface.

This plugin is designed as a zero-configuration UI extension, providing a seamless layout bridge between your daily note schedule and the current time.

Showcase

Prerequisite

This plugin is a UI companion extension. You must have Liam Cain's Calendar plugin installed and enabled for the clock to display.

Installation

Manual Installation

  1. Download main.js and manifest.json from the latest GitHub Release of this repository.
  2. Open your Obsidian Vault's plugin directory: .obsidian/plugins/ (Note: .obsidian is a hidden folder).
  3. Create a new subfolder named calendar-clock.
  4. Drop both main.js and manifest.json inside that folder.
  5. Open Obsidian, go to Settings > Community Plugins, hit the Refresh icon, and toggle Calendar Clock Companion to ON.

Usage

Once enabled, the plugin automatically finds your active Calendar panel in the sidebar and embeds a clean clock right at the top.

To customize the clock's behavior, navigate to Settings > Calendar Clock Companion:

  • Use 12-hour format: Toggle this ON to switch from a 24-hour military layout to a standard 12-hour AM/PM clock display.

12 Hour Clock

  • Show seconds: Toggle this OFF if you prefer a quieter, minimal view showing just the hours and minutes (HH:MM).

Hide Seconds

Features

  • Theme Native: Built using Obsidian's core CSS styling variables (var(--text-accent)). The clock will naturally scale and shift colors to match whatever Light or Dark community theme you choose.
  • Wiggle-Free Layout: Utilizes monospace font configurations so that shifting numbers do not cause your sidebar layouts or calendar grids to shudder or re-align every second.
  • Update-Safe: Because this operates as its own plugin, you can freely update Liam's Calendar plugin without worrying about your custom clock modifications getting overwritten.