jchultarsky/mirador v0.4.0

0.4.0 - 2026-07-26

on GitHub

Release Notes

Added

• A panel picker. w opens a dialog listing every widget with whether it is
  on; space toggles, and the panel appears or disappears immediately.
  Switching a widget on used to mean finding your config file and editing
  [layout] by hand — which is what the first person to meet the pomodoro
  panel actually had to do, after pressing ? and not finding the answer there
  either. The status bar notice and the help overlay both name the key now.

  Panel sizes are remembered too: Ctrl+arrow no longer lasts only for the
  session.

Changed

• Layout changes are written back into your config, reversing an earlier
  decision to keep them out of it. The rule was never really "do not write to
  the config" — it was "do not reserialise it", because a round trip through
  toml discards every comment in the file, including the ~145 mirador wrote to
  explain its own options. --migrate-config had already established the
  alternative: edit the lines that need editing and leave the rest alone.

  So [layout] is edited surgically. Adding a panel is a one-line diff; a width
  change rewrites one number and keeps its column alignment; comments inside the
  layout block survive.

  The safety property is a check rather than care: the edited text is parsed and
  compared against the layout that was asked for, and a mismatch throws the edit
  away. An unusually formatted config fails as "that did not stick", said in the
  picker, rather than as a broken file.

  Preferences that are not layout stay in the state file. The split is by what
  the setting is: [layout] is the part of the config people read and curate,
  so a change made in the UI has to show up there, while nobody keeps their
  preferred sort order under version control.

• Windows is described as working rather than as untried. The binary shipped in
  0.2.0 was built and packaged but had never been started on the platform, and
  the docs said so; it has now been run and works, installed with the PowerShell
  one-liner in the default Windows terminal. All three shipped targets have been
  started rather than merely compiled, and that is also the first real-world use
  of the PowerShell installer — the rest had only been checked from macOS. It is
  still the least-travelled of the three, which the README says instead of
  claiming a parity nobody has earned.

Install mirador 0.4.0

Install prebuilt binaries via shell script

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

Install prebuilt binaries via powershell script

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

Download mirador 0.4.0