mirador
An opinionated personal dashboard for your terminal — world clocks, calendar and agenda, weather, tasks, notes, markets and live system metrics in a tab you leave open all day. Rust + ratatui.
What is it?
What it is
A personal terminal dashboard with panels for clocks, weather, tasks, notes, and more, designed for daily use with minimal distractions.
Why it exists
To provide a dashboard for daily glancing, not monitoring, with user-controlled data and no distractions like blinking elements.
Who should use it
Terminal users looking for a productivity dashboardDevelopers who prefer TUI-based workflowsPeople who want a glanceable, non-distracting dashboardUsers who prioritize local data ownership and privacyUsers who want to manage tasks, notes, and schedules in a single terminal tab
Who should avoid it
Users who require a GUI-based dashboardUsers who need real-time, high-frequency market data updatesUsers who want a dashboard that uses cloud-synced accounts/databases
How it works
A quick walkthrough in plain English
How mirador works
Step 1 of 3
You interact with it
Open mirador, send a request, or connect it to your stack.
Features
Advantages
- Glanceable design keeps focus on the task at hand
- No telemetry or background services—privacy by default
- All data lives in user‑editable files—easy version control
- No database or sync service required
- No API keys needed for weather or market data
- Extensible via TOML configuration and themes
- Cross‑platform terminal compatibility
- Rust implementation ensures safety and performance
- Open source community contributions possible
- Customizable layout and panel ordering
- Keyboard‑driven workflow suitable for power users
- No unnecessary notifications or pop‑ups
Disadvantages
- Requires a terminal that supports Unicode and braille glyphs
- No mobile or GUI version—only terminal
- Yahoo Finance endpoint may be rate‑limited or change without notice
- No automatic update checks unless enabled
- Limited to free APIs—no paid data services
- No built‑in account sync or cloud backup
- Complex recurrence rules in agenda may be limited
- No push notifications or alerts—only status bar warnings
- Requires manual configuration for some panels (e.g., agenda file, news feeds)
- Windows ARM support not available
Installation
native
cargo install mirador, curl --proto '=https' --tlsv1.2 -LsSf https://github.com/jchultarsky/mirador/releases/latest/download/mirador-installer.sh | sh, irm https://github.com/jchultarsky/mirador/releases/latest/download/mirador-installer.ps1 | iex, git clone https://github.com/jchultarsky/mirador && cargo install --path .
FAQ
How do I install mirador?
You can install mirador via `cargo install mirador`, a shell installer script, or by building from source. The README provides detailed instructions for each method.
Can I customize the dashboard layout?
Yes, mirador uses a TOML config file to define panels, their order, and sizes. You can edit this file or use the `w` key to toggle panels and `m` to rearrange them.
How do I add or manage tasks?
Tasks are stored in a TOML file. Use the `a` key to add a task, `e` to edit, and `d` to delete. Due dates support relative terms like `today` or `+3d`.
What data sources does mirador use for weather and markets?
Weather uses Open-Meteo (no API key required), and markets use Yahoo Finance's public chart endpoint. Both are free but may have limitations or changes.
How do I change the dashboard theme?
You can switch themes via the `t` key or by editing the `[theme]` section in your config. Predefined themes include `default`, `high-contrast`, and others.
Is my data stored locally?
Yes, tasks, notes, and settings are stored in local TOML files. No cloud sync or account is required.
Featured in Videos
YouTube tutorials and walkthroughs for mirador
Alternatives
Similar projects ranked by category, topics, and text overlap.
