The goal is to bind XMFFW with your shortcuts in some way, either directly or indirectly, to include seamlessly into your workflow.

XMFFW can work well as a standalone action, or as a part of a multi action shortcut.

There is no config file, you modify the values in the source and recompile in order to modify the functionality.

1. You do not have to look at the C code at all, just the top few lines in order to modify the values and then recompile with them.
2. It encourages you to look under the hood of this very simple program, in order to either make modifications yourself or understand what you are running, not just believe I am not stealing all of your data.
3. I am lazy and have not implemented a config file yet
4. Might be 0.0000001s slower with a config file lookup, think of the people with hard drives, what if they have to invoke it a few times per second.

In the terminal insert these commands

git clone https://github.com/Vasil-Todorov/XMouseFollowFocusedWindow

sudo make install

Move the cursor away from the terminal and insert this command to see how the program works

./xmffw

If it is to your liking, great! If not, please open main.c with a text editor and follow the instructions in the file to modify the program to your liking.

After that you neeed to

sudo make install

again, to update the binary that you are using

Using a tiling script like Bismuth is recommended, but you can use the program standalone as well.

Go to:

System Settings -> Shortcuts -> Custom Shortcuts -> Edit (At the bottom) -> New -> Window Action -> Command/URL

Name the Custom Shortcut, and go to the Trigger tab.
There, click on Window gets focus, and edit the Window Simple rule, by clicking Normal at the button, so the shortcut only affects Normal windows, not dialogs, etc.
Go to Action and there type xmffw in the Command/URL space.

Now the cursor will warp to the focused window any time you switch focus via shortcut, open a new window, etc.

Go to:

System Settings -> Shortcuts -> Custom Shortcuts -> Edit (At the bottom) -> New -> Global Shortcut -> Command/URL

Name the Custom Shortcut, and go to the Trigger tab.
There, click on Shortcut, and enter the shortcut you would like to invoke XMFFW with.
Go to Action and there type xmffw in the Command/URL space.

Now you can invoke XMFFW via your custom shortcut any time that you want.

If you ever need to delete the program, keep in mind that that will not delete the shortcut. Delete the shortcut FIRST. Otherwise you might need to do some debugging when Plasma does not find the command and bugs, then the window announcing the problems gets focus, etc.

TTY is a good option to debug this from my experience.

You can add the xmffw command to the appropriate shortcuts in the config.h and use it instead of a mouse warping patch, if you like some of my functionality better.

Or if you want to be really fancy, you can implement my code into your dwm.c file for the functionality you like!

Be creative, invoke XMFFW manually or as part of other commands, think about all of the possibilities!

If you are on a tiling wm, you probably know how to implement this program into your workflow. If you do not, feel free to PM me.

If you want to share the ideas from your setup, please make a pull request, bug report, etc. I will include them here!

I only included ideas for the use cases I have verified to work!

1. ISSMOOTH is a bool that decides whether the cursor just teleports to the desired location, or "smoothly" goes there in increments. 1 is "smooth", 0 is not

   1. SMOOTHINCREMENT is an int that decides how large the step of the increment will be along the path
   2. SLEEPTIME is an int which decides how long the program will sleep between increments

2. WARPOUTSIDE is a bool that decides whether or not the cursor will be sent outside of the window.1 is outside, 0 is inside

   1. WARPXPLACE is the place that the cursor will teleport to, along the X axis. Is a percentage of the width of the window when warping inside, and a straight pixel value when warping outside.
   2. WARPYPLACE is the place that the cursor will teleport to, along the Y axis. Is a percentage of the height of the window when warping inside, and a straight pixel value when warping outside.

If you are teleporting outside, whether or not WARPXPLACE and YPLACE are positive or negative decides where to teleport. Negative means to the left and on top, respectively. Positive (including 0) means to the right and below, respectively.

3. ALWAYSWARP is a bool that decides whether to always teleport the mouse to the desired location when XMFFW is invoked. 1 means always teleport, 0 means see where the cursor is, and decide if it needs teleportation. If the cursor is inside of the window or within an acceptable distance of the window, it does not get teleported.
   1. DISTANCETOLERANCE is an int that describes the distance in pixels the inf. norm from the edge of the focused window, meaning extending from the window by the value of the variable in the X and Y directions. Keep in mind that it can be negative to reduce the area of the acceptable distance.

Yes, yes it is. This is my first real C project, and even if it were my 10th, it would probably still be bad. If you are a C wizard or just have an idea of how to make the project better, and/or structure the code better, please send a pull request, make a bug report, etc. I am thankful for the feedback and ideas.