Noteline

by Andrey Torlopov
5
4
3
2
1
Score: 50/100

Description

Reviews

No reviews yet.

Stats

0
stars
244
downloads
0
forks
30
days
20
days
29
days
0
total PRs
0
open PRs
0
closed PRs
0
merged PRs
0
total issues
0
open issues
0
closed issues
9
commits

Latest Version

a month ago

Changelog

Noteline 0.4.1

Card dates now use the canonical source value for display. The full calendar coordinate remains available for sorting and placement, but cannot supply extra components to a card label.

Note value Card label
2026-10-23 2026-10-23
2026-10 2026-10
2026 2026
2026-10-23 00:00 2026-10-23 00:00
2026-10-01 2026-10-01

Roman centuries and BCE labels retain their existing notation. A missing date still uses the saved day of insertion. Note contents, timeline coordinates, scale labels, touch controls, and the .timeline schema are unchanged.

Verification: metadata and actual card-update regressions, the complete automated suite, lint, typecheck, manifest validation, and production build. The original device report was not reproduced in the existing source path; this update hardens the display contract against lost precision. Confirmation in the user's Obsidian installation is still needed. If the Markdown itself already contains a full timestamp, its explicit time remains visible. Date rules.

Update: replace main.js, manifest.json, and styles.css together and reload the plugin. Requires Obsidian 1.7.2+; ID remains noteline. For rollback, reinstall the three release assets from 0.4.0; no new migration is involved.


Дата карточки теперь выводится из исходного нормализованного значения. Полная календарная координата используется для сортировки и размещения, но не может дописать лишние компоненты в подпись карточки.

Значение в заметке Подпись карточки
2026-10-23 2026-10-23
2026-10 2026-10
2026 2026
2026-10-23 00:00 2026-10-23 00:00
2026-10-01 2026-10-01

Римские века и обозначения до нашей эры сохраняют прежний формат. При отсутствии даты используется сохранённый день добавления. Текст заметок, координаты, подписи шкалы, сенсорное управление и схема .timeline не меняются.

Проверка: регрессии метаданных и настоящего метода обновления карточки, полный набор автоматических тестов, lint, типы, манифесты и production-сборка. Исходное поведение с устройства не воспроизведено на существующем пути исходников; выпуск усиливает гарантию вывода при потере точности. Результат ещё нужно подтвердить в установленном Obsidian пользователя. Если сам Markdown уже содержит полный timestamp, явно указанное время сохраняется. Правила дат.

Обновление: замените main.js, manifest.json и styles.css вместе, затем перезагрузите плагин. Требуется Obsidian 1.7.2+, ID остаётся noteline. Для отката переустановите три файла выпуска 0.4.0; новой миграции нет.

README file from

Github

Noteline for Obsidian

English · Русский

Why Noteline

A project, a research journal, or a collection of ideas often makes more sense in chronological order. Noteline places your existing Obsidian notes on timelines so you can see when things happened and read the notes in context.

Create independent .timeline files, select notes from any folder, and open different timelines in separate tabs. Each file keeps its own selected notes, layout, date settings, and view. Your notes stay ordinary Markdown files in their original locations.

Documentation is available in English and Russian. The interface in version 0.4.1 is Russian. English guides include the actual Russian control labels. Translating the documentation does not add an interface language switch.

Who it's for

Noteline is useful whenever the order of milestones, events, or log entries matters:

Audience Example timelines
Teachers Lesson topics, course milestones, and events discussed with students
Developers Releases, incidents, technical decisions, and development logs
Managers Project milestones, meetings, decisions, and progress journals
Historians Historical events, archival notes, years, and centuries, including BCE

Use a dated Markdown note for each milestone, event, or log entry, then group related notes in a dedicated .timeline file. A note can appear on several timelines while keeping one source text.

What you can do

  • Add existing Markdown notes from anywhere in your vault, including folders with identical filenames.
  • Keep several file-backed timelines and open them in separate tabs.
  • Read dates from note properties or a leading 📅 line, with minute, day, month, year, or century precision, including BCE years and centuries.
  • Collapse cards to their title, date, and tags, or expand them to read native Obsidian Markdown.
  • Choose a horizontal or vertical time axis, reverse its chronological direction, and arrange cards without changing their dates.
  • Zoom, pan, fit the selected notes, and jump to a date or today.
  • Swipe along the time axis on a touch device; swipe across it to browse card levels. Expanded text keeps its own scrolling area.
  • See missing metadata immediately: notes without a date or tags have a gray frame and a text explanation.
  • Add a tag explicitly to the original note; adding or moving a card does not rewrite the note.
  • Save timeline membership and layout in vault .timeline files, with light and dark themes and touch-friendly action buttons.
  • Use a thin time axis with ringed note markers, fine card borders, rounded tags, and a subtle gradient background inspired by the banner.

