v0.3.0

[not-elm]

Highlights

The default shortcuts are now Alt chords

Until 0.2, the stock pane and vi-mode shortcuts started with <Leader>. Tapping the leader before every key made frequent actions, such as moving between panes, awkward, so they are now direct Alt chords:

Action	0.2	0.3
Move between panes	<Leader>h / j / k / l	Alt+h / j / k / l
Split a pane	<Leader>i / o	Alt+i / o
Close a pane	<Leader>p	Alt+p
Resize a pane	<Leader:r>Shift+H / J / K / L	Alt+Shift+H / J / K / L
Enter vi mode	<Leader>s	Alt+s

This is a breaking change. Before you upgrade:

• macOS: the right Option key is now Alt (option_as_alt defaults to "right"), so it no longer types special characters. A Japanese (JIS) keyboard has no right Option key; set option_as_alt = "left" or "both" there.
• The Alt chords orzma binds no longer reach the shell, such as readline's Alt+c and Alt+r.
• If your configuration binds one of these chords to another action, orzma does not start until you rebind one of the two.
• Repeatable bindings are now written r:<Leader>x. A configuration that still uses <Leader:r>x is ignored as a whole.

The leader key is still there for your own bindings, and you can bind the 0.2 keys back: Upgrading has the snippet, and Default Key Bindings lists every key.

Tabs

orzma now keeps several pane layouts as tabs, listed in a tab bar at the top of the window, so you can keep several screens going at once and switch between them. The shells in the tabs you are not looking at keep running.

Action	Key
Open a new tab	Alt+c
Next / previous tab	Alt+] / Alt+[
Show tab 1–9	Alt+1 … Alt+9
Rename the tab	Alt+r
Close the tab	Alt+Shift+X

The mouse works too: click a tab to show it, + to open one, × to close one, double-click to rename, and drag to reorder. A tab you have not named shows the title of its active pane, and a new tab starts in the working directory of the active pane. Closing the last pane of a tab closes the tab, and closing the last tab quits orzma.

See Panes and Tabs for details.

Also in this release

• Cmd+click (Ctrl+click on Windows and Linux) opens a URL printed as plain text, such as the address a development server prints.
• orzma's shortcuts, other than copy and paste, now run while a web page has focus. Set direct-chords-over-webview = false in [shortcuts] to give them back to the page.
• The wheel scrolls about three lines per cell of travel instead of six.
• The macOS download is a .dmg instead of a .zip.
• orzmd and orzbrowser draw their interface in the page. Quit them with q; Ctrl+c no longer quits.
• Fixed: the window closed when the display went to sleep, and Cmd stayed held after Cmd+Shift+5 on macOS.

PR

⚠️ Breaking Changes

• feat: add workspaces with a top tab bar by @not-elm in feat: add workspaces with a top tab bar #370
• feat(input): count Alt per key, excluding AltGr and a composing Option key (PR-A of 3) by @not-elm in feat(input): count Alt per key, excluding AltGr and a composing Option key (PR-A of 3) #376
• feat!: mark repeatable bindings with r: and let an abandoned leader key reach its direct chord (PR-B of 3) by @not-elm in feat!: mark repeatable bindings with r: and let an abandoned leader key reach its direct chord (PR-B of 3) #377
• feat!: bind the stock pane, workspace, and vi-mode shortcuts to Alt chords (PR-C of 3) by @not-elm in feat!: bind the stock pane, workspace, and vi-mode shortcuts to Alt chords (PR-C of 3) #378

🚀 Features

• ci(release): publish each release once, from a reviewed draft by @not-elm in ci(release): publish each release once, from a reviewed draft #366
• feat(release): ship the macOS app as a dmg instead of a zip by @not-elm in feat(release): ship the macOS app as a dmg instead of a zip #368
• feat(input): let direct shortcuts fire over a focused webview by @not-elm in feat(input): let direct shortcuts fire over a focused webview #369
• feat(orzmd): draw the rail, find box, outline sidebar, and toast in the page by @not-elm in feat(orzmd): draw the rail, find box, outline sidebar, and toast in the page #371
• feat: open URLs detected in plain text with Cmd/Ctrl+click (PR-B of 2) by @not-elm in feat: open URLs detected in plain text with Cmd/Ctrl+click (PR-B of 2) #373
• feat(orzbrowser): draw the toolbar and address bar in a webview, with free search by @not-elm in feat(orzbrowser): draw the toolbar and address bar in a webview, with free search #375
• feat(orzmd): handle every key in the page with smooth scrolling by @not-elm in feat(orzmd): handle every key in the page with smooth scrolling #381
• feat: scroll 3 lines per cell of wheel travel by default, like Alacritty by @not-elm in feat: scroll 3 lines per cell of wheel travel by default, like Alacritty #382
• feat(ui): draw workspace tabs as rounded pills inside the tab bar by @not-elm in feat(ui): draw workspace tabs as rounded pills inside the tab bar #383
• feat(ui): color the displayed workspace tab with the app icon's violet by @not-elm in feat(ui): color the displayed workspace tab with the app icon's violet #385
• refactor: rename workspaces to tabs by @not-elm in refactor: rename workspaces to tabs #388
• feat: label unnamed tabs with their active pane's title by @not-elm in feat: label unnamed tabs with their active pane's title #390

🐛 Fixes

• fix: keep the window open when its monitor disappears on display sleep by @not-elm in fix: keep the window open when its monitor disappears on display sleep #367
• fix(input): release modifiers macOS reports up after Cmd+Shift+5 by @not-elm in fix(input): release modifiers macOS reports up after Cmd+Shift+5 #387

📚 Documentation

• docs(book): restructure the user guide around installation, reference, and upgrade pages by @not-elm in docs(book): restructure the user guide around installation, reference, and upgrade pages #386

Full Changelog: v0.2.1...v0.3.0

---

This discussion was created from the release v0.3.0.