Something went wrong. Try again.
An auto tiler for macOS
Something went wrong. Try again.
123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251import Foundation
public enum WindowDisposition: String, Sendable, Equatable, Codable { case tile, float, ignore}
public enum ClassificationReason: Sendable, Equatable, Codable { case standardWindow case fullScreen case minimized case notWindow case helper case dialog case sheet case panel case nonResizable case fixedSize case elevatedLayer case tinyWindow case pictureInPicture case quickTerminal case launcher case quickLook case splash case defaultFloatApp(bundleID: String) case nativeTab case legacyRule(bundleID: String) case manual case whenFull case rule(index: Int, bundleID: String)}
public struct WindowClassification: Sendable, Equatable, Codable { public var disposition: WindowDisposition public var reason: ClassificationReason public var display: DisplayID? public var position: Int? public var layout: Layout? public var space: Int? public var moveToSpace: Bool
public init( disposition: WindowDisposition, reason: ClassificationReason, display: DisplayID? = nil, position: Int? = nil, layout: Layout? = nil, space: Int? = nil, moveToSpace: Bool = false ) { self.disposition = disposition self.reason = reason self.display = display self.position = position self.layout = layout self.space = space self.moveToSpace = moveToSpace }
private enum CodingKeys: String, CodingKey { case disposition, reason, display, position, layout, space, moveToSpace }
public init(from decoder: any Decoder) throws { let values = try decoder.container(keyedBy: CodingKeys.self) disposition = try values.decode(WindowDisposition.self, forKey: .disposition) reason = try values.decode(ClassificationReason.self, forKey: .reason) display = try values.decodeIfPresent(DisplayID.self, forKey: .display) position = try values.decodeIfPresent(Int.self, forKey: .position) layout = try values.decodeIfPresent(Layout.self, forKey: .layout) space = try values.decodeIfPresent(Int.self, forKey: .space) moveToSpace = try values.decodeIfPresent(Bool.self, forKey: .moveToSpace) ?? false }}
public enum WindowRuleError: Error, Sendable, Equatable { case missingMatch case missingAction case conflictingTitleMatchers case invalidPosition case invalidSpace}
public struct WindowRule: Sendable { public let bundleID: String? public let appName: String? public let titleContains: String? public let titleRegex: String? public let role: String? public let subrole: String? public let action: WindowDisposition? public let display: DisplayID? public let position: Int? public let layout: Layout? public let space: Int? public let moveToSpace: Bool private let regex: NSRegularExpression?
public init( bundleID: String? = nil, appName: String? = nil, titleContains: String? = nil, titleRegex: String? = nil, role: String? = nil, subrole: String? = nil, action: WindowDisposition? = nil, display: DisplayID? = nil, position: Int? = nil, layout: Layout? = nil, space: Int? = nil, moveToSpace: Bool = false ) throws { guard [bundleID, appName, titleContains, titleRegex, role, subrole].contains(where: { $0 != nil }) else { throw WindowRuleError.missingMatch } guard action != nil || display != nil || position != nil || layout != nil || space != nil else { throw WindowRuleError.missingAction } guard space.map({ (1...16).contains($0) }) != false else { throw WindowRuleError.invalidSpace } guard titleContains == nil || titleRegex == nil else { throw WindowRuleError.conflictingTitleMatchers } guard position.map({ $0 >= 0 }) != false else { throw WindowRuleError.invalidPosition } self.bundleID = bundleID self.appName = appName self.titleContains = titleContains self.titleRegex = titleRegex self.role = role self.subrole = subrole self.action = action self.display = display self.position = position self.layout = layout self.space = space self.moveToSpace = moveToSpace regex = try titleRegex.map { try NSRegularExpression(pattern: $0) } }
public func matches(_ facts: WindowFacts) -> Bool { if let bundleID, facts.bundleID != bundleID { return false } if let appName, facts.appName != appName { return false } if let role, facts.role != role { return false } if let subrole, facts.subrole != subrole { return false } if let titleContains, facts.title?.contains(titleContains) != true { return false } if let regex { guard let title = facts.title else { return false } let range = NSRange(title.startIndex..<title.endIndex, in: title) if regex.firstMatch(in: title, range: range) == nil { return false } } return true }}
public struct WindowClassifier: Sendable { public var rules: [WindowRule] public var disabledDefaultFloatApps: Set<String>
public init(rules: [WindowRule] = [], disabledDefaultFloatApps: Set<String> = []) { self.rules = rules self.disabledDefaultFloatApps = disabledDefaultFloatApps }
public func appProfile(for facts: WindowFacts) -> AppTilingProfile { AppTilingProfile(facts: facts) }
public func classify(_ facts: WindowFacts) -> WindowClassification { // Fullscreen and minimized windows cannot safely be moved by the tiler. if facts.isFullScreen == true { return .init(disposition: .ignore, reason: .fullScreen) } if facts.isMinimized == true { return .init(disposition: .ignore, reason: .minimized) } let profile = appProfile(for: facts) var result = heuristic(facts, profile: profile) if result.reason != .helper, result.reason != .notWindow, let quirk = quirk(facts, profile: profile, heuristic: result) { result = quirk } for (index, rule) in rules.enumerated() where rule.matches(facts) { if let action = rule.action { result.disposition = action result.reason = .rule(index: index, bundleID: facts.bundleID) } if let display = rule.display { result.display = display } if let position = rule.position { result.position = position } if let layout = rule.layout { result.layout = layout } if let space = rule.space { result.space = space result.moveToSpace = rule.moveToSpace } } return result }
private func heuristic(_ facts: WindowFacts, profile: AppTilingProfile) -> WindowClassification { if facts.isHelper == true { return .init(disposition: .ignore, reason: .helper) } if let role = facts.role, !["AXWindow", "AXSheet", "AXDialog"].contains(role) { return .init(disposition: .ignore, reason: .notWindow) } if facts.role == "AXSheet" || facts.hasParent == true { return .init(disposition: .float, reason: .sheet) } if facts.isModal == true || ["AXDialog", "AXSystemDialog"].contains(facts.subrole ?? "") || facts.role == "AXDialog" { return .init(disposition: .float, reason: .dialog) } if ["AXFloatingWindow", "AXSystemFloatingWindow"].contains(facts.subrole ?? "") || facts.activationPolicy == .accessory { return .init(disposition: .float, reason: .panel) } if profile.fixedSize != nil { return .init(disposition: .float, reason: .fixedSize) } if facts.isResizable == false { return .init(disposition: .float, reason: .nonResizable) } if facts.layer.map({ $0 != 0 }) == true || facts.level.map({ $0 != 0 }) == true { return .init(disposition: .float, reason: .elevatedLayer) } if let size = facts.serverSize, size.width > 0, size.height > 0, size.width <= 100 || size.height <= 100 { return .init(disposition: .float, reason: .tinyWindow) } return .init(disposition: .tile, reason: .standardWindow) }
private func quirk( _ facts: WindowFacts, profile: AppTilingProfile, heuristic: WindowClassification ) -> WindowClassification? { let title = facts.title?.lowercased() ?? "" // The system player has its own bundle identity; its title varies with the system language. if facts.bundleID == "com.apple.PIPAgent", !disabledDefaultFloatApps.contains(facts.bundleID) { return .init(disposition: .float, reason: .defaultFloatApp(bundleID: facts.bundleID)) } if facts.role == "AXWindow", ["AXFloatingWindow", "AXSystemFloatingWindow"].contains(facts.subrole ?? ""), ["picture in picture", "picture-in-picture"].contains(title) { return .init(disposition: .ignore, reason: .pictureInPicture) } if facts.bundleID == "com.apple.finder", title.contains("quick look") { return .init(disposition: .float, reason: .quickLook) } if (facts.bundleID == "com.apple.dt.Xcode" && title == "open quickly") || facts.bundleID == "com.apple.Spotlight" { return .init(disposition: .float, reason: .launcher) } if ["com.mitchellh.ghostty", "com.googlecode.iterm2"].contains(facts.bundleID), title.contains("quick terminal") || title.contains("dropdown") { return .init(disposition: .float, reason: .quickTerminal) } if facts.bundleID.hasPrefix("com.jetbrains."), title.contains("splash") { return .init(disposition: .float, reason: .splash) } if !disabledDefaultFloatApps.contains(facts.bundleID), DefaultFloatApps.all.contains(where: { $0.bundleID == facts.bundleID }) { return .init(disposition: .float, reason: .defaultFloatApp(bundleID: facts.bundleID)) } if profile.tabsAsWindows == true, heuristic.reason == .standardWindow { return .init(disposition: .tile, reason: .nativeTab) } return nil }}