What's New Since 0.5.0
This release is mostly about making problems easier to explain and easier to fix. OmniWM can now help you spot common setup issues, record a problem while it happens, gather the useful files, and open a clearer GitHub issue without making you dig through hidden folders.
Easier Troubleshooting
- Added a new Troubleshooting area in Settings.
- OmniWM now checks for common problems such as missing Accessibility permission, unavailable shortcuts, shortcuts that may also trigger macOS actions, Hyper-key shortcuts that were recorded too narrowly, Dock placement that can interfere with parked windows, display arrangements that can make edge behavior look wrong, and settings file problems.
- Each warning explains what is wrong in plain language and, when possible, gives you a button to open the right System Settings page or reveal the right folder.
- Recent troubleshooting files now appear in one place, with buttons to copy, reveal, or reuse them.
Record a Problem
- You can start a short problem recording from the menu bar or from Settings.
- While recording, the menu bar icon changes so it is obvious that OmniWM is capturing what is happening.
- When you stop recording, OmniWM saves the file and reveals it in Finder.
- A recording captures the state before and after the problem, plus recent window events, shortcut input, mouse movement, layout changes, and where windows were placed. That makes fast or hard-to-repeat bugs much easier to understand.
- Recordings stop automatically after ten minutes so they do not keep running by accident.
Better Issue Reports
- Added a Report Issue screen that creates a local zip file and opens a pre-filled GitHub issue in your browser.
- The zip file can include the current troubleshooting report, recent crash logs, recent recordings, focused-window details, and your settings file.
- OmniWM reveals the zip file in Finder so you can review it before attaching it to a public issue.
- If the issue text is too long for a browser link, OmniWM copies it to the clipboard and still opens GitHub for you.
- On supported Macs, OmniWM can use on-device Apple Intelligence to turn a rough report into a cleaner issue draft. On other Macs, it still formats your report into the same issue template without using AI.
- If your report mentions a shortcut, OmniWM can compare it with your current shortcuts so the issue names the right command instead of guessing.
Crash Follow-Up
- If OmniWM recovers from a crash, Settings now shows a crash banner with a button to start a pre-filled report.
- Crash logs are saved locally and kept with the other troubleshooting files, so the newest report can include what happened around the crash.
Window-Specific Help
- Added a way to save details about the focused window when one app or one window refuses to tile, floats unexpectedly, or behaves differently from normal windows.
- That saved file can be included with the next issue report, which makes app-specific window problems easier to investigate.
Focus Reliability
- Rapid keyboard navigation is more reliable in both Niri and Dwindle layouts.
- Fast repeated focus moves are less likely to end with OmniWM focusing the wrong window or losing the final move.
Project Notes
- Updated the documentation for the new issue-report prompt and troubleshooting workflow.
- Added related OmniWM forks to the README.
- Removed old cleanup files and simplified the release checks.
Download Verification
OmniWM-v0.5.1.zipcontains the Developer ID signed, notarized, and stapled OmniWM app.OmniWM-v0.5.1.zipSHA-256:f337c0d5cfcb796815358d23f8aafecddbac6ac213aa10cbf35467604f48e878GhosttyKit.xcframework-v0.5.1.zipSHA-256:2267caddbe0b4b970a45d2a4f8c324ce6ce9485fa244c61560493b83da9caeed