Zhami

by kote-pdj
5
4
3
2
1
Score: 50/100

Description

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

Reviews

No reviews yet.

Stats

0
stars
19
downloads
0
forks
5
days
5
days
5
days
2
total PRs
0
open PRs
0
closed PRs
2
merged PRs
0
total issues
0
open issues
0
closed issues
39
commits

Latest Version

5 days ago

Changelog

  • Zhami's development tools use moment 2.31.0 and minimatch 11.0.8, clear of their security advisories. The plugin itself is the same as 1.0.0.

README file from

Github

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