Skip to content

A modal Mouse Key meant to entirely replace the mouse

Notifications You must be signed in to change notification settings

Corallus-Caninus/Rattus

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

85 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Rattus

A modal Mouse Key meant to entirely replace the mouse Currently tested on Linux (X11 only with proprietary nvidia drivers) and the Windows Universal Platform (UWP) including Windows Mixed Reality. Please find the corresponding fork for your system.

Keys:

7: up-left

8: up

9: up-right

4: left

5: left click and toggle left click hold

6: right

1: down-left

2: down

3: down-right

+: right click and toggle right click hold

Modes:

0/Insert: hold for fast movement

Enter: hold for slow movement

./Del: toggle hold on right or left click (click to toggle out)

/: toggle between rat mode or numpad mode

Rattus is under active development.

TODO:

  1. create Rattus.service or other integration

  2. add more modes (the keys are currently only for example and do not reflect what will be done in actuality):

    -middle click

    -record macro for repeating movements and clicks (also typing?) "Robot Mode" press enter on numpad then any of the numbers for a pre recorded operation at cursor position (9 "save slots")

    -rewrite numlock as arrow and number modes and use stateful representation since NKRO can cause numlock keycode packet headers to arrive out of order.

    -scroll wheel mode (1,2,3 are slow medium and fast down scroll respectively etc.) with the * button

    -history mode move to last click positions in buffer (up to n number of click positions) by tapping + to go back and - forward up to cursor position when search began

    -prediction mode toggle mode then move. when a TF model determines with confidence threshold where the next click or hover will occur it moves to that position interrupting user input. model takes input vector: ffmpeg or X11 equivalent of screen and mouse data outputs probability and position (cannot click can only teleport then exit predict mode). If user doesnt click or hover within a bounding box of teleport destination the prediction was incorrect else correct use reinforcement learning to train online with data from all movement modes.

Currently tested with command: cargo build --release; sudo target/release/Rattus

configuration (slowing down and speeding things up) can be edited in the Rat_config.toml file.

About

A modal Mouse Key meant to entirely replace the mouse

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages