Search...Search plugins and themes...
⌘K
Sign in
  • Get started
  • Download
  • Pricing
  • Enterprise
  • Account
  • Obsidian
  • Overview
  • Sync
  • Publish
  • Canvas
  • Mobile
  • Web Clipper
  • CLI
  • Learn
  • Help
  • Developers
  • Changelog
  • About
  • Roadmap
  • Blog
  • Resources
  • System status
  • License overview
  • Terms of service
  • Privacy policy
  • Security
  • Community
  • Plugins
  • Themes
  • Discord
  • Forum / 中文论坛
  • Merch store
  • Brand guidelines
Follow us
DiscordTwitterBlueskyThreadsMastodonYouTubeGitHub
© 2026 Obsidian

Zhami

kote-pdjkote-pdj20 downloads

Open or create the note for this week, month, year, or any other period, from a template.

Add to Obsidian
  • Overview
  • Scorecard
  • Updates2

zhami /ʒɑːmi/ noun

time; an era.

Zhami (ჟამი) is a literary Georgian word for time, or an era.

Zhami opens the note for this week, this season, this year, or any other period, and creates it from a template if it doesn't exist yet. Each period you turn on adds three commands, like Open this week, Open next week and Open previous week. Next and previous step from the period note you're looking at, or else from today.

Group Periods
Calendar week, fortnight, month, quarter, half-year, year, decade, century, millennium
Seasons meteorological, astronomical, the Wheel of the Year
Work fashion season, fiscal year, fiscal quarter, academic year
Japan the 24 sekki, the 72 kō
China the 24 jiéqì, the zodiac year
Korea the 24 jeolgi
India the six ṛtu

Week, month, quarter and year are on by default. For daily notes, use Obsidian's core Daily notes plugin.

Installation

  1. Open Settings → Community plugins.
  2. Select Browse, then search for Zhami.
  3. Select Install, then Enable.

Or install it from its page in Obsidian's plugin directory.

Requires Obsidian 1.13.1 or later, on desktop or mobile.

To install manually, download main.js, manifest.json and styles.css from the latest release into <vault>/.obsidian/plugins/zhami/.

Usage

Open Settings → Zhami and set a folder for new notes. Then open a period and turn on Commands. Its page also has:

  • Folder, if its notes go somewhere else.
  • Start dates, for periods that start when you say, like the fiscal year.
  • Name format, with today's note as you type.
  • Template for new notes.
  • Examples, each with a button to use it.
  • Reference: every token the period understands, and what each gives today.
  • Rename notes, for notes named another way.

To link to a period's note as you write, type @ and a phrase: @next week gives [[2026-W47]], @this sekki gives [[Rittō 2026]], and @last month gives [[2026-10]]. The list appears once you type the space after this, next or last, so @today stays with plugins like Aloha. With Natural Language Dates on, @ stays with it; use Insert link to a period note instead, which works anywhere.

Name formats

Name formats use moment, as Daily notes do. Where moment has no token, Zhami adds one in double braces. On November 13, 2026:

Period Format Gives
Week GGGG-[W]WW 2026-W46
Fortnight GGGG-[F]{{PP}} 2026-F23
Season {{PPPP}} YYYY{{end?:-YY}} Autumn 2026
Fashion season {{PPP}}YY FW26
Sekki {{PPPP}} {{PPPP:kanji}} Rittō 立冬
Century {{Po}} [century] 21st century

Documentation

  • Periods: every period, its formats and tokens, and sources.
  • Name formats: moment, Zhami's tokens, first and last days, folders.
  • Templates: variables for new notes.
  • Rename notes: renaming notes to a new format.

Accuracy

Seasons, sekki, kō, jiéqì, jeolgi and ṛtu start when the sun reaches a longitude. Zhami computes it with VSOP87 and Jean Meeus's methods. From 1901 to 2100, its dates match all 4,800 solar terms in the Hong Kong Observatory's tables, except six that fall within 15 minutes of midnight, where ephemerides disagree on the day. Zodiac years use the Observatory's Lunar New Year dates, so they cover 1901 to 2099.

Develop

bun install
bun run check   # type check
bun run lint    # Obsidian's review rules
bun run test    # tests
bun run e2e     # check in real Obsidian, with test/zhami-vault open
bun run build   # build main.js
bun run docs    # write docs/periods.md
VAULT=/path/to/vault bun run dev   # build and copy into a vault

Credits

The icon is ჟ from Noto Sans Georgian, under the SIL Open Font License 1.1. VSOP87 coefficients via astronomia (MIT). Names and dates come from the sources listed in Periods.

License

MIT

HealthExcellent
ReviewPassed
About
Open weekly, monthly, quarterly and custom period notes and create them from templates when missing. Add next/previous period commands and inline @-linking to jump between this/next/previous periods; support seasonal, work and cultural calendars like fiscal years, sekki and jiéqì.
CalendarDatesTemplating
Details
Current version
1.0.1
Last updated
6 days ago
Created
Last week
Updates
2 releases
Downloads
20
Compatible with
Obsidian 1.13.1+
Platforms
Desktop, Mobile
License
MIT
Report bugRequest featureReport plugin
Author
kote-pdjkote-pdj
GitHubkosyakssss
  1. Community
  2. Plugins
  3. Calendar
  4. Zhami

Related plugins

Journals

Manage your journals.

Periodic Notes

Manage your daily, weekly, and monthly notes.

Persian Calendar

Persian Calendar for managing periodic notes based on persian solar (shamsi) calendar.

Calendar

Explore your daily notes.

Day Planner

Turn tasks from daily notes, the Tasks plugin, and calendars into time blocks on an editable timeline, with built-in time tracker.

Full Calendar Remastered

Complete Calendar HUB experience. Work with all your calendars in one place. Analyze your time and take action!

Itinerary

Make planning your trip or event easier by rendering a calendar from event information found in your notes.

Weread

Sync Tencent Weread highlights and annotations.

Calendarium

Craft mind-bending fantasy and sci-fi calendars.

Yearly Glance

Year at a glance - overview of annual events with customizable management options.