README file from
GithubLife Timeline
A JSON-based life timeline for Obsidian. Group events under colored eras, add events with optional date ranges, and edit everything inline from within your notes.
Features
- Group events into colored eras with descriptions
- Add events with a start date and an optional end date (
May 1, 2000 ~ Jun 3, 2004) - Inline add / edit / delete for both eras and events — no manual JSON editing required
- Collapse eras, reorder them, and hover an era to see its description
- All data is stored in a plain JSON file inside your vault, so it stays portable and version-control friendly
Usage
Add a life-timeline code block to any note. The block body is the path to the JSON data file (relative to the vault root). If left empty, the default path from settings is used.
```life-timeline
life-timeline.json
```
Or simply:
```life-timeline
```
The first time you open it, use the + Era and + Event buttons to build your timeline. The JSON file is created automatically on first save.
Data format
{
"eras": [
{ "id": "era1", "name": "Childhood", "color": "#5b9bd5", "desc": "...", "order": 0 }
],
"events": [
{ "id": "ev1", "eraId": "era1", "date": "2000-05-01", "dateEnd": "", "name": "Born", "content": "..." }
]
}
Settings
- Default data file — the JSON path used when a
life-timelineblock is left empty.
Credits
The idea for a timeline view in Obsidian was originally inspired by Timeline by George Butco (MIT License). This plugin is an independent, JSON-based reimplementation and does not share code with the original.