relikd/Memmon
1
0
Fork 0
Code Pull Requests Releases Activity

docs: how to install + clarify existing solutions

Browse Source 
Closes: #7, #8
This commit is contained in:
relikd
2022-06-02 10:05:34 +02:00
parent f94a56ec58
commit d2eac0f0d2
1 changed files with 35 additions and 10 deletions
Download Patch File Download Diff File Expand all files Collapse all files

45
README.md
View File

@@ -8,21 +8,33 @@
Memmon remembers what your Mac forgets – A simple deamon that restores your window positions on external monitors. Memmon remembers what your Mac forgets – A simple deamon that restores your window positions on external monitors.
**Limitations:** Currently, Memmon restores windows in other spaces only if the space is activated. If you know a way to access the accessibility settings of a different space, let me know. **Limitations:**
- Currently, Memmon restores windows in other spaces only if the space is activated.
If you know a way to access the accessibility settings of a different space, let me know.
- Support for the Misson Control config option “Displays have separate Spaces” is not tested.
I will add support for this as soon as I have access to an external monitor again (issue [#5](https://github.com/relikd/Memmon/issues/5#issuecomment-1040611494)).
## Install ## Install
1. You will need macOS 10.10 or newer. 1. You will need macOS 10.10 or newer.
2. Grant Memmon the Accessibility privilege. Go to "System Preference" > "Security & Privacy" > "Accessibility" and add Memmon to that list. Otherwise, you can't move other application windows around and the app has no purpose. Download and unzip the tar.gz from [latest release](https://github.com/relikd/Memmon/releases/latest).
2. Grant Memmon the Accessibility privilege.
Go to "System Preference" > "Security & Privacy" > "Accessibility" and add Memmon to that list.
(Otherwise, the app has no purpose as it can't move application windows around.)
3. Thats it. The app runs in your menu bar. 3. Thats it. The app runs in your menu bar.
Alternatively, you can compile Memmon from source by running `make`, or call the script directly (`swift src/main.swift`) without building an app bundle.
### Menu Bar Icon ### Menu Bar Icon
You can hide the menu bar icon either via `defaults` or the same-titled menu entry. If you do so, the only way to quit the app is by killing the process (with Activity.app or `killall Memmon`). The menu bar icon stays hidden during this execution only. If you restart the OS or app it will reappear (unless you hide the icon with `defaults`). You can hide the menu bar icon either via `defaults` or the same-titled menu entry.
If you do so, the only way to quit the app is by killing the process (with Activity.app or `killall Memmon`).
The menu bar icon stays hidden during this execution only. If you restart the OS or app it will reappear (unless you hide the icon with `defaults`).
Memmon has exactly one app-setting, the menu bar icon. You can manipulate the display of the icon, or hide the icon completely: Memmon has exactly one app-setting, the menu bar icon.
You can manipulate the display of the icon, or hide the icon completely:
```sh ```sh
# disable menu bar icon completely # disable menu bar icon completely
@@ -42,23 +54,36 @@ defaults delete de.relikd.Memmon icon
### Why‽ ### Why‽
I am frustrated! Why does my Mac forget all window positions which I moved to a second screen? Every time I unplug the monitor. Every time I close my Macbook lid. Every time I lock my Mac. I am frustrated!
Why does my Mac forget all window positions which I moved to a second screen?
Every time I unplug the monitor.
Every time I close my Macbook lid.
Every time I lock my Mac.
Is it macOS 11? Is it the USB-C-to-HDMI converter dongle (notably one made by Apple)? Why do I have to fix things that Apple should have fixed long ago? … Is it macOS 11?
Is it the USB-C-to-HDMI converter dongle (notably one made by Apple)?
Why do I have to fix things that Apple should have fixed long ago? …
### Aren't there other solutions? ### Aren't there other solutions?
Yes, for example [Mjolnir](https://github.com/mjolnirapp/mjolnir) or [Hammerspoon](https://github.com/Hammerspoon/hammerspoon) (and some comercial ones). But I do not need a full-fledged window manager. Nor the dependencies they rely on. I just need to fix this damn bug. Yes, for example, you can use [Mjolnir](https://github.com/mjolnirapp/mjolnir) or [Hammerspoon](https://github.com/Hammerspoon/hammerspoon) (and some comercial ones) to restore your perfect window setup on a button press.
But I do not need a full-fledged window manager or the dependencies it relies on.
Nor do I want to constantly adjust for new windows.
Actually, I don't want to think about this problem at all – I just want to fix this damn bug.
### What is it good for? ### What is it good for?
First off, Memmon is less than 300 lines of code – no dependencies. You can audit it in 10 minutes... And build it from scratch – just run `make`. First off, Memmon is less than 300 lines of code – no dependencies.
You can audit it in 10 minutes...
And build it from scratch – just run `make`.
Secondly, it does one thing and one thing only: Save and restore window positions whenever your monitor setup changes. Secondly, it does one thing and one thing only:
Save and restore window positions whenever your monitor setup changes.
### Develop ### Develop
You can either run the `main.swift` file directly with `swift main.swift`, via Terminal `./main.swift` (`chmod 755 main.swift`), or create a new Xcode project. Select the Command-Line template and after creation replace the existing `main.swift` with the bundled one. You can either run the `main.swift` file directly with `swift main.swift`, via Terminal `./main.swift` (`chmod 755 main.swift`), or create a new Xcode project.
In Xcode, select the Command-Line template and replace the template provided `main.swift` with this one.