mouse45

A scrolling utility for Linux/Wayland/X11 that simulates scrolling and has bhopping.

Prerequisites

Before building, make sure you have all the required libaries for building C code (gcc)

Debian/Ubuntu:

sudo apt update
sudo apt install build-essential

Fedora:

sudo dnf groupinstall "Development Tools"
sudo dnf install kernel-headers

Arch:

sudo pacman -Syu base-devel

Building

make clean
make

Install

If you want to use the .desktop file, you will need xfce4-terminal

Debian/Ubuntu:

sudo apt install xfce4-terminal

Fedora:

sudo dnf install xfce4-terminal

Arch:

sudo pacman -S xfce4-terminal

Building

git clone https://github.com/e9x/mouse45
cd mouse45
make

Optionally install the shortcuts:

make install

Permissions

You may find that running mouse45 gives errors relating to sudo and not being able to access a device with uinput. You can configure uinput roles like this:

echo 'KERNEL=="uinput", MODE="0660", GROUP="input", OPTIONS+="static_node=uinput"' | sudo tee /etc/udev/rules.d/99-uinput.rules

Make yourself a user too

sudo usermod -aG input $USER

If the above is too much then

Running

Start the program (requires root):

./bin/mouse45

Controls & Keybinds

Once the program is running and the devices are selected, the following keybinds are active:

Mouse Features

Trigger	Action	Description
Mouse Forward Button	Scroll Up	Simulates mouse wheel scrolling up.
Mouse Back Button	Scroll Down	Simulates mouse wheel scrolling down.
Ctrl + Mouse Forward**	Native Forward	Stops simulating mouse wheel while held
Ctrl/kbd> + Mouse Back	Native Back	Sends the back button event normally

Keyboard Features

Trigger	Action	Description
Hold ` (grave/tilde)	Bunny Hop	Spams the Spacebar while held (for gaming).

Terminal Management

When the terminal window running mouse45 is in focus:

Key	Function	Description
s	Toggle Scrolling	Enables/Disables the side-button scrolling feature.
b	Toggle Bhop	Enables/Disables the bunny hop macro ` feature.
z	Reselect Devices	Prompts you to pick devices again.
q	Quit	Exit

Help

Feel free to open an issue: https://github.com/e9x/mouse45/issues