Skip to content

oyam/local-motion

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Local Motion

Local Motion detects objects, such as icons, text, or any elements near the current mouse position, moves the mouse cursor to these objects using keyboard navigation, and executes actions such as clicking.

It is designed to be activated after the mouse cursor has been roughly moved by another mouse control application, subsequently providing suggestions for precise movement adjustments.

Local Motion with Default Detector + Talon + Tobii Eye Tracker 5

default-detector-demo

Local Motion with Custom Detector (Word Detector) + Talon + Tobii Eye Tracker 5

custom-word-detector-demo

Platforms-supported:

  • Windows
  • macOS

Architecture and flow

Architecture

  • For details about the flow and features of Local Motion, please see docs/flow.md.
  • For examples of pre-motions and custom detector, please check out local-motion-examples.

Installation

  • Bundles for each OS are not currently available. Please build it yourself. See app/README.md.
  • Please read Settings, Security and Note sections before using Local Motion.

Settings

  • Download yolov8n.onnx (latest model is recommended) and place it in app/src-tauri/models folder before building the app.
  • settings of Local Motion can be opened from system tray.
  • When the app launches, a folder named .local-motion is created in the home directory, and within it, settings.json and local-motion.log are generated.

Security

  • Local Motion requires permissions to take screenshots, use global shortcuts, and control the mouse cursor, meaning you may need to grant permissions in your OS settings. For instance, the following steps are necessary to use Local Motion on macOS:
    • Go to Apple menu > System Settings > Privacy & Security > Screen & System Audio Recording. Turn the switch for Local Motion on.
    • Go to Apple menu > System Settings > Privacy & Security > Accessibility. Turn the switch for Local Motion on.
  • Please be aware that parts of screenshots will be sent when using custom detectors. It's recommended to confirm the custom detector is reliable.

Note

This project is currently in an experimental and development phase. Please be aware of the following points:

Licenses and Attributions

This project uses third-party components under various open source licenses. For detailed information on the licenses, attributions, and notices for these components, please see Attribution Documentation.

Additionally, the project itself is licensed under the MIT License. For more details, see the LICENSE file.