This page is part of Splay's manual. Read it with its figures and navigation at https://shawntz.github.io/splay/changelog/.
Changelog
Splay’s releases. CHANGELOG.md in the source is upstream Dinky’s, merged in
as it stands, and lists Dinky’s releases.
0.6
- When a release has moved default keys since your
splay.tomlwas written, Splay now asks when it starts. A window lists each command with its new keys and the keys your file still has. Use the New Keys changes those keys in your file and keeps the file as it was beside it, assplay.toml.before-0.6. Keep My Keys leaves the file alone, and Splay does not ask about those keys again on that Mac. As long as Splay can move them, its menu has a Use Splay’s New Keys item that brings the window back. - For a file from 0.4 or earlier, the new keys are Alt-Cmd-Left and Alt-Cmd-Right to walk the strip, and Alt-Cmd-Home and Alt-Cmd-End for its ends. Alt-H and Alt-L are added with the two arrows, unless your file already uses either. Until now an update left the old keys in place, because Splay never changed a config that existed.
- Splay changes only the key lines an older default wrote, and adds the keys that come with a move. It renames a moved key where your file binds it as an older default did. A key you removed stays removed, and a key you gave another command stays yours. A comment Splay wrote above those keys is replaced only when you have not changed it and your file ends up with every key it describes. Settings, rules and your own bindings stay as they are.
- Splay changes nothing, and says why once, when your file lists
exclude-appsfor a moved key, or already binds the key that would replace it, such asalt-cmd-left. It does not ask about a file that has a comment of the current default above these keys, since the older keys in it were put back by hand. splay doctorwarns when a config still has an older default’s keys.
0.5
- A newly written
splay.tomlwalks the strip with Alt-Cmd-Left and Alt-Cmd-Right, and with Alt-H and Alt-L as in Dinky. Alt-Cmd-Home and Alt-Cmd-End jump to its ends. On a laptop, Home and End are Fn with the left and right arrows. Alt is the Option key and Cmd is the Command key. Option-Left and Option-Right alone stay with apps, where they move by a word in text fields. - Splay 0.5 does not change a
splay.tomlthat exists, so nothing changes for you until you edit it. From 0.6 Splay asks to move the keys. A file written by 0.4 hasalt-left,alt-right,alt-homeandalt-end, and one written by 0.3 or earlier hascmd-left,cmd-right,cmd-homeandcmd-end. To switch, rename those four toalt-cmd-left,alt-cmd-right,alt-cmd-homeandalt-cmd-end. Then, if you want them, addalt-h = 'focus left'andalt-l = 'focus right'right below the[mode.main]line, unless the file already has them. A key written twice stops the file from loading. - The new keys no longer reach apps while Splay runs. Chrome and Firefox switch tabs with Option-Command-Left and Option-Command-Right, and iTerm2 and Ghostty move between split panes with them. Option-L types @ on a German layout and ł on a Polish one.
exclude-appson a binding leaves its key to the apps you list,alt = 'left'under[modifiers]leaves the right Option key alone, and deleting thealt-handalt-llines frees Option-H and Option-L.
0.4
- The strip’s default keys are on Option. A newly written config walks the strip with Alt-Left and Alt-Right and jumps to its ends with Alt-Home and Alt-End. Alt is the Option key. Cmd-Left and Cmd-Right stay with apps, where they reach the ends of a line in text fields and go back and forward in browsers. Cmd-Home and Cmd-End stay with apps too.
- Splay 0.4 does not change a
splay.tomlthat exists, so a file written by 0.3 or earlier keeps Cmd-Left, Cmd-Right, Cmd-Home and Cmd-End. To switch, renamecmd-left,cmd-right,cmd-homeandcmd-endin it toalt-left,alt-right,alt-homeandalt-end. Splay’s menu shows each command with the key your file gives it. - With the new keys, Option-Left and Option-Right no longer move by a word in text fields. In standard macOS text fields Ctrl-Option-B and Ctrl-Option-F still do.
alt = 'left'under[modifiers]leaves the right Option key to apps.
0.3
brew install --cask shawntz/tap/splayinstalls Splay with Homebrew and links thesplaycommand.- A window Splay cannot reach when it quits, such as one closed with Cmd-W that its app keeps around, is no longer forgotten. Splay keeps its original place and puts it back at a later quit, once the window is open again. Before, it stayed at its tiled spot for good.
- The menu’s Restore item, and
splay recover, count only the windows a restore can reach now.
0.2
- When Splay finds a new version on its own, it shows
↑after the workspace number and an Update to Splay item in its menu, and keeps both until you install or skip the update. Before, the update window could open behind other windows. - A newly written config names Splay’s schema on its first line, so editors with Taplo or Even Better TOML check and complete it with no setup. To get this in a config written by 0.1, add
#:schema https://shawntz.github.io/splay/schemas/splay.jsonat the top. - A build from source reports version 0.0 and carries no update feed, so it never offers to replace itself with a release.
0.1
The first release. What Splay adds to Dinky:
- Scrolling is the default layout, and Cmd-Left and Cmd-Right focus left and right along the strip. Alt-H and Alt-L are left unbound.
- The strip commands
center-column,column-width,maximize-columnandfocus-column, in the menu and on Alt-C, Alt-R and Alt-Shift-R, Alt-M, and Cmd-Home and Cmd-End. - The
[scrolling]keyscenter-focused-column,preset-column-widthsandpeek. - A focus step into another column lands on the window last focused in it.
- Another column closing or changing width leaves the focused column where it is on screen.
- Windows already open at launch go into the strip left to right, as they stand on screen.
- For half a second after Splay focuses a window, or until macOS reports it in front, commands start from that window. Quick presses of
focus rightstep one column each, and a command pressed right after acts on the window just focused. - Closing the terminal an attached run was started from quits it and puts the windows back.
- Closing the Accessibility window before granting access quits Splay.
- Started from a terminal or another app, the Accessibility window and
splay doctorsay whose grant counts. - A strip command in a rule works on the window the rule matched.
splay versionreads the app’s version through a link to the executable.- Each tree in
debug-statenames its layout. start-at-loginisfalseunless set.- Its own names, so it can sit beside Dinky: the
splaycommand,~/.config/splay/splay.toml,$TMPDIR/splay.sock,~/Library/Logs/splay.log,~/Library/Application Support/splay,SPLAY_hook variables and the bundle IDcom.shawnschwartz.splay. - A running Dinky counts as another tiling window manager.
- Releases are universal, signed with Developer ID and notarized. Splay updates itself from its own feed, with Check for Updates in the menu.
- If you ran a source build before, macOS still holds the Accessibility grant for that build’s signature. Remove Splay from System Settings > Privacy & Security > Accessibility, or run
tccutil reset Accessibility com.shawnschwartz.splay, then turn on the release.