If a note has no date, Noteline uses the local date when you add it and saves that fallback. The card stays on that day instead of moving with “today.” If only tags are missing, the note keeps its original date. Date and tag rules.

Version 0.4.1 builds card date labels from the source value: 2026-10-23 stays a date, 2026-10 stays a month, and 2026 stays a year. Explicitly supplied 00:00 remains visible. Release notes.

Quick start

Obsidian 1.7.2 or newer. Version 0.3.0 passed native macOS smoke checks with Obsidian 1.14.4. The plugin uses browser-compatible APIs and enables mobile installation. Physical iOS/Android, Windows/Linux, Obsidian 1.7.2 itself, touch gestures, and actual sync transport/provider conflicts remain unverified.

Version 0.4.0 fixes the missing touch-pan implementation reported on iOS. This iteration has static and automated regression checks; verification in Obsidian on a real iOS device is pending. Touch controls and device check.

  1. Install a built copy in a test vault. A source checkout alone is not an installed plugin. Community directory installation requires review and acceptance by Obsidian.
  2. Open the command palette and run Noteline: Открыть временную ось — Open timeline.
  3. Create a .timeline file if this is your first timeline, or select an existing one. Commands Noteline: Создать временную ось and Noteline: Выбрать временную ось create and select timelines. Different files can stay open in separate tabs.
  4. Choose Добавить заметку — Add note — and select a note by name or path. The file context menu and active-note command also let you choose the destination timeline.
  5. Expand a card with its expand button. Use the title to open the original note for editing. Choose the time-axis orientation and direction in the toolbar.
  6. Use −/+ to zoom and Показать все — Show all — to fit the selected dates. The toolbar also provides timeline selection, creation, deletion, saving a copy, and reloading from disk.

Continue the quick start.

Note formats

Use existing properties or a small metadata block at the beginning of the note:

---
timeline-date: "2026-10-22 15:30"
tags:
  - research
  - ideas/audio
---
📅 2026-10-22 15:30
📍 Tags: #research #ideas/audio

---

Your note content.

The default date priority is timeline-date, then date, then the leading 📅 line. Property names and their order are configurable per timeline. Supported values also include 2026-10, numeric YAML years such as date: 2026, uppercase Roman centuries such as XIX, and 44 BC or II BC. Partial values keep their precision and do not display invented days. Dates are calendar values without a time zone. Supported formats, conflicts, and missing fields.

Documentation

Your notes and your data

Each .timeline file stores its selected note paths, fallback dates, layout, date settings, orientation, direction, and viewport. The plugin's data.json remembers the last opened path and retains legacy data after migration. Opening, expanding, moving, or removing a card from a timeline does not delete or rewrite its source note. Adding a tag is an explicit write to that note, visible in every timeline that uses it.

Back up and synchronize the .timeline files together with their notes and attachments. Do not assume your sync tool includes this custom extension. Use one active writer per timeline and wait for sync before switching devices; simultaneous layouts are not merged automatically. Existing single-timeline data is migrated to Noteline.timeline, with a different available name if necessary, while the old data is retained. Storage, migration, desktop/iOS sync, and recovery.

The plugin makes no network requests of its own, collects no telemetry, and needs no account or server. Obsidian's Markdown renderer and other installed plugins may load external content referenced in a note.

Development

Node.js 24+ and npm are development tools; users only need the built plugin files.

npm ci
npm run check
npm run build

The production build creates main.js. Install it alongside manifest.json and styles.css; do not copy node_modules into a vault. GitHub release assets use these three files individually, with a tag matching manifest.version. Build and publication guide.

Scope of version 0.4.1

Multiple independent timeline files, one card per note within each timeline, horizontal or vertical axes, and either chronological direction. A copy of a timeline keeps references to the same notes; it does not duplicate their contents. There are no event intervals, date editing by dragging, image export, collaborative conflict merging, or pinch-to-zoom. Files renamed while the plugin is disabled may need manual relinking. Compatibility and limitations.

Licensed under MIT. The original banner artwork is provided under CC0 1.0.

☕ Buy me a coffee

If you find this project useful, you can support my work on Boosty.