Commit Graph
59 Commits
Author SHA1 Message Date
LGUG2Z 4e66b46e87 docs(schema): clean up unused schema opts from windows
This commit removes some Windows-only schema opts from StaticConfig and
updates the justfile to start generating content for the new Starlight
documentation site.
2025-12-26 11:02:47 -08:00
LGUG2Z 49ac638d4e feat(cli): add custom output dir for docgen cmd 2025-12-26 09:21:48 -08:00
LGUG2Z f42457e2e8 feat(animation): add window movement animations
This commit adds window movement animations to komorebi for macOS,
maintaining configuration API compatibility with komorebi for Windows.

The animation system is adapted from the Windows implementation but uses
macOS-specific APIs for screen update batching and accessibility
control, and borrows heavily from the implementation details of
animations in rift.

In order to have decent performance, there are some calls to private
APIS. For this reason, the animation feature will be marked as "UNSAFE".

UNSAFE features should be expected to break between major operating
system updates, and depending on which way I want to go, may only
support one major macOS version at a time (i.e. they will not have a
backwards compatibility guarantee with previous versions of macOS).

This currently look awful when used with the Scrolling layout, but looks
relatively good with other layouts. As with Windows, the animations
when two windows of very different sizes change position aren't great.

Some high level notes on the implementation:

* Uses the private SkyLight framework for screen update batching via
  SLSDisableUpdate/SLSReenableUpdate - these APIs prevent visual flicker
  by compositing all window position changes at once rather than updating
  each window individually during layout operations
* AnimationEngine runs animations in background threads with frame-based
  timing, supporting cancellation when new animations are triggered for
  the same window
* MovementRenderDispatcher implements the RenderDispatcher trait to
  interpolate window positions using configurable easing functions
* All 30+ easing styles from the Windows implementation are supported,
  including standard CSS-style functions and CubicBezier for custom curves
* Enhanced User Interface (AXEnhancedUserInterface) is temporarily
  disabled during window positioning operations for better performance
* The Transparency animation prefix is not supported on macOS as there
  is no equivalent to the Win32 transparency feature

This feature is off-by-default and can be enabled in the static config
or via komorebic commands (animation, animation-duration, animation-fps,
animation-style).
2025-12-23 19:04:33 -08:00
LGUG2Z 1cb3327395 chore(deps): bump schemars to 1.1 and netdev to 0.40 2025-12-21 10:00:55 -08:00
LGUG2Z bc6236abc0 refactor(cli): use "args" var name uniformly 2025-12-07 17:27:07 -08:00
LGUG2Z 23a2cccdf6 docs(cli): improve quickstart output formatting 2025-11-25 20:18:40 -08:00
LGUG2Z db8cf858ff build(nix): pull git rev info from flake inputs
This commit adds a new workspace crate, version, which is consumed by
komorebi and komorebic.

If either of those binaries are being built by
the Nix Flake, the git rev info will be pulled from inputs.self.rev
instead of querying the git repo, because the git files are not passed
to the derivation.

The build.rs for the version crate decides if the build is happening by
querying the shadow-rs build output for BRANCH, which will always be
empty when a "nix build" is running.

Cargo builds will use the standard git information retrieval mechanisms
in shadow-rs.

The information in both cases is exposed as version::LONG_VERSION, and
passed to clap as the string to return when either binary is called with
the --version flag.
2025-11-06 16:57:17 -08:00
LGUG2Z b09e979af5 feat(wm): promote containers by swapping indices
This commit adds a new SocketMessage variant PromoteSwap and
corresponding komorebic promote-swap command.

PromoteSwap will also promote the focused window container to the
largest tile in the layout, but instead of removing the focused
container x from the Ring and inserting it into position 0, possibly
changing the positions of other windows between 0 and x, the indices x
and 0 in the Ring will be swapped directly.
2025-11-04 07:53:29 -08:00
LGUG2Z 34db2e2c90 feat(wm): add visual feedback for preselections
This commit adds visual feedback in the form of a ghost tile for
preselections made by the preselect-direction command.

