stt/focus-fixer
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 1 Wiki Activity

Initial FocusFixer implementation

Browse Source 
Menu-bar utility that fixes cross-display keyboard focus loss: a
listen-only CGEvent tap locates the window under the cursor and
reasserts app activation + AX focus on it, with debounce, tap
auto-recovery, and an Accessibility permission gate.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
This commit is contained in:
sttlab-tech
2026-08-10 12:02:29 +02:00
commit 561a547b70
18 changed files with 1411 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files
FocusFixer.xcodeproj/project.pbxproj
+427
View File
@@ -0,0 +1,427 @@
// !$*UTF8*$!
{
archiveVersion = 1;
classes = {
};
objectVersion = 77;
objects = {
/* Begin PBXBuildFile section */
02861A191097E26F4BBFFC3C /* EventTapController.swift in Sources */ = {isa = PBXBuildFile; fileRef = 9F6A6781660931E8DE13CBA8 /* EventTapController.swift */; };
1855F520A8A8D2091F6D1915 /* PermissionManager.swift in Sources */ = {isa = PBXBuildFile; fileRef = 8BA5F1D3E43F0843B442B0C3 /* PermissionManager.swift */; };
26C71677B1D8CB4CD657154D /* main.swift in Sources */ = {isa = PBXBuildFile; fileRef = 94BEBF21BDD32FE15C4B8F0C /* main.swift */; };
3A6CBD1179B0870EF6A4DF5C /* FocusEnforcer.swift in Sources */ = {isa = PBXBuildFile; fileRef = 583FC010F2AC5DA68F9A479C /* FocusEnforcer.swift */; };
67D53FB027B5450292EA0E19 /* PreferencesTests.swift in Sources */ = {isa = PBXBuildFile; fileRef = 18945640C7DCF7D2BB10B26D /* PreferencesTests.swift */; };
ADF3776153FD8C769680597F /* Preferences.swift in Sources */ = {isa = PBXBuildFile; fileRef = 18AE36788814E7B845FD6E7F /* Preferences.swift */; };
AED74188139B448C5DF52328 /* AppDelegate.swift in Sources */ = {isa = PBXBuildFile; fileRef = 13F720922E8DFF9B027834B8 /* AppDelegate.swift */; };
D7F8F852A5B6FF5E887C13CD /* WindowLocator.swift in Sources */ = {isa = PBXBuildFile; fileRef = 07D7F8D2C883918C1D8125C2 /* WindowLocator.swift */; };
DEE81AEB5FD750511EB331C3 /* DebounceTests.swift in Sources */ = {isa = PBXBuildFile; fileRef = 67290BF09C16440EE8EC5F0A /* DebounceTests.swift */; };
FED57F4C597F7DA62B540A21 /* WindowLocatorTests.swift in Sources */ = {isa = PBXBuildFile; fileRef = 14D8963F47F88A0EB59672CD /* WindowLocatorTests.swift */; };
/* End PBXBuildFile section */
/* Begin PBXContainerItemProxy section */
9E463F6F6CA86E27D10D16C4 /* PBXContainerItemProxy */ = {
isa = PBXContainerItemProxy;
containerPortal = E406203B385B50B976761426 /* Project object */;
proxyType = 1;
remoteGlobalIDString = 2274BE8F97DC846458C50849;
remoteInfo = FocusFixer;
};
/* End PBXContainerItemProxy section */
/* Begin PBXFileReference section */
07D7F8D2C883918C1D8125C2 /* WindowLocator.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = WindowLocator.swift; sourceTree = "<group>"; };
0E21E251CF9229938F0B628E /* FocusFixerTests.xctest */ = {isa = PBXFileReference; explicitFileType = wrapper.cfbundle; includeInIndex = 0; path = FocusFixerTests.xctest; sourceTree = BUILT_PRODUCTS_DIR; };
13F720922E8DFF9B027834B8 /* AppDelegate.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = AppDelegate.swift; sourceTree = "<group>"; };
14D8963F47F88A0EB59672CD /* WindowLocatorTests.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = WindowLocatorTests.swift; sourceTree = "<group>"; };
18945640C7DCF7D2BB10B26D /* PreferencesTests.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = PreferencesTests.swift; sourceTree = "<group>"; };
18AE36788814E7B845FD6E7F /* Preferences.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = Preferences.swift; sourceTree = "<group>"; };
583FC010F2AC5DA68F9A479C /* FocusEnforcer.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = FocusEnforcer.swift; sourceTree = "<group>"; };
67290BF09C16440EE8EC5F0A /* DebounceTests.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = DebounceTests.swift; sourceTree = "<group>"; };
8BA5F1D3E43F0843B442B0C3 /* PermissionManager.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = PermissionManager.swift; sourceTree = "<group>"; };
94BEBF21BDD32FE15C4B8F0C /* main.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = main.swift; sourceTree = "<group>"; };
9D1D1A4D3772591B7BE3B668 /* FocusFixer.app */ = {isa = PBXFileReference; explicitFileType = wrapper.application; includeInIndex = 0; path = FocusFixer.app; sourceTree = BUILT_PRODUCTS_DIR; };
9F6A6781660931E8DE13CBA8 /* EventTapController.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = EventTapController.swift; sourceTree = "<group>"; };
/* End PBXFileReference section */
/* Begin PBXGroup section */
1791F5CD1D3C0EDC80AA8EA8 /* FocusFixerTests */ = {
isa = PBXGroup;
children = (
67290BF09C16440EE8EC5F0A /* DebounceTests.swift */,
18945640C7DCF7D2BB10B26D /* PreferencesTests.swift */,
14D8963F47F88A0EB59672CD /* WindowLocatorTests.swift */,
);
path = FocusFixerTests;
sourceTree = "<group>";
};
211A341AA5FDBEBBB831893A /* FocusFixer */ = {
isa = PBXGroup;
children = (
13F720922E8DFF9B027834B8 /* AppDelegate.swift */,
9F6A6781660931E8DE13CBA8 /* EventTapController.swift */,
583FC010F2AC5DA68F9A479C /* FocusEnforcer.swift */,
94BEBF21BDD32FE15C4B8F0C /* main.swift */,
8BA5F1D3E43F0843B442B0C3 /* PermissionManager.swift */,
18AE36788814E7B845FD6E7F /* Preferences.swift */,
07D7F8D2C883918C1D8125C2 /* WindowLocator.swift */,
);
path = FocusFixer;
sourceTree = "<group>";
};
38C55F723E487F1371990734 = {
isa = PBXGroup;
children = (
211A341AA5FDBEBBB831893A /* FocusFixer */,
1791F5CD1D3C0EDC80AA8EA8 /* FocusFixerTests */,
882C44028E7037E70CA117B4 /* Products */,
);
sourceTree = "<group>";
};
882C44028E7037E70CA117B4 /* Products */ = {
isa = PBXGroup;
children = (
9D1D1A4D3772591B7BE3B668 /* FocusFixer.app */,
0E21E251CF9229938F0B628E /* FocusFixerTests.xctest */,
);
name = Products;
sourceTree = "<group>";
};
/* End PBXGroup section */
/* Begin PBXNativeTarget section */
2274BE8F97DC846458C50849 /* FocusFixer */ = {
isa = PBXNativeTarget;
buildConfigurationList = 336271D4A81B9CB911993090 /* Build configuration list for PBXNativeTarget "FocusFixer" */;
buildPhases = (
F95ABA416F370B29F1A5C6EA /* Sources */,
);
buildRules = (
);
dependencies = (
);
name = FocusFixer;
packageProductDependencies = (
);
productName = FocusFixer;
productReference = 9D1D1A4D3772591B7BE3B668 /* FocusFixer.app */;
productType = "com.apple.product-type.application";
};
C276426D2F31753646ED8E29 /* FocusFixerTests */ = {
isa = PBXNativeTarget;
buildConfigurationList = 16F48D487CFBC1464F087BCE /* Build configuration list for PBXNativeTarget "FocusFixerTests" */;
buildPhases = (
E421552178F3632A174E9DF2 /* Sources */,
);
buildRules = (
);
dependencies = (
FA4181D70BA95B3FFC2C1233 /* PBXTargetDependency */,
);
name = FocusFixerTests;
packageProductDependencies = (
);
productName = FocusFixerTests;
productReference = 0E21E251CF9229938F0B628E /* FocusFixerTests.xctest */;
productType = "com.apple.product-type.bundle.unit-test";
};
/* End PBXNativeTarget section */
/* Begin PBXProject section */
E406203B385B50B976761426 /* Project object */ = {
isa = PBXProject;
attributes = {
BuildIndependentTargetsInParallel = YES;
LastUpgradeCheck = 1430;
TargetAttributes = {
2274BE8F97DC846458C50849 = {
ProvisioningStyle = Automatic;
};
C276426D2F31753646ED8E29 = {
ProvisioningStyle = Automatic;
};
};
};
buildConfigurationList = 7D0C38B716F9F4A97F3ACC0F /* Build configuration list for PBXProject "FocusFixer" */;
developmentRegion = en;
hasScannedForEncodings = 0;
knownRegions = (
Base,
en,
);
mainGroup = 38C55F723E487F1371990734;
minimizedProjectReferenceProxies = 1;
preferredProjectObjectVersion = 77;
productRefGroup = 882C44028E7037E70CA117B4 /* Products */;
projectDirPath = "";
projectRoot = "";
targets = (
2274BE8F97DC846458C50849 /* FocusFixer */,
C276426D2F31753646ED8E29 /* FocusFixerTests */,
);
};
/* End PBXProject section */
/* Begin PBXSourcesBuildPhase section */
E421552178F3632A174E9DF2 /* Sources */ = {
isa = PBXSourcesBuildPhase;
buildActionMask = 2147483647;
files = (
DEE81AEB5FD750511EB331C3 /* DebounceTests.swift in Sources */,
67D53FB027B5450292EA0E19 /* PreferencesTests.swift in Sources */,
FED57F4C597F7DA62B540A21 /* WindowLocatorTests.swift in Sources */,
);
runOnlyForDeploymentPostprocessing = 0;
};
F95ABA416F370B29F1A5C6EA /* Sources */ = {
isa = PBXSourcesBuildPhase;
buildActionMask = 2147483647;
files = (
AED74188139B448C5DF52328 /* AppDelegate.swift in Sources */,
02861A191097E26F4BBFFC3C /* EventTapController.swift in Sources */,
3A6CBD1179B0870EF6A4DF5C /* FocusEnforcer.swift in Sources */,
1855F520A8A8D2091F6D1915 /* PermissionManager.swift in Sources */,
ADF3776153FD8C769680597F /* Preferences.swift in Sources */,
D7F8F852A5B6FF5E887C13CD /* WindowLocator.swift in Sources */,
26C71677B1D8CB4CD657154D /* main.swift in Sources */,
);
runOnlyForDeploymentPostprocessing = 0;
};
/* End PBXSourcesBuildPhase section */
/* Begin PBXTargetDependency section */
FA4181D70BA95B3FFC2C1233 /* PBXTargetDependency */ = {
isa = PBXTargetDependency;
target = 2274BE8F97DC846458C50849 /* FocusFixer */;
targetProxy = 9E463F6F6CA86E27D10D16C4 /* PBXContainerItemProxy */;
};
/* End PBXTargetDependency section */
/* Begin XCBuildConfiguration section */
2DD07A9740EDCB8CF35DFCC7 /* Debug */ = {
isa = XCBuildConfiguration;
buildSettings = {
ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon;
COMBINE_HIDPI_IMAGES = YES;
GENERATE_INFOPLIST_FILE = NO;
INFOPLIST_FILE = FocusFixer/Info.plist;
LD_RUNPATH_SEARCH_PATHS = (
"$(inherited)",
"@executable_path/../Frameworks",
);
MACOSX_DEPLOYMENT_TARGET = 13.0;
PRODUCT_BUNDLE_IDENTIFIER = com.local.focusfixer;
PRODUCT_NAME = FocusFixer;
SDKROOT = macosx;
};
name = Debug;
};
4C55CEB7A8359D1CD8B32D5A /* Debug */ = {
isa = XCBuildConfiguration;
buildSettings = {
BUNDLE_LOADER = "$(TEST_HOST)";
COMBINE_HIDPI_IMAGES = YES;
GENERATE_INFOPLIST_FILE = YES;
LD_RUNPATH_SEARCH_PATHS = (
"$(inherited)",
"@executable_path/../Frameworks",
"@loader_path/../Frameworks",
);
MACOSX_DEPLOYMENT_TARGET = 13.0;
SDKROOT = macosx;
TEST_HOST = "$(BUILT_PRODUCTS_DIR)/FocusFixer.app/Contents/MacOS/FocusFixer";
};
name = Debug;
};
5AEBCBD9302CD9E837EB33A1 /* Release */ = {
isa = XCBuildConfiguration;
buildSettings = {
ALWAYS_SEARCH_USER_PATHS = NO;
CLANG_ANALYZER_NONNULL = YES;
CLANG_ANALYZER_NUMBER_OBJECT_CONVERSION = YES_AGGRESSIVE;
CLANG_CXX_LANGUAGE_STANDARD = "gnu++14";
CLANG_CXX_LIBRARY = "libc++";
CLANG_ENABLE_MODULES = YES;
CLANG_ENABLE_OBJC_ARC = YES;
CLANG_ENABLE_OBJC_WEAK = YES;
CLANG_WARN_BLOCK_CAPTURE_AUTORELEASING = YES;
CLANG_WARN_BOOL_CONVERSION = YES;
CLANG_WARN_COMMA = YES;
CLANG_WARN_CONSTANT_CONVERSION = YES;
CLANG_WARN_DEPRECATED_OBJC_IMPLEMENTATIONS = YES;
CLANG_WARN_DIRECT_OBJC_ISA_USAGE = YES_ERROR;
CLANG_WARN_DOCUMENTATION_COMMENTS = YES;
CLANG_WARN_EMPTY_BODY = YES;
CLANG_WARN_ENUM_CONVERSION = YES;
CLANG_WARN_INFINITE_RECURSION = YES;
CLANG_WARN_INT_CONVERSION = YES;
CLANG_WARN_NON_LITERAL_NULL_CONVERSION = YES;
CLANG_WARN_OBJC_IMPLICIT_RETAIN_SELF = YES;
CLANG_WARN_OBJC_LITERAL_CONVERSION = YES;
CLANG_WARN_OBJC_ROOT_CLASS = YES_ERROR;
CLANG_WARN_QUOTED_INCLUDE_IN_FRAMEWORK_HEADER = YES;
CLANG_WARN_RANGE_LOOP_ANALYSIS = YES;
CLANG_WARN_STRICT_PROTOTYPES = YES;
CLANG_WARN_SUSPICIOUS_MOVE = YES;
CLANG_WARN_UNGUARDED_AVAILABILITY = YES_AGGRESSIVE;
CLANG_WARN_UNREACHABLE_CODE = YES;
CLANG_WARN__DUPLICATE_METHOD_MATCH = YES;
CODE_SIGN_STYLE = Automatic;
COPY_PHASE_STRIP = NO;
DEBUG_INFORMATION_FORMAT = "dwarf-with-dsym";
ENABLE_HARDENED_RUNTIME = NO;
ENABLE_NS_ASSERTIONS = NO;
ENABLE_STRICT_OBJC_MSGSEND = YES;
GCC_C_LANGUAGE_STANDARD = gnu11;
GCC_NO_COMMON_BLOCKS = YES;
GCC_WARN_64_TO_32_BIT_CONVERSION = YES;
GCC_WARN_ABOUT_RETURN_TYPE = YES_ERROR;
GCC_WARN_UNDECLARED_SELECTOR = YES;
GCC_WARN_UNINITIALIZED_AUTOS = YES_AGGRESSIVE;
GCC_WARN_UNUSED_FUNCTION = YES;
GCC_WARN_UNUSED_VARIABLE = YES;
MACOSX_DEPLOYMENT_TARGET = 13.0;
MTL_ENABLE_DEBUG_INFO = NO;
MTL_FAST_MATH = YES;
PRODUCT_NAME = "$(TARGET_NAME)";
SDKROOT = macosx;
SWIFT_COMPILATION_MODE = wholemodule;
SWIFT_OPTIMIZATION_LEVEL = "-O";
SWIFT_VERSION = 5.9;
};
name = Release;
};
70FD6E93579D7CC65D70BD03 /* Release */ = {
isa = XCBuildConfiguration;
buildSettings = {
BUNDLE_LOADER = "$(TEST_HOST)";
COMBINE_HIDPI_IMAGES = YES;
GENERATE_INFOPLIST_FILE = YES;
LD_RUNPATH_SEARCH_PATHS = (
"$(inherited)",
"@executable_path/../Frameworks",
"@loader_path/../Frameworks",
);
MACOSX_DEPLOYMENT_TARGET = 13.0;
SDKROOT = macosx;
TEST_HOST = "$(BUILT_PRODUCTS_DIR)/FocusFixer.app/Contents/MacOS/FocusFixer";
};
name = Release;
};
83E1BF6F7A218D06F8AB5DBA /* Debug */ = {
isa = XCBuildConfiguration;
buildSettings = {
ALWAYS_SEARCH_USER_PATHS = NO;
CLANG_ANALYZER_NONNULL = YES;
CLANG_ANALYZER_NUMBER_OBJECT_CONVERSION = YES_AGGRESSIVE;
CLANG_CXX_LANGUAGE_STANDARD = "gnu++14";
CLANG_CXX_LIBRARY = "libc++";
CLANG_ENABLE_MODULES = YES;
CLANG_ENABLE_OBJC_ARC = YES;
CLANG_ENABLE_OBJC_WEAK = YES;
CLANG_WARN_BLOCK_CAPTURE_AUTORELEASING = YES;
CLANG_WARN_BOOL_CONVERSION = YES;
CLANG_WARN_COMMA = YES;
CLANG_WARN_CONSTANT_CONVERSION = YES;
CLANG_WARN_DEPRECATED_OBJC_IMPLEMENTATIONS = YES;
CLANG_WARN_DIRECT_OBJC_ISA_USAGE = YES_ERROR;
CLANG_WARN_DOCUMENTATION_COMMENTS = YES;
CLANG_WARN_EMPTY_BODY = YES;
CLANG_WARN_ENUM_CONVERSION = YES;
CLANG_WARN_INFINITE_RECURSION = YES;
CLANG_WARN_INT_CONVERSION = YES;
CLANG_WARN_NON_LITERAL_NULL_CONVERSION = YES;
CLANG_WARN_OBJC_IMPLICIT_RETAIN_SELF = YES;
CLANG_WARN_OBJC_LITERAL_CONVERSION = YES;
CLANG_WARN_OBJC_ROOT_CLASS = YES_ERROR;
CLANG_WARN_QUOTED_INCLUDE_IN_FRAMEWORK_HEADER = YES;
CLANG_WARN_RANGE_LOOP_ANALYSIS = YES;
CLANG_WARN_STRICT_PROTOTYPES = YES;
CLANG_WARN_SUSPICIOUS_MOVE = YES;
CLANG_WARN_UNGUARDED_AVAILABILITY = YES_AGGRESSIVE;
CLANG_WARN_UNREACHABLE_CODE = YES;
CLANG_WARN__DUPLICATE_METHOD_MATCH = YES;
CODE_SIGN_STYLE = Automatic;
COPY_PHASE_STRIP = NO;
DEBUG_INFORMATION_FORMAT = dwarf;
ENABLE_HARDENED_RUNTIME = NO;
ENABLE_STRICT_OBJC_MSGSEND = YES;
ENABLE_TESTABILITY = YES;
GCC_C_LANGUAGE_STANDARD = gnu11;
GCC_DYNAMIC_NO_PIC = NO;
GCC_NO_COMMON_BLOCKS = YES;
GCC_OPTIMIZATION_LEVEL = 0;
GCC_PREPROCESSOR_DEFINITIONS = (
"$(inherited)",
"DEBUG=1",
);
GCC_WARN_64_TO_32_BIT_CONVERSION = YES;
GCC_WARN_ABOUT_RETURN_TYPE = YES_ERROR;
GCC_WARN_UNDECLARED_SELECTOR = YES;
GCC_WARN_UNINITIALIZED_AUTOS = YES_AGGRESSIVE;
GCC_WARN_UNUSED_FUNCTION = YES;
GCC_WARN_UNUSED_VARIABLE = YES;
MACOSX_DEPLOYMENT_TARGET = 13.0;
MTL_ENABLE_DEBUG_INFO = INCLUDE_SOURCE;
MTL_FAST_MATH = YES;
ONLY_ACTIVE_ARCH = YES;
PRODUCT_NAME = "$(TARGET_NAME)";
SDKROOT = macosx;
SWIFT_ACTIVE_COMPILATION_CONDITIONS = DEBUG;
SWIFT_OPTIMIZATION_LEVEL = "-Onone";
SWIFT_VERSION = 5.9;
};
name = Debug;
};
8828802B6A800297D33E0596 /* Release */ = {
isa = XCBuildConfiguration;
buildSettings = {
ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon;
COMBINE_HIDPI_IMAGES = YES;
GENERATE_INFOPLIST_FILE = NO;
INFOPLIST_FILE = FocusFixer/Info.plist;
LD_RUNPATH_SEARCH_PATHS = (
"$(inherited)",
"@executable_path/../Frameworks",
);
MACOSX_DEPLOYMENT_TARGET = 13.0;
PRODUCT_BUNDLE_IDENTIFIER = com.local.focusfixer;
PRODUCT_NAME = FocusFixer;
SDKROOT = macosx;
};
name = Release;
};
/* End XCBuildConfiguration section */
/* Begin XCConfigurationList section */
16F48D487CFBC1464F087BCE /* Build configuration list for PBXNativeTarget "FocusFixerTests" */ = {
isa = XCConfigurationList;
buildConfigurations = (
4C55CEB7A8359D1CD8B32D5A /* Debug */,
70FD6E93579D7CC65D70BD03 /* Release */,
);
defaultConfigurationIsVisible = 0;
defaultConfigurationName = Debug;
};
336271D4A81B9CB911993090 /* Build configuration list for PBXNativeTarget "FocusFixer" */ = {
isa = XCConfigurationList;
buildConfigurations = (
2DD07A9740EDCB8CF35DFCC7 /* Debug */,
8828802B6A800297D33E0596 /* Release */,
);
defaultConfigurationIsVisible = 0;
defaultConfigurationName = Debug;
};
7D0C38B716F9F4A97F3ACC0F /* Build configuration list for PBXProject "FocusFixer" */ = {
isa = XCConfigurationList;
buildConfigurations = (
83E1BF6F7A218D06F8AB5DBA /* Debug */,
5AEBCBD9302CD9E837EB33A1 /* Release */,
);
defaultConfigurationIsVisible = 0;
defaultConfigurationName = Debug;
};
/* End XCConfigurationList section */
};
rootObject = E406203B385B50B976761426 /* Project object */;
}