Skip to content

Commit

Permalink
Update README.md
Browse files Browse the repository at this point in the history
  • Loading branch information
rxhanson authored Dec 3, 2023
1 parent 967637f commit 6bcebe1
Showing 1 changed file with 15 additions and 3 deletions.
18 changes: 15 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ Rectangle is a window management app based on Spectacle, written in Swift.

## System Requirements

Rectangle supports macOS v10.13+.
Rectangle supports macOS v10.15+. The last version that is supported for macOS 10.13 and 10.14 is https://github.com/rxhanson/Rectangle/releases/tag/v0.73.

## Installation

Expand Down Expand Up @@ -84,15 +84,27 @@ See issue [317](https://github.com/rxhanson/Rectangle/issues/317).

If windows aren't resizing or moving as you expect, here's some initial steps to get to the bottom of it. Most issues of this type have been caused by other apps.

1. Make sure macOS is up to date, if possible.
1. Restart your machine.
1. Make sure macOS is up to date.
1. Restart your machine (this often fixes things right after a macOS update).
1. Make sure there are no other window manager applications running.
1. Make sure that the app whose windows are not behaving properly does not have any conflicting keyboard shortcuts.
1. Try using the menu items to execute a window action or changing the keyboard shortcut to something different so we can tell if it's a keyboard shortcut issue or not.
1. Enable debug logging, as per the instructions in the following section.
1. The logs are pretty straightforward. If your calculated rect and your resulting rect are identical, chances are that there is another application causing issues. Save your logs if needed to attach to an issue if you create one.
1. If you suspect there may be another application causing issues, try creating and logging in as a new macOS user.

#### Try resetting the macOS accessibility permissions for Rectangle:

```bash
tccutil reset All com.knollsoft.Rectangle
```

Or, this can be done with the following steps instead of the tccutil terminal command.
1. Close Rectangle if it's running
2. In System Settings -> Privacy & Security -> Accessibility, first disable Rectangle, then remove it with the minus button. (it's important to do both of those steps in that order)
3. Restart your mac.
4. Launch Rectangle and enable settings for it as prompted.

## View Debug Logging

1. Hold down the alt (option) key with the Rectangle menu open.
Expand Down

0 comments on commit 6bcebe1

Please sign in to comment.