mirador

A personal information dashboard for your terminal: world clocks, a calendar, weather, a real task list, and live CPU and network charts, laid out how you want them.

A mirador is a lookout — the tower you climb to see everything at once.

╭─ Clocks ─────────────────────╮╭─ Weather — Boston, Massachusetts ──────────╮
│ Local   09:41:07  Sat 25 Jul ││ ☀ 74°F  clear                              │
│ UTC     13:41:07  Sat 25 Jul ││ feels 76°F   wind 7 mph   humidity 58%     │
│ London  14:41:07  Sat 25 Jul ││ Sat  ☀   81° /  63°                        │
│ Tokyo   22:41:07  Sat 25 Jul ││ Sun  ⛅   78° /  61°   20%                  │
╰──────────────────────────────╯╰────────────────────────────────────────────╯
┏━ Tasks (4) ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
┃ 4 open · 1 overdue · 1 today   sort: smart                                 ┃
┃ ▸ [ ] !!! Renew the domain               #admin            2 days late     ┃
┃   [ ] !!  Reply to the design review     #work             today           ┃
┃   [ ] !   Publish 0.0.0 placeholder      #mirador #rust    in 3 days       ┃
┃   [ ]     Read the ratatui layout docs                     Fri 07 Aug      ┃
┃ Reserve the crates.io name before someone else does.                       ┃
┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛
╭─ CPU (10 cores) ─────────────╮╭─ Network ──────────────────────────────────╮
│  12.4%  average   120s window││ ↓    1.2 MB/s    ↑    184 KB/s             │
│ ▁▂▃▂▁▁▂▅▇▆▃▂▁▁▂▂▁▁▁▂▃▂▁▁▁▂▁▁ ││ ▁▁▂▁▁▃▇█▅▂▁▁▁▂▁▁▁▁▂▁▁▁▁▁▂▁▁▁▁▁▁▁▁▁▂▁▁▁▁▁▁ │
╰──────────────────────────────╯╰────────────────────────────────────────────╯

Why

There are good terminal dashboards already, but the task panels in them tend to be flat checklists. mirador treats the to-do list as a first-class feature: due dates, priorities, notes, tags, and full editing without leaving the dashboard. Everything is stored in a plain TOML file you can hand-edit or keep in git.

No accounts. No API keys. No telemetry. Weather comes from Open-Meteo, which is free and key-less.

Install

From crates.io:

cargo install mirador

From source:

git clone https://github.com/jchultarsky/mirador
cd mirador
cargo install --path .

Requires Rust 1.95 or newer. Tested on macOS and Linux.

Quick start

mirador

On first run it writes a commented config file and starts with a sensible default layout. To find the config:

mirador --config-path

Edit [weather].location to your own city and you are done.

Keys

In the task panel:

In the add/edit form, Tab and Shift+Tab move between fields, Enter saves and Esc cancels. While a form is open, global keys are suppressed, so typing a q into a task title does not quit the dashboard.

Due dates

The due field accepts more than ISO dates:

Anything else is rejected with an explanation rather than silently guessed.

Configuration

One TOML file. Run mirador --print-config to see the fully commented default.

The layout is a grid of rows, where height and width are relative weights rather than cell counts, so proportions hold at any terminal size:

[layout]
rows = [
  { height = 30, panels = [
    { widget = "clocks",   width = 26 },
    { widget = "calendar", width = 34 },
    { widget = "weather",  width = 40 },
  ] },
  { height = 45, panels = [
    { widget = "todo",  width = 58 },
    { widget = "notes", width = 42 },
  ] },
  { height = 25, panels = [
    { widget = "stocks",  width = 40 },
    { widget = "cpu",     width = 30 },
    { widget = "network", width = 30 },
  ] },
]

Widgets

Market data

The watchlist reads a free, keyless endpoint. Two things follow from that, and they are worth knowing before you file a bug:

• Access is gated on your IP address, not on a key. Datacenter and VPN ranges are blocked wholesale, so the same build can work on your laptop and fail on a VPS. Persistent HTTP 429 is that, not a rate you can tune down. The data source is a swappable trait for exactly this reason.
• Polling is deliberately unhurried — no faster than once a minute, one symbol at a time. These services are free and unauthenticated, and a burst of parallel requests is what gets an address blocked for everyone behind it.

mirador ships no API key and never will: a key baked into a public binary is a shared secret, and its rate limit would be shared too. Prices are never written to disk, only the list of symbols.

Mouse

Click a panel to focus it, and scroll the wheel over a list or a calendar to move through it. Scrolling deliberately does not move focus, so running the wheel across the screen cannot take the keyboard away from what you were doing.

While mirador holds the mouse your terminal's own click-to-select-text stops working; copying a value off the dashboard needs the terminal's override modifier, which is Shift in most terminals and Option in macOS Terminal and iTerm2. Set [general].mouse = false to keep ordinary selection instead.

Colours accept a name (red, light-blue), a hex string (#ff8800), or a 256-colour index (12). reset uses your terminal's own default.

An unknown widget name or a malformed colour is reported at startup with a message that says how to fix it, rather than being ignored.

Task file format

Tasks live in one TOML file — by default under your platform's data directory, or wherever [todo].file points. Press o in the task panel to see the path.

[[task]]
id = 1
title = "Publish 0.0.0 placeholder"
notes = "Reserve the crates.io name"
due = "2026-07-28"
priority = "high"     # high | medium | low | none
tags = ["mirador", "rust"]
done = false
created = "2026-07-25"

Writes are atomic — mirador writes a temporary file and renames it — so an interrupted save can never truncate your tasks.

Contributing

Bug reports, feature requests and pull requests are welcome. See CONTRIBUTING.md for the development workflow, and CODE_OF_CONDUCT.md for the ground rules.

Adding a widget means implementing the Panel trait, registering the name in src/widgets/mod.rs, and documenting it here. Nothing else in the codebase needs to know it exists.

Acknowledgements

Built with ratatui. Weather data from Open-Meteo. Dates and timezones handled by jiff; system metrics by sysinfo.

License

MIT. See LICENSE.