10 Commits
v1.1 ... main

Author SHA1 Message Date
relikd
906f45b156 chore: file permissions 2025-10-15 19:08:41 +02:00
relikd
a8dfe6fb15 ref: Makefile 2025-09-04 01:24:21 +02:00
nisc
dd84561293 Makefile: add ad-hoc code signing and clean target 2025-09-04 01:22:06 +02:00
relikd
d2eac0f0d2 docs: how to install + clarify existing solutions
Closes: #7, #8
2022-06-02 10:06:45 +02:00
relikd
f94a56ec58 rename status icon to menu bar icon (closes #3) 2021-11-29 20:48:45 +01:00
relikd
60d2a15f0f Fix universal build (issue #2) 2021-11-24 18:26:49 +01:00
relikd
d26169f8b9 restoring spaces v2 2021-10-27 18:48:16 +02:00
relikd
9920201fe2 preliminary support for spaces 2021-10-27 18:24:00 +02:00
relikd
acc0b03522 ask for for accessibility permission + fix restore current space only 2021-10-26 23:57:27 +02:00
relikd
7510327139 Readme: add spaces limitation note 2021-10-22 18:28:39 +02:00
5 changed files with 201 additions and 73 deletions

1
.gitignore vendored
View File

@@ -1,3 +1,4 @@
.DS_Store .DS_Store
/*.app /*.app
/*.tar.gz /*.tar.gz
*.xcodeproj

55
Makefile Executable file → Normal file
View File

@@ -1,26 +1,53 @@
# usage: make [CONFIG=debug|release] # usage: make [CONFIG=debug|release]
ifeq ($(CONFIG), debug) ifeq ($(CONFIG), debug)
CFLAGS=-Onone -g CFLAGS=-Onone -g
else else
CFLAGS=-O CFLAGS=-O
endif endif
APP_DIR = Memmon.app/Contents PLIST=$(shell grep -A1 $(1) src/Info.plist | tail -1 | cut -d'>' -f2 | cut -d'<' -f1)
HAS_SIGN_IDENTITY=$(shell security find-identity -v -p codesigning | grep -q "Apple Development" && echo 1 || echo 0)
Memmon.app: SDK_PATH = $(shell xcrun --show-sdk-path --sdk macosx)
Memmon.app: SDK_PATH=$(shell xcrun --show-sdk-path --sdk macosx)
Memmon.app: src/* Memmon.app: src/*
mkdir -p Memmon.app/Contents/MacOS/ @mkdir -p Memmon.app/Contents/MacOS/
swiftc $(CFLAGS) src/main.swift \ swiftc ${CFLAGS} src/main.swift -target x86_64-apple-macos10.10 \
-target arm64-apple-macos10.10 -target x86_64-apple-macos10.10 \ -emit-executable -sdk ${SDK_PATH} -o bin_x64
-emit-executable -sdk $(SDK_PATH) -o Memmon.app/Contents/MacOS/Memmon swiftc ${CFLAGS} src/main.swift -target arm64-apple-macos10.10 \
mkdir -p Memmon.app/Contents/Resources/ -emit-executable -sdk ${SDK_PATH} -o bin_arm64
cp src/AppIcon.icns Memmon.app/Contents/Resources/AppIcon.icns lipo -create bin_x64 bin_arm64 -o Memmon.app/Contents/MacOS/Memmon
cp src/Info.plist Memmon.app/Contents/Info.plist @rm bin_x64 bin_arm64
echo 'APPL????' > Memmon.app/Contents/PkgInfo @echo 'APPL????' > Memmon.app/Contents/PkgInfo
@mkdir -p Memmon.app/Contents/Resources/
@cp src/AppIcon.icns Memmon.app/Contents/Resources/AppIcon.icns
@cp src/Info.plist Memmon.app/Contents/Info.plist
@touch Memmon.app @touch Memmon.app
@echo
ifeq ($(HAS_SIGN_IDENTITY),1)
codesign -v -s 'Apple Development' --options=runtime --timestamp Memmon.app
else
codesign -v -s - Memmon.app
endif
@echo
@echo 'Verify Signature...'
@echo
codesign -dvv Memmon.app
@echo
codesign -vvv --deep --strict Memmon.app
ifeq ($(HAS_SIGN_IDENTITY),1)
@echo
-spctl -vvv --assess --type exec Memmon.app
endif
.PHONY: clean
clean:
rm -rf Memmon.app bin_x64 bin_arm64
.PHONY: release .PHONY: release
release: VERSION=$(shell grep -A1 CFBundleShortVersionString src/Info.plist | tail -1 | tr -d '[a-z \t</>]') release: VERSION=$(call PLIST,CFBundleShortVersionString)
release: Memmon.app release: Memmon.app
tar -czf "Memmon_v$(VERSION).tar.gz" Memmon.app tar -czf "Memmon_v${VERSION}.tar.gz" Memmon.app

View File

@@ -1,5 +1,6 @@
[![macOS 10.10+](https://img.shields.io/badge/macOS-10.10+-888)](#install) [![macOS 10.10+](https://img.shields.io/badge/macOS-10.10+-888)](#install)
[![Current release](https://img.shields.io/github/release/relikd/Memmon)](https://github.com/relikd/Memmon/releases) [![Current release](https://img.shields.io/github/release/relikd/Memmon)](https://github.com/relikd/Memmon/releases)
[![All downloads](https://img.shields.io/github/downloads/relikd/Memmon/total)](https://github.com/relikd/Memmon/releases)
<img src="img/icon.svg" width="180" height="180"> <img src="img/icon.svg" width="180" height="180">
@@ -7,55 +8,82 @@
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.
- 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).
3. Thats it. The app runs in your status bar. 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.
Alternatively, you can compile Memmon from source by running `make`, or call the script directly (`swift src/main.swift`) without building an app bundle.
### Status Icon ### Menu Bar Icon
You can hide the status 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`). 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 status 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 status icon completely # disable menu bar icon completely
defaults write de.relikd.Memmon icon -int 0 defaults write de.relikd.Memmon icon -int 0
# Use window-dots-icon # Use window-dots-icon
defaults write de.relikd.Memmon icon -int 1 defaults write de.relikd.Memmon icon -int 1
# Use monitor-with-windows icon (default) # Use monitor-with-windows icon (default)
defaults write de.relikd.Memmon icon -int 2 defaults write de.relikd.Memmon icon -int 2
# re-enable status icon and use default icon # re-enable menu bar icon and use default icon
defaults delete de.relikd.Memmon icon defaults delete de.relikd.Memmon icon
``` ```
![status icons](img/status_icons.png) ![menu bar icons](img/status_icons.png)
## FAQ ## FAQ
### 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 just 140 lines of code no dependencies. You can audit it in 5 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.

View File

@@ -15,7 +15,7 @@
<key>CFBundlePackageType</key> <key>CFBundlePackageType</key>
<string>APPL</string> <string>APPL</string>
<key>CFBundleShortVersionString</key> <key>CFBundleShortVersionString</key>
<string>1.1</string> <string>1.5</string>
<key>CFBundleVersion</key> <key>CFBundleVersion</key>
<string>42</string> <string>42</string>
<key>LSMinimumSystemVersion</key> <key>LSMinimumSystemVersion</key>

View File

@@ -2,15 +2,29 @@
import Cocoa import Cocoa
import AppKit import AppKit
typealias WinPos = (Int32, CGRect) // win-num, bounds typealias AppPID = Int32 // see kCGWindowOwnerPID
typealias WinConf = [Int32: [WinPos]] // app-pid, window-list typealias WinNum = Int // see kCGWindowNumber (Int32) and NSWindow.windowNumber (Int)
typealias WinPos = (WinNum, CGRect) // win-num, bounds
typealias WinConf = [AppPID: [WinPos]] // app-pid, window-list
typealias SpaceId = WinNum // see NSWindow.windowNumber (Int)
class AppDelegate: NSObject, NSApplicationDelegate { class AppDelegate: NSObject, NSApplicationDelegate {
private var statusItem: NSStatusItem! private var statusItem: NSStatusItem!
private var numScreens: Int = NSScreen.screens.count private var numScreens: Int = NSScreen.screens.count
private var state: [Int: WinConf] = [:] // [screencount: [pid: [windows]]] private var state: [Int: WinConf] = [:] // [screencount: [pid: [windows]]]
private var spacesAll: [SpaceId] = [] // keep forever (and keep order)
private var spacesVisited: Set<WinNum> = [] // fill-up on space-switch
private var spacesNeedRestore: Set<SpaceId> = [] // dropped after restore
func applicationDidFinishLaunching(_ aNotification: Notification) { func applicationDidFinishLaunching(_ aNotification: Notification) {
// show Accessibility Permissions popup
AXIsProcessTrustedWithOptions([kAXTrustedCheckOptionPrompt.takeUnretainedValue() : true] as CFDictionary)
// track space changes
NSWorkspace.shared.notificationCenter.addObserver(self, selector: #selector(self.activeSpaceChanged), name: NSWorkspace.activeSpaceDidChangeNotification, object: nil)
_ = self.currentSpace() // create space-id win for current space
self.spacesVisited = Set(self.getWinIds())
// create status menu icon
UserDefaults.standard.register(defaults: ["icon": 2]) UserDefaults.standard.register(defaults: ["icon": 2])
let icon = UserDefaults.standard.integer(forKey: "icon") let icon = UserDefaults.standard.integer(forKey: "icon")
if icon == 0 { return } if icon == 0 { return }
@@ -23,7 +37,7 @@ class AppDelegate: NSObject, NSApplicationDelegate {
} }
} }
self.statusItem.menu = NSMenu(title: "") self.statusItem.menu = NSMenu(title: "")
self.statusItem.menu!.addItem(withTitle: "Memmon (v1.1)", action: nil, keyEquivalent: "") self.statusItem.menu!.addItem(withTitle: "Memmon (v1.5)", action: nil, keyEquivalent: "")
self.statusItem.menu!.addItem(withTitle: "Hide Status Icon", action: #selector(self.enableInvisbleMode), keyEquivalent: "") self.statusItem.menu!.addItem(withTitle: "Hide Status Icon", action: #selector(self.enableInvisbleMode), keyEquivalent: "")
self.statusItem.menu!.addItem(withTitle: "Quit", action: #selector(NSApp.terminate), keyEquivalent: "q") self.statusItem.menu!.addItem(withTitle: "Quit", action: #selector(NSApp.terminate), keyEquivalent: "q")
} }
@@ -33,47 +47,56 @@ class AppDelegate: NSObject, NSApplicationDelegate {
} }
func applicationDidChangeScreenParameters(_ notification: Notification) { func applicationDidChangeScreenParameters(_ notification: Notification) {
if numScreens != NSScreen.screens.count { if self.numScreens != NSScreen.screens.count {
self.saveState() self.saveState()
numScreens = NSScreen.screens.count self.numScreens = NSScreen.screens.count
if let previous = self.state[numScreens] { self.spacesVisited.removeAll(keepingCapacity: true)
self.restoreState(previous) self.restoreState()
}
} }
} }
private func getWinIds(allSpaces: Bool = false) -> [WinNum] {
NSWindow.windowNumbers(options: allSpaces ? [.allApplications, .allSpaces] : .allApplications)?.map{ $0.intValue } ?? []
}
// MARK: - Save State (CGWindow) -
private func saveState() { private func saveState() {
self.spacesNeedRestore = Set(self.spacesAll)
if self.state[self.numScreens] == nil {
self.state[self.numScreens] = [:] // otherwise state.keys wont run
}
let newState = self.getState() let newState = self.getState()
self.state[numScreens] = newState
// update existing
let dummy: WinPos = (0, CGRect.zero) let dummy: WinPos = (0, CGRect.zero)
for kNum in self.state.keys { for kNum in self.state.keys {
if kNum == numScreens { continue } // current state, already set above let isCurrent = kNum == self.numScreens
var tmp_state: WinConf = [:] var tmp_state: WinConf = [:]
for (n_app, new_val) in newState { for (n_app, n_windows) in newState {
if let old_val = self.state[kNum]![n_app] { if let old_windows = self.state[kNum]![n_app] {
tmp_state[n_app] = [] var win_arr: [WinPos] = []
for (n_win, _) in new_val { for n_win in n_windows {
let old_pos = old_val.first { $0.0 == n_win } // In theory, every space that was visited, was also restored.
tmp_state[n_app]!.append(old_pos ?? dummy) // If not visited (and not restored) then windows may still appear minimized,
// so we rather copy the old value, assuming windows weren't moved while in an unvisited space.
if isCurrent && self.spacesVisited.contains(n_win.0) {
win_arr.append(n_win)
} else {
// caution! the positions of all other states are updated as well.
let old_win = old_windows.first { $0.0 == n_win.0 }
win_arr.append(old_win ?? dummy)
}
} }
tmp_state[n_app] = win_arr
} else if isCurrent { // and not saved yet
tmp_state[n_app] = n_windows // TODO: or only add if visited?
} }
} }
self.state[kNum] = tmp_state self.state[kNum] = tmp_state
} }
} }
private func restoreState(_ state: WinConf) {
for (pid, bounds) in state {
self.setWindowSizes(pid, bounds)
}
}
private func getState() -> WinConf { private func getState() -> WinConf {
var allWinNums: [Int32] = [] let allWinNums = self.getWinIds(allSpaces: true).filter { !self.spacesAll.contains($0) }
for winNum in NSWindow.windowNumbers(options: [.allApplications, .allSpaces]) ?? [] {
allWinNums.append(winNum.int32Value)
}
var state: WinConf = [:] var state: WinConf = [:]
let windowList = CGWindowListCopyWindowInfo(.optionAll, kCGNullWindowID) as NSArray? as? [[String: AnyObject]] let windowList = CGWindowListCopyWindowInfo(.optionAll, kCGNullWindowID) as NSArray? as? [[String: AnyObject]]
@@ -82,11 +105,11 @@ class AppDelegate: NSObject, NSApplicationDelegate {
if entry[kCGWindowLayer as String] as! CGWindowLevel != kCGNormalWindowLevel { if entry[kCGWindowLayer as String] as! CGWindowLevel != kCGNormalWindowLevel {
continue continue
} }
let winNum = entry[kCGWindowNumber as String] as! Int32 let winNum = entry[kCGWindowNumber as String] as! WinNum
guard let insIdx = allWinNums.firstIndex(of: winNum) else { guard let insIdx = allWinNums.firstIndex(of: winNum) else {
continue continue
} }
let pid = entry[kCGWindowOwnerPID as String] as! Int32 let pid = entry[kCGWindowOwnerPID as String] as! AppPID
let b = entry[kCGWindowBounds as String] as! [String: Int] let b = entry[kCGWindowBounds as String] as! [String: Int]
let bounds = CGRect(x: b["X"]!, y: b["Y"]!, width: b["Width"]!, height: b["Height"]!) let bounds = CGRect(x: b["X"]!, y: b["Y"]!, width: b["Width"]!, height: b["Height"]!)
if (state[pid] == nil) { if (state[pid] == nil) {
@@ -103,24 +126,36 @@ class AppDelegate: NSObject, NSApplicationDelegate {
return state return state
} }
private func setWindowSizes(_ pid: Int32, _ sizes: [WinPos]) { // MARK: - Restore State (AXUIElement) -
let win = self.axWinList(pid)
guard win.count > 0, win.count == sizes.count else { private func restoreState() {
return if let space = currentSpace(), self.spacesNeedRestore.contains(space) {
} self.spacesNeedRestore.remove(space)
for i in 0 ..< win.count { let spaceWinNums = self.getWinIds()
var pt = sizes[i].1 self.spacesVisited.formUnion(spaceWinNums)
if pt.isEmpty { continue } // filter dummy elements for (pid, bounds) in self.state[self.numScreens] ?? [:] {
AXUIElementSetAttributeValue(win[i], kAXPositionAttribute as CFString, self.setWindowSizes(pid, bounds.filter{ spaceWinNums.contains($0.0) })
AXValueCreate(AXValueType(rawValue: kAXValueCGPointType)!, &pt.origin)!); }
AXUIElementSetAttributeValue(win[i], kAXSizeAttribute as CFString,
AXValueCreate(AXValueType(rawValue: kAXValueCGSizeType)!, &pt.size)!);
} }
} }
private func axWinList(_ pid: Int32) -> [AXUIElement] { private func setWindowSizes(_ pid: pid_t, _ sizes: [WinPos]) {
guard sizes.count > 0 else { return }
let win = self.axWinList(pid)
guard win.count == sizes.count else { return }
for i in 0 ..< win.count {
var pt = sizes[i].1
if pt.isEmpty { continue } // filter dummy elements
let origin = AXValueCreate(AXValueType(rawValue: kAXValueCGPointType)!, &pt.origin)!
let size = AXValueCreate(AXValueType(rawValue: kAXValueCGSizeType)!, &pt.size)!
AXUIElementSetAttributeValue(win[i], kAXPositionAttribute as CFString, origin);
AXUIElementSetAttributeValue(win[i], kAXSizeAttribute as CFString, size);
}
}
private func axWinList(_ pid: pid_t) -> [AXUIElement] {
let appRef = AXUIElementCreateApplication(pid) let appRef = AXUIElementCreateApplication(pid)
var value: AnyObject? var value: CFTypeRef?
AXUIElementCopyAttributeValue(appRef, kAXWindowsAttribute as CFString, &value) AXUIElementCopyAttributeValue(appRef, kAXWindowsAttribute as CFString, &value)
if let windowList = value as? [AXUIElement] { if let windowList = value as? [AXUIElement] {
var tmp: [AXUIElement] = [] var tmp: [AXUIElement] = []
@@ -135,8 +170,43 @@ class AppDelegate: NSObject, NSApplicationDelegate {
} }
return [] return []
} }
// MARK: - Space Management -
@objc func activeSpaceChanged(_ notification: Notification) {
self.restoreState()
}
private func currentSpace() -> SpaceId? {
let thisSpace = self.getWinIds()
var candidates = self.spacesAll.filter { thisSpace.contains($0) }
if candidates.count > 0 {
let best = candidates.removeFirst()
if candidates.count > 0 {
// if a full-screen app is closed, win moves to current active space -> remove duplicates
self.spacesAll.removeAll { candidates.contains($0) }
for oldNum in candidates {
NSApp.window(withWindowNumber: oldNum)?.close()
}
}
return best
}
// create new space-id window (space was not visited yet)
let win = NSWindow(contentRect: .zero, styleMask: .borderless, backing: .buffered, defer: false)
win.isReleasedWhenClosed = false // win is released either way. But crashes if true.
guard win.isOnActiveSpace else {
// dashboard or other full-screen app that prohibits display
return nil
}
win.collectionBehavior = [.ignoresCycle, .stationary]
win.setIsVisible(true)
self.spacesAll.append(win.windowNumber)
return win.windowNumber
}
} }
// MARK: - Status Bar Icon -
extension NSImage { extension NSImage {
static var statusIconDots: NSImage { static var statusIconDots: NSImage {
let img = NSImage.init(size: .init(width: 20, height: 20), flipped: true) { let img = NSImage.init(size: .init(width: 20, height: 20), flipped: true) {
@@ -179,6 +249,8 @@ extension NSImage {
} }
} }
// MARK: - Main Entry
let delegate = AppDelegate() let delegate = AppDelegate()
NSApplication.shared.delegate = delegate NSApplication.shared.delegate = delegate
NSApplication.shared.run() NSApplication.shared.run()