Skip to content

For Obsidian users

Your Obsidian Tasks as a Gantt timeline, in a native Mac app.

nokko is a native Mac app that reads the Obsidian Tasks dates in your vault and draws them as a Gantt timeline you can drag. Each project is a row, its tasks sit on it, and moving a bar rewrites the dates in the Markdown file. We built it for our own agency's client work, on a vault we also keep open in Obsidian.

Download on the Mac App Store
Download on the App Store

Free to download and read. Editing is free for 14 days.

There are three ways to get a Gantt chart from an Obsidian vault.

Obsidian renders Mermaid diagrams, and Mermaid has a gantt block. You type the tasks and their dates into the code block and Obsidian draws the chart. It needs nothing installed. The catch is that the chart keeps its own copy of the dates, so when a due date changes on the task, the chart does not follow.

Several community plugins draw a timeline from the Tasks emoji dates instead, inside Obsidian. If you want the chart in the same window as your notes, start there. They differ in what they can edit and where they run, so read each plugin's page.

The third way is a separate app on the same folder, which is what nokko is. It reads the files Obsidian reads, draws the timeline natively on the Mac, and writes any date you drag back into the task line.

The timeline reads the πŸ›« start, ⏳ scheduled and πŸ“… due dates on your tasks.

A project's bar runs from the start and due dates in the file's frontmatter. When a file has neither, the bar spans the dates of its open tasks, so a vault that never had project dates still gets a timeline. Expand a project and each task gets its own sub-row, from its πŸ›« or ⏳ date to its πŸ“… date.

Milestones are tasks marked 🎯 and are drawn as diamonds. That one mark is ours: the Tasks plugin does not use it, and Obsidian shows it as a plain character. Dependencies use the Tasks plugin's own πŸ†” and β›” fields, drawn as arrows for the row you hover over or select.

---
type: project
client: Halden Coffee
start: 2026-10-01
due: 2026-11-19
---
## Build

- [ ] Design sign-off 🎯 πŸ“… 2026-10-09
- [/] Homepage hero πŸ†” hero πŸ›« 2026-10-05 πŸ“… 2026-10-16
- [ ] Product grid β›” hero πŸ›« 2026-10-17 πŸ“… 2026-10-28

Dragging a bar rewrites the dates in the file and nothing else.

Drag a project's bar and its start and due dates move together. Drag either end to change just that one. Drag a task's tick to change its πŸ“… date. Nothing is written until you let go, and the rest of the line, the notes around it and any syntax nokko does not know stay exactly as they were.

Dependency arrows are drawn and never enforced. Moving one bar does not shift the others, because a chain of automatic date changes is a diff you did not ask for. Overdue work turns a warning colour, and the today line is always there.

Zoom has four levels: Week, Month, Quarter and Year, which fit four weeks, three months, four quarters or three years across the window.

The Timeline view: ten client projects drawn as bars across October and November, each with its completion percentage, milestones as diamonds, and a violet today line.
The Timeline view: ten client projects as bars across October and November, milestones as diamonds, and the today line.

If you want the chart inside Obsidian, or on Windows or an iPad, use a plugin.

nokko is a Mac app that sits beside Obsidian. If you want the timeline in an Obsidian pane, or on Windows, Android or an iPad, a community plugin or a Mermaid block is the right tool. The timeline is not in our iPhone app either. The phone shows Today, each project's progress against the calendar, and the timer.

It is also a timeline for client projects, sized for a few people. It does not do resource levelling, critical paths or baselines.

Three ways to a Gantt chart, side by side.

Plugins differ a lot from one another, so where the answer depends on which one you install, the table says so.

nokko compared with Mermaid gantt block and with Community plugins
CapabilitynokkoMermaid gantt blockCommunity plugins
Reads the dates already on your tasksYesNo, dates are typed into the blockDepends on the plugin
Drag a bar to change a dateYesNoDepends on the plugin
Milestones and dependency arrows🎯 milestones, πŸ†” and β›” arrowsIn Mermaid's own syntaxDepends on the plugin
Runs inside ObsidianNoYesYes
Works on Windows, Android and iPadNoYesDepends on the plugin
Native Mac appYesNoNo
Time tracking and invoices from the same tasksYesNoNo

Swipe sideways for the other columns.

Mermaid and the community plugins are free and live inside Obsidian. nokko is a separate Mac app, free to read, that also runs a timer and drafts invoices from the same files.

The things people ask.

How do I make a Gantt chart in Obsidian?

There are three ways. Write a Mermaid gantt code block, which Obsidian renders with nothing installed but which keeps its own copy of the dates. Install a community plugin that draws a timeline from the Tasks emoji dates. Or open the vault in a separate app such as nokko, which draws a Gantt timeline from the πŸ›«, ⏳ and πŸ“… dates and writes any date you drag back to the task line.

Can Obsidian Tasks show a timeline view?

The Tasks plugin shows its query results as lists. For a timeline you need a community plugin, a Mermaid block, or an app that reads the same files. nokko is one of those apps, for the Mac: it reads the Obsidian Tasks format and draws each project as a bar with its tasks, milestones and dependencies.

Does nokko change my task lines when I drag a bar?

Only the date you moved. Dragging a project bar rewrites start and due in the frontmatter, and dragging a task's tick rewrites its πŸ“… date. Everything else on the line and in the file stays byte for byte, including syntax nokko does not recognise.

Does nokko understand Obsidian Tasks dependencies?

Yes. It reads the πŸ†” and β›” fields the Tasks plugin uses and draws an arrow from one task to the next for the row you hover over or select. It never moves a dependent task for you; dates change only when you change them.

Is the Gantt timeline on the iPhone?

No. The timeline, the board and the calendar are on the Mac. The iPhone app shows Today, each project's progress and hours, quick add, and a timer on the Lock Screen, on a full copy of the same files.

How much does nokko cost?

The download is free and reads everything, forever. Editing is €6.99 a month or €49.99 a year after a 14-day trial, or €129 once, in the EU store; the App Store shows your own country's price. One purchase covers the Mac and the iPhone.

Everything else is on the features page and under pricing.

Free to read, on your Mac and your iPhone.

Download it, open a folder, and read everything your studio has planned. Subscribe when you are ready to edit; the first 14 days are free, and one subscription covers both.

Download on the Mac App Store
Download on the App Store

macOS 26 Β· Apple silicon Β· iOS 26