Skip to content

Latest commit

 

History

History
168 lines (146 loc) · 7.73 KB

notes.md

File metadata and controls

168 lines (146 loc) · 7.73 KB
Raw

TODO

  • Windows

    • Embed interception.dll in .exe
    • keybindings for toggling app and changing modes should be global from the system and not the app
    • memory leaks
    • Add versioning
    • Tests via popup message
    • UI to debug events
    • multiple modes
    • configs with json array/object replacement helpers
    • alt tab enter issue
    • add builds for both x86 and x64 archs
    • enable/disable with double esc
    • logo
    • brightness
    • double press modifiers (eg. for the capslock with double shift press)
    • mouse clicks/mousedown/mouseup/drags
    • keybindings per app
    • fix issue with numpad and arrows (VERSION 1 is working properly!)
    • remaps
    • multiple keyboards
    • you should only test key cases, not entire flows (like vim mode)
    • rethink alghoritm to be more general so it can be used in any OS
    • validate if keycode doesnt exist
    • general Key (currentKey)
    • better error log for debug/release
    • afterKeyUp in keypresses

  • Mac

    • global shortcuts
    • Memory leaks
    • prettify code
    • handle daemon crash
    • logging support
    • update readme
    • use only one file for configs
    • development license via command line?
    • easy way for versioning
    • automate build
    • run the hidiomanager as a daemon (root process), follow https://github.com/CharlesJS/CSAuthSample or https://github.com/erikberglund/SwiftPrivilegedHelper
    • bug keyboard can become unresponsive after going to sleep/long time inactivity
    • versioning
    • multiple configs
    • press enter to disable/enable and see if the keyrepeat continues forever
    • mouse callback events stop after you click the app's top menu bar
    • if you use the gui version, if you type in the menu bar when the app is focused (eg. Help -> type something, it will not register the keys)
    • Move files that are shared between OSs to a common place
    • detect current application
    • shift + capslock = not triggering shift + esc at first time/ test on a youtube video
    • toggle caps
    • multiple modes
    • mouse clicks/mousedown/mouseup/drags
    • multiple keyboards
    • trigger media keys
      • brightnessDown/up, keyboardIlluminationDown/up, rewind/playPause/fastForward, mute, volumeDown/up
    • exiting app from terminal (cmd+q) doesnt remove the process (it's expected to kill the keyRemapper process)
    • simple GUI
    • Fn key not working when app is disabled
    • shortcuts for mission control, launchpad?
      • maybe via shell command
        $ open "/System/Applications/Launchpad.app"
  $ open "/System/Applications/Mission Control.app"
    • implement tests with time delays to test multiple key presses
    • Move tests out of the Google test framework so we can test on Mac too

Text navigation/manipulation

Since I prefer how text manipulations work in Mac over windows, the following shows how it works on Mac so I can replicate it on Windows:

  • Alt + [Shift] + ←/→ → jump [select] to start/end of word
  • Cmd + [Shift] + ←/→ → jump [select] to start/end of line
  • Cmd + [Shift] + ↓/↑ → jump [select] to start/end of file
  • Alt + BackSpace → Delete to start of word
  • Cmd + BackSpace → delete to start of line

VIM mode should work like this for both win/mac (To match same layout keyboaord with Windows, replace Cmd/Alt with Ctrl/Win):

  • Caps + [F] + H/L/K/J → move [select] Left/Right/Up/Down
  • Caps + Alt + [F] + H/L → jump [select] to start/end of word
  • Caps + Cmd + [F] + H/L → jump [select] to start/end of line
  • Caps + Cmd + [F] + K/J → jump [select] to start/end of file

Notes

  • Windows

    • FakeShiftL is triggered when some special keys (left, right) are used with NumLock on. So I'm ignoring it.
    • Use Scan Codes to alter a specific hardware keyboard key. For example, the numeric keypad keys each have the same Scan Code, but different Virtual keys with NumLock either on or off (e.g. Numpad6 and NumpadRight). Using the Scan Code ignores the NumLock status. Use Scan Codes (if available) to alter that extra key on your keyboard. (While Scan Codes may be used to add missing keys, most likely the new Virtual Key will also be required.)
    • For unicode (accents, tildes, etc)
    • Numlock

  • Mac

    • Key Codes App is very useful to debug event keys and flags sent to the system
    • Input Monitoring check is required by IOHIDKit to globally listen for keyboard input across the system
    • when you send a CGEventCreateKeyboardEvent, the system will automatically ask for you permission for Accessibility(Allow the app to control your computer)
    • When developing in XCode
      • make sure the schemas (debug/release) have the "Debug Process" as "root" instead so that it can actually capture all keyboard input from anywhere
      • Under properties of the project, Signing & Capabilities -> Signing Certificate, make sure is set to "Development" to avoid ticking/unticking the "Accesibility" and "Input Monitoring" permission checkboxes
      • If running the executable from terminal, you must grant Input Monitoring and Accesibility permissions to the terminal that runs it (eg. iTerm or Terminal). Also you should run it with root permissions (eg. $ sudo ~/Library/Developer/Xcode/DerivedData/KeyRemapperTerminal-xxx/Build/Products/Debug/KeyRemapperTerminal ; exit;
    • You can execute command line commands via system. eg.
      • system("say hello world");
      • system("osascript -e \"set volume 5\"");
    • Debug message sent to deallocated instance errors (EXC_BAD_INSTRUCTION)
      • Edit Schema -> Diagnostics -> Check: Zombie objects, Guard Malloc, Malloc Stack Logging (All allocations and Free History)
      • reproduce the error then in the llbd console:
        • (lldb) command script import lldb.macosx.heap
        • (lldb) malloc_info --stack-history 0xAAAAAAAAA
    • For the Swift UI Version:
      • com.apple.security.app-sandbox should be false in .entitlements

Snippets

// Capture media key events in init main.mm
auto myEventTap = CGEventTapCreate(kCGHIDEventTap, kCGTailAppendEventTap, kCGEventTapOptionDefault,
  CGEventMaskBit(NX_SYSDEFINED),
  //    CGEventMaskBit(kCGEventKeyDown), // this traps expose and launchpad keys
  [](CGEventTapProxy proxy, CGEventType type, CGEventRef event, void *refcon) {
    Helpers::print("NOICE");
      return event;
    }, NULL);

if (!myEventTap) {
  std::cout << "Accesibility disabled for this app";
}

auto myRunLoopSource = CFMachPortCreateRunLoopSource(kCFAllocatorDefault, myEventTap, 0);

if (!myEventTap) {
  std::cout << "Couldn't create runLoopSource";
}
CFRunLoopAddSource(CFRunLoopGetMain(), myRunLoopSource, kCFRunLoopCommonModes);
// Test memory leaks in init main.mm
 std::thread threadObj([]() {
   int i = 0;
   while (i < 500000) {
     toggleAppEnabled();
     std::this_thread::sleep_for(std::chrono::milliseconds(15));
     i++;
   }
 });
 threadObj.detach();
# read info.plist of a command line app
otool -X -s __TEXT __info_plist /path/to/executable | xxd -r

# read info.plist of an .app
cat /path/to/app/Contents/Info.plist

# push a new version (change the tag variable)
tag=v1.1.1 && git tag $tag && git push origin $tag

# path to msbuild (use a dot at begining to run it on powershell)
. "C:\Program Files\Microsoft Visual Studio\2022\Community\Msbuild\Current\Bin\MSBuild.exe" ...args
# to run it from bash, the path changes to
"/mnt/c/Program Files/Microsoft Visual Studio/2022/Community/Msbuild/Current/Bin/MSBuild.exe" ...args