Obsidian Stats logoObsidian Stats

Life Log

by Sahil A
5
4
3
2
1
Score: 41/100
Install Code

Description

Log events from your everyday life, like GitHub commits, but YOU are the repo.

Reviews

No reviews yet.

Stats

0
stars
55
downloads
0
forks
60
days
9
days
60
days
7
total PRs
4
open PRs
3
closed PRs
0
merged PRs
0
total issues
0
open issues
0
closed issues
3
commits

Latest Version

0.1.0
2 months ago

Changelog

See all version on GitHub

README file from

Github

Life Log

License Obsidian Version Release Build codecov

A fast, minimal Obsidian plugin for recording life events as Markdown files. Not a journal. Not a habit tracker. A timeline of things that happened to you.

What is Life Log?

Life Log lets you capture atomic life events — trivial and significant — as individual Markdown files with YAML frontmatter. Think of it as a personal Git history of your life.

Examples:

  • Went for a morning walk
  • Finished reading a book
  • Had a strange dream last night
  • Tried a new recipe
  • Found a new favorite song
  • Finished a book
  • Started a new job

Every event is an independent Markdown file. Everything is portable, future-proof, and Git-friendly.

Features

  • Instant capture — Open the command palette, type, press Enter. Event saved in ~3 seconds.
  • Timeline view — Year → Month → Day grouping, newest first, in the sidebar.
  • Search — Case-insensitive instant filtering by title.
  • Today in history — See what happened on this day in past years.
  • Event types — Health, Dream, Travel, Career, Purchase, Food, Exercise, Book, Movie, Relationship, Other.
  • Markdown-first — Every event is a .md file with YAML frontmatter. No databases, no lock-in.

Installation

From GitHub Releases (recommended)

  1. Download main.js, manifest.json, and styles.css from the latest release.
  2. Create a folder life-log inside your vault's .obsidian/plugins/ directory.
  3. Copy the three files into that folder.
  4. Enable Life log in Settings → Community plugins.

Manual

Copy main.js, manifest.json, and styles.css to:

<Vault>/.obsidian/plugins/life-log/

Usage

Creating an event

  1. Open the Command Palette (Ctrl/Cmd + P).
  2. Run New event.
  3. Type what happened.
  4. Press Enter.

That's it. A permanent Markdown file exists in your vault.

Optional details

Click Optional details in the modal to set:

  • Occurred — When it actually happened (defaults to now).
  • Type — Category of the event.
  • Tags — Comma-separated tags.
  • Notes — Additional context.

Timeline

The Life Log Timeline sidebar shows all events grouped by year, month, and day. Click any event to open its file.

Today in history

If enabled in settings, the sidebar shows events from this calendar day in past years.

Settings

Setting Description Default
Storage folder Where event files are stored Life Log
Default event type Type assigned to new events Other
Today in history Show historical events in sidebar On

File structure

Events are stored as:

Life Log/
  2026/
    2026-07-22-153501-first-coffee-of-the-day.md
    2026-07-22-190210-went-for-a-morning-walk.md

Each file contains YAML frontmatter:

---
id: 01HXM7S4C8N9
title: First coffee of the day
occurred: 2026-07-22T08:15:00+05:30
created: 2026-07-22T21:04:13+05:30
type: Travel
tags: []
---

Development

Prerequisites

  • Node.js 18+
  • npm

Setup

git clone https://github.com/sahilium/obsidian-life-log.git
cd obsidian-life-log
npm install

Commands

Command Description
npm run dev Start watch mode (rebuilds on file changes)
npm run build Production build
npm run test Run tests with Vitest
npm run test:coverage Run tests with coverage report
npm run lint Lint with ESLint

Testing

npm run test

Tests cover utility functions, search logic, and file serialization. Run with coverage:

npm run test:coverage

Coverage reports are uploaded to Codecov on CI.

Contributing

See CONTRIBUTING.md for guidelines.

Security

See SECURITY.md for reporting vulnerabilities.

Changelog

See CHANGELOG.md.

License

0-BSD

Sponsors