A container with the id "PRESELECT" will be added to the workspace, and
replaced when the next manage-able window is spawned.

A new command, cancel-preselect has been added to remove both the
preselection index and the ghost tile if the user changes their mind.
2025-11-02 11:03:11 -08:00
LGUG2Z 3128968634 feat(wm): add direction preselection
This commit adds a new feature to preselect the direction of the next
spawned window with a corresponding komorebic preselect-direction
command which takes an OperationDirection.

If the OperationDirection is valid from the current position, it will be
stored in the Workspace state, and then read, applied, and deleted when
the next manage-able window is spawned.
2025-10-31 15:12:19 -07:00
LGUG2Z 9711a00cd0 feat(cli): add feedback to the license cmd 2025-10-29 08:41:47 -07:00
LGUG2Z 9dbae50909 feat(wm): add a splash screen for mdm devices
A little nudge for people to do the right thing, 1990s vibes.
2025-10-28 18:25:05 -07:00
LGUG2Z 202238aecd docs(mkdocs): add homebrew installation instructions 2025-10-27 12:21:50 -07:00
LGUG2Z 6869805b82 feat(cli): add completions cmd
Add a new "completions" command which takes a supported shell as an
argument. This command outputs a completions file to stdout, which can
be redirected to a file.
2025-10-11 13:16:22 -07:00
LGUG2Z f5a979d4b4 fix(bar): calculate margin correctly 2025-10-01 13:55:42 -07:00
LGUG2Z 9777c55a1f feat(bar): migrate the komorebi-bar
This commit migrates the komorebi-bar from komorebi for Windows. Mostly
lifting and shifting code, exposing stuff we need in komorebi-client
etc.

A few widgets will need to be reworked completely so they have been
removed for now.

Mouse and command stuff also needs updating a little so that has also
been removed for now.
2025-09-30 15:14:30 -07:00
LGUG2Z 8950a32bbb feat(cli): implement border-related cmds
This commit implements the various border-related SocketMessage variants
and the komorebic commands to send them.
2025-09-30 09:42:04 -07:00
LGUG2Z e5468dc036 feat(wm): ignore events on other spaces
This commit ensures that events and commands on spaces other than the
one that komorebi was started on will be ignored.
2025-09-27 13:26:32 -07:00
LGUG2Z cd5f660455 feat(cli): add permissions prompts to quickstart 2025-09-27 13:06:22 -07:00
LGUG2Z 6a194f7e6c docs(mkdocs): initial outline of documentation website 2025-09-26 16:47:20 -07:00
LGUG2Z d0121815ea feat(cli): add enable and disable autostart cmds 2025-09-26 15:47:59 -07:00
LGUG2Z 3792da1bb3 feat(cli): impl quickstart and update config dir
This commit implements the komorebic quickstart command, adds a sample
komorebi.json and a sample skhdrc file which get built into the
komorebic binary, and updates the default config path on macOS to
$HOME/.config/komorebi
2025-09-26 15:10:03 -07:00
LGUG2Z 7bb0aaac48 feat(cli): add docgen cmd and jsonschema just target
This commit adds a docgen command to generate markdown documentation
files of all of the CLI commands, and a justfile target to generate
JSONSchema files.
2025-09-26 12:49:23 -07:00
LGUG2Z 7217f311f2 feat(wm): implement replace configuration
I think this is the last SocketMessage variant I'll be bringing over
before working on docs. Haven't tested this one but it should work
pretty much the same as on Windows.
2025-09-25 14:32:08 -07:00
LGUG2Z c66db5a0bd feat(cli): implement display index preference cmd
This commit implements the komorebic display-index-preference command
for updating display index preferences, however the monitor
reconciliator module has not been reimplemented completely yet so these
values will not have any effect.
2025-09-25 14:23:43 -07:00
LGUG2Z 563c3b8446 feat(cli): implement save/load resize dimensions cmds 2025-09-25 13:53:35 -07:00
LGUG2Z 8f36549fae feat(cli): implement generate-static-config cmd 2025-09-25 12:41:10 -07:00
LGUG2Z c59e882a2d feat(cli): implement manage and unmanage cmds
In implementing these two I'm diverging from how komorebi for Windows
handles these a little by tracking the window IDs of manually unmanaged
applications in a global vec UNMANAGED_WINDOW_IDS.

