jchultarsky/mirador v0.3.0

0.3.0 - 2026-07-25

on GitHub

Release Notes

Added

• mirador-update, installed beside the binary by the shell and PowerShell
  installers. It asks GitHub for the newest release and installs it if that is
  newer, so upgrading no longer means going back to the releases page. It runs
  only when invoked: mirador itself never checks for updates and does not know
  the program exists, which keeps the "no telemetry" line in the README exactly
  as true as it was. Anyone who installed with cargo install or from source
  upgrades the way they installed.

• Settings changed from the keyboard are remembered across restarts.
  Weather units, the task sort order, whether completed tasks show, seconds on
  the clock, and the pomodoro durations. The watchlist already did this for
  symbols; this is the same answer generalised.

  mirador still never rewrites your config — the property that makes it safe to
  hand-edit and keep in git. The config seeds a setting and a small state
  file beside your tasks records where you moved it since. Deleting that file
  puts everything back, which the file's own header says, because a preference
  you cannot remember setting needs an obvious way out.

  Only what you actually changed is written. Pressing u records the units
  and nothing else. The first version reported every panel's current value,
  which pins the config's own settings into the state file the moment any one
  preference moves — after which editing the config silently stops working.
  That passed its tests and was caught by running it.

  Panel sizes are deliberately excluded: Ctrl+arrow resizing is geometry
  rather than preference, and remembering it would mean a saved width quietly
  overruling a [layout] edited by hand.

• Pomodoro panel. A focus timer in the same block numerals the clock uses:
  space starts and pauses, n skips a phase, r restores the current one,
  and +/- change the length of the phase you are in. Focus is brass and
  breaks are moss, with the phase named above the numerals as well, because
  colour alone is a poor way to tell someone whether they are meant to be
  working. A paused timer greys out rather than blinking — this is a dashboard
  you leave open, and a flashing clock is the opposite of that.

  + and - move the phase length and the time left together, so adding a
  minute part-way through does not rewind you to the start. A phase that ends
  while you were away advances exactly one step against a fresh clock rather
  than chaining from the deadline it missed, so a laptop resumed after an hour
  does not race through six phases catching up.

  An optional chime, off by default, rings when a phase ends. With no
  command configured it is the terminal bell, which lets your terminal decide
  whether that means a sound, a flash, or nothing. mirador ships no audio
  library on purpose: playing a file means linking the platform audio stack,
  and on Linux that is a C library and its dev headers on every builder — a
  large amount of machinery for one notification. chime_command names a
  player instead, run directly with no shell in the way, and a player that
  cannot start is reported in the panel rather than silently doing nothing.

Fixed

• The pomodoro panel stops claiming space it cannot use. It declared a maximum
  of 102 columns and 21 rows — the width of the numerals at the largest scale
  the clock allows — and on a wide terminal it took them, from the task list.
  The numerals are now capped at the scale where MM:SS is 38 columns by 5
  rows, which is already a chunky readout; scale 2 is 68 columns and scale 3 is
  98, and a timer occupying half a dashboard reads as an alarm rather than an
  instrument. The panel now declares 42 by 10 and hands everything past that to
  a neighbour, and the figures are pinned by a test so they cannot drift back.
• The README says what happens when you upgrade. A new widget does not appear
  in a config you already have — mirador never rewrites your config, which is
  what makes it safe to hand-edit, so a config written by an earlier version
  lays out the panels that existed when it was written and nothing since. The
  status bar has always named the widgets a layout does not place; the README
  now explains the notice, shows what it looks like, and gives the row to paste.
  The first person to add the pomodoro panel to an existing config went looking
  for a missing setting instead.
• The README's checksum command no longer prints a warning. dist writes its
  .sha256 files with a trailing blank line, so shasum -c verified the
  archive and then added WARNING: 1 line is improperly formatted — true of
  the blank line, not of the hash, but a warning printed beside a checksum is
  the one place ambiguity is worst. Piping through grep . drops the blank
  line; both the macOS and Linux forms are tested to print OK and exit 0 on a
  good archive and FAILED and exit 1 on a tampered one. A Windows form is
  documented too, now that there is a Windows archive to verify.

Install mirador 0.3.0

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/jchultarsky/mirador/releases/download/v0.3.0/mirador-installer.sh | sh

Install prebuilt binaries via powershell script

powershell -ExecutionPolicy Bypass -c "irm https://github.com/jchultarsky/mirador/releases/download/v0.3.0/mirador-installer.ps1 | iex"

Download mirador 0.3.0