This is due to other changes in how Show and Destroy are handled in
komorebi for macOS which means we can't just piggy-back on those
handlers like we used to.
2025-09-25 12:34:07 -07:00
LGUG2Z 20d6121568 feat(cli): implement close cmd 2025-09-25 10:29:29 -07:00
LGUG2Z a89b9cf5ac feat(cli): implement minimize cmd 2025-09-25 10:19:11 -07:00
LGUG2Z e478ab8d0a feat(wm): implement stop handlers
This commit implements the Stop and StopIgnoreRestore SocketMessage
variants and sends them from the komorebic stop command. The ctrl-c
handler in main.rs now exits with code 130, while the Stop handlers will
exit cleanly with code 0.
2025-09-25 07:30:28 -07:00
LGUG2Z 20c3bbd9a1 docs(schema): add cmd to generate notification schema 2025-09-24 18:27:04 -07:00
LGUG2Z 8a17e0ad00 feat(wm): add socket subscriptions
This commit adds in the ability for users to subscribe to notifications
via a Unix domain socket. Code was mostly just migrated from komorebi.
Tested with "nc -vklU $(komorebic datadir)/test.sock" to create the
socket and listen and then "komorebic subscribe-socket test.sock" to
subscribe for notifications.
2025-09-24 16:30:44 -07:00
LGUG2Z 795ffdfa33 docs(schema): add schemars feature + schemagen cmds
Starting to think about documentation and adding in commands to generate
JSON schemas for the ApplicationSpecificConfiguration, SocketSchema and
StaticConfig.

schemars 0.8 > 0.9 has way too many breaking changes for me to care
about right now, let around 0.8 > 1.0. I'm happy being pinned on 0.8 for
now.
2025-09-24 15:18:06 -07:00
LGUG2Z 8d9d60b2e1 feat(cli): migrate more cli cfg cmds
I think this is all of the config commands migrated to komorebic now.

I still need to look in to the ManageFocusedWindow and
UnmanageFocusedWindow SocketMessage variants, as well as everything to
do with monitor reconciliation, but next I think I'll focus on trying to
generate the schemas.
2025-09-24 14:49:25 -07:00
LGUG2Z b2d4dff929 feat(cli): migrate a bunch of cfg cmds
This commit migrates a whole bunch of interactive runtime configuration
komorebic commands and implements their corresponding SocketMessage
variants.

Largely lifted as-is from komorebi for Windows.
2025-09-24 08:39:54 -07:00
LGUG2Z 0b17721580 feat(cli): implement eager-focus cmd
This commit implements SocketMessage::EagerFocus and the corresponding
komorebic eager-focus command. Mostly a straight migration from
komorebi.
2025-09-23 21:29:03 -07:00
LGUG2Z 7178609daf feat(cli): implement a bunch of rule cmds
This commit implements a whole bunch of commands around runtime
manipulation of ignore rules, manage rules and workspace rules. Mostly
lifted straight from komorebi.
2025-09-23 19:35:18 -07:00
LGUG2Z a31dcbc54c refactor(cli): migrate entire subcommand enum
To give me a better idea of how the quest for komorebic command parity
is going, I have copied over the entire SubCommand enum from the Windows
repo and commented out anything not yet implemented.
2025-09-23 14:31:44 -07:00
LGUG2Z d49de398b6 feat(wm): handle various ws overrides for new windows
This commit migrates a bunch of code from komorebi that deals with how
new windows should be handled according to the various floating and
container behaviour overrides.

To help test this functionality I also finished migrating the
SessionFloatRule, SessionFloatRules and ClearSessionFloatRules
SocketMessage variants.
2025-09-23 14:18:00 -07:00
LGUG2Z 627d150241 feat(wm): impl state queries
This commit implements SocketMessage::Query and responds correctly to
all of the various StateQuery options when komorebic query is called.
2025-09-22 21:40:24 -07:00
LGUG2Z b020b5bb69 feat(cli): add start and stop commands 2025-09-22 16:37:30 -07:00
LGUG2Z d77ae2d03a feat(cli): add log cmd
This commit adds logs written to files in the app's datadir, which can
then be tailed by the komorebic log command. temp_dir() was being weird
so I just stuck with DATA_DIR.
2025-09-22 15:55:19 -07:00
LGUG2Z 7467b8e30a feat(cli): add config and datadir commands 2025-09-22 15:45:04 -07:00
LGUG2Z 465fa02afc feat(cli): add fetch-asc cmd
Now that we have an applications.mac.json file in the asc repo, this commit adds a fetcher command.
2025-09-22 14:46:28 -07:00
LGUG2Z 02523d8b34 feat(wm): enrich monitors with serial id
This commit does some wrangling of the ioreg output to enrich monitors
with product names and serial number IDs, the latter of which is very
important to maintain compatibility with komorebi for Windows.

I can't get the equivalent of device and device_id on macOS, but these
are legacy things in komorebi for Windows so I think I'll leave them
out.

To verify monitor information, SocketMessage::MonitorInformation has
been implemented.
2025-09-22 12:16:32 -07:00
LGUG2Z c84db9a894 feat(wm): impl state, global-state and visible-windows
This commit implements the State, GlobalState and VisibleWindows
SocketMessage variants. These are the first of the SocketMessage
variants send by komorebic which receive a reply which is printed out to
the console.

I think the next thing to do will probably be to get the extended
display info so that the MonitorInformation variant can be handled too.
2025-09-21 21:07:52 -07:00
LGUG2Z 565c6cd6f8 feat(wm): implement remaining cycle and stack cmds
This commit implements the CycleFocusWindow, CycleMoveWindow, StackAll,
UnstackAll, FocusStackWindow and CycleStackIndex SocketMessage variants.

Largely a code migration from komorebi.
2025-09-19 11:55:38 -07:00
LGUG2Z 19686d9778 feat(wm): implement various focus and move cmds
This commit implements the MoveContainerToLastWorkspace,
SendContainerToLastWorkspace, MoveContainerToMonitorNumber,
CycleMoveContainerToMonitor, MoveContainerToWorkspaceNumber,
MoveContainerToNamedWorkspace, CycleMoveContainerToWorkspace,
SendContainerToMonitorNumber, CycleSendContainerToMonitor,
SendContainerToWorkspaceNumber, CycleSendContainerToWorkspace,
SendContainerToMonitorWorkspaceNumber,
MoveContainerToMonitorWorkspaceNumber, SendContainerToNamedWorkspace,
CycleMoveWorkspaceToMonitor, MoveWorkspaceToMonitorNumber, and
SwapWorkspacesToMonitorNumber SocketMessage variants.

This is primarily a lift-and-shift from komorebi.

I still have no idea if the monitor-related stuff works as expected.

I need to figure out how to construct a light Window from a window_id to
be able to call move_to_area() when moving a container to another
monitor.
2025-09-19 11:37:09 -07:00
LGUG2Z e883f4a161 feat(wm): implement various monitor & ws focus cmds
This commit implements the CycleFocusMonitor, CycleFocusWorkspace,
CycleFocusEmptyWorkspace, FocusMonitorNumber, FocusMonitorAtCursor,
FocusLastWorkspace, CloseWorkspace, FocusWorkspaceNumbers,
FocusMonitorWorkspaceNumber and FocusNamedWorkspace SocketMessage
variants.

Largely a lift-and-shift from komorebi.

Had to implement some utility functions in MacosApi to retrieve a
monitor ID from the current cursor position.

None of the monitor-related system code has been tested on macOS since I
only have a single monitor to work with right now.
2025-09-19 11:03:30 -07:00