BikeGremlin search...
Start » Linux » Tweaking » Altering mouse scroll speed in Linux

Altering mouse scroll speed in Linux

I started playing with Linux, having installed Mint (Ubuntu based, which is Debian based – for more details). Linux Mint is very user friendly (unlike Linux 15 years ago), but it does have its peculiarities (especially for us coming from decades of DOS & Windows use). One of the “problems” for me was simple mouse scroll button speed change. Here’s how I fixed that.

For solving this I used Imwheel. The procedure is relatively simple and straight forward, with a few tweaks (noted in this post). It boils down to this:

1. Installing Imwheel

You can open Software Manager, search for “Imwheel”, then click “Install”, after which you will be asked to enter your root password and that’s it.

Installing Imwheel using Linux Software Manager
Installing Imwheel using Linux Software Manager
Picture 1
Authenticating the install with a root password (1), then click "Authenticate" (2)
Authenticating the install with a root password (1), then click “Authenticate” (2)
Picture 2

Of course, you could use the command prompt (CTRL+ALT+T is the keyboard shortcut, not WIN+R – note to self 🙂 ). Imwheel is installed using the following command (you will be prompted for a root password after pressing Enter):

sudo apt-get install imwheel
Command prompt installation of Imwheel
Command prompt installation of Imwheel
Picture 3

If all went well, you will see something like this:

Imwheel successfully installed
Imwheel successfully installed
Picture 4

2. Configuring Imwheel

Configuration boils down to creating a .sh file with an appropriate code, then running it. I did it the following way:

I created an “Utils” directory in my “Home” directory (that is “/home/relja/Utils”). Of course, you can put the file anywhere you want.

Then I opened a text editor, copied the needed code (found at this page – thank you) and saved it as “” – you can name it however you like, as long as you know the file name and directory where it’s saved at.

Needed file contents:

# Version 0.1 Tuesday, 07 May 2013
# Comments and complaints
# GUI for mouse wheel speed using imwheel in Gnome
# imwheel needs to be installed for this script to work
# sudo apt-get install imwheel
# Pretty much hard wired to only use a mouse with
# left, right and wheel in the middle.
# If you have a mouse with complications or special needs,
# use the command xev to find what your wheel does.
### see if imwheel config exists, if not create it ###
if [ ! -f ~/.imwheelrc ]

cat >~/.imwheelrc<<EOF
None,      Up,   Button4, 1
None,      Down, Button5, 1
Control_L, Up,   Control_L|Button4
Control_L, Down, Control_L|Button5
Shift_L,   Up,   Shift_L|Button4
Shift_L,   Down, Shift_L|Button5


CURRENT_VALUE=$(awk -F 'Button4,' '{print $2}' ~/.imwheelrc)

NEW_VALUE=$(zenity --scale --window-icon=info --ok-label=Apply --title="Wheelies" --text "Mouse wheel speed:" --min-value=1 --max-value=100 --value="$CURRENT_VALUE" --step 1)

if [ "$NEW_VALUE" == "" ];
then exit 0

sed -i "s/\($TARGET_KEY *Button4, *\).*/\1$NEW_VALUE/" ~/.imwheelrc # find the string Button4, and write new value.
sed -i "s/\($TARGET_KEY *Button5, *\).*/\1$NEW_VALUE/" ~/.imwheelrc # find the string Button5, and write new value.

cat ~/.imwheelrc
imwheel -kill

WordPress’s front end messes up the code, replacing two “minus signs” with a long dash. So, I’ve made a simple downloadable file if it helps:

Then, in the command prompt, go to the directory and run the file. Before running the script, you must give it the execution rights using the command “chmod +x” In my case:

cd /home/relja/Utils
chmod +x

Here’s how it looks like on screen, you’ll get to set mouse scroll speed:

Enter the three command lines (enter after each, of course) (1), select desired scroll speed (2), then click "Apply" (3)
Enter the three command lines (enter after each, of course) (1), select desired scroll speed (2), then click “Apply” (3)
Picture 5

I chose 3. After clicking at “Apply”, you’ll see something like this:

Successfully finished scroll speed configuration
Successfully finished scroll speed configuration
Picture 6

If you aren’t happy with the newly set mouse scroll speed, just run the “” again, as expained in picture 5.

How can I help BikeGremlin to remain independent and objective?

Become a patron - Support BikeGremlin on Patreon

3. Configuring Imwheel to run after each restart

For this I used “Startup Applications”.

Opening "Startup Applications"
Opening “Startup Applications”
Picture 7

On the next screen click the ” + ” sign and choose “Custom command” option.

Click the + sign and choose "Custom command"
Click the + sign and choose “Custom command”
Picture 8

The last step is shown and explained in the picture 9:

Use whatever you want for name (1) Command must say "imwheel", because that is the application (2) For comment, use whatever you like (3) Add a startup delay if you like - I set a 5 second delay (4) Finally, click "Add" (5)
Use whatever you want for name (1)
Command must say “imwheel”, because that is the application (2)
For comment, use whatever you like (3)
Add a startup delay if you like – I set a 5 second delay (4)
Finally, click “Add” (5)
Picture 9

You can try restarting the computer, to make sure mouse scroll speed is still working properly.


As Alex added in the comment section, there can be a problem with the functioning of extra mouse buttons (with some mouses that have extra buttons, in addition to the standard two and the wheel). The solution is limiting imwheel to the scroll only (wheel up: 4, and wheel down: 5). For Linux Mint, it is the following command:

imwheel -b "4 5"

“-b” is the switch that basically says “deal only with the listed buttons”. This can also be added to the command line – (2) in picture 9.

For more details (manual), type this in the command prompt:

man imwheel

59 thoughts on “Altering mouse scroll speed in Linux”

  1. No NO NO

    This is microsoft bullshit. I don’t need to install ANYTHING to adjust settings. We need to have this setting exposed. 3rd party apps just pollute the computing environment.

    • Can you propose another way of doing this, or provide a link where an alternative solution is explained in a noob-friendly way?

  2. I’d gladly pay Bill Gates 100 USD or whatever Windows 10 costs nowadays to not have to waste my time on this cryptic GNU BS. Maybe even get a Mac and practical accent input as well.

    • worked:

      sudo apt-get install imwheel

      gedit ~/.imwheelrc

      Paste this, save, and close gedit:

      None, Up, Button4, 3
      None, Down, Button5, 3
      Control_L, Up, Control_L|Button4
      Control_L, Down, Control_L|Button5
      Shift_L, Up, Shift_L|Button4
      Shift_L, Down, Shift_L|Button5

      imwheel –kill –buttons “4 5”

      Add previous command to autostarts (maybe ~/.bashrc).

    • It’s not “GNU BS” – it’s a choice. You choose and use what’s right for you – no-one is trying to take that away from you. Personally, I choose freedom, as I strongly believe the little quirks and a few “rough edges” here and there are well worth it.

      On a side-note, I have built a very successful career on Linux, so I donate back much more than $100 – every single year 🙂 Linux works for me, but it sounds like it rubs you up the wrong way.

    • “chromium” instead of “.*” to only affect Chromium and avoid turning 5 to 17 line scroll in GNOME Terminal 3.36.2.

      Linux Mint Cinnamon is my favorite OS at the moment, as i couldn’t even log into Windows 10 on a brand new HP Envy using my work email, and MacOS requires an Apple ID to update preinstalled software. Then again, Firefox caused the entire system to lag, but i’m not sure whether that also occurs on Windows as i switched to Chrome there as well and added my OOM Killer to avoid thrashing. Maybe Minix is the only truly reliable OS.

  3. Thanks, you rock. I’ll never understand why Ubuntu doesn’t have on option to change the scroll speed.

  4. Thank you so much!
    Why Ubuntu still doesn’t offer an option to adjust this by default is beyond my comprehension.
    But I’m having a minor issue: everything was fine until I realized that now my “back” and “forward” buttons aren’t working and I think the script somehow has blocked this function. They were working normally for web pages and Dolphin navigation before. Do you have any clue on what might have happened?

  5. Nice, it works even in Gnome running over Wayland, one just need to use a toggle before the command to make sure it can display the dialog window in Xwayland:
    XDG_BACKEND=x11 ./
    And just to clarify things a bit, the script just need to run when you want to change the scroll speed, the settings are actually saved to ~/.imwheelrc file, and read every time the daemon starts. You just need to use “sudo imwheel -k” if you want to change the command, like when you add ‘-b “4 5″‘, after the daemon is already running to prevent a ‘ghost’ process, like it was explained in the askubuntu site.

    PS: You may want to check your site service, I got a bunch of 503 errors (service not available) yesterday, and I almost gave up posting the comment…


    • Just a quick fix, as I cannot edit my reply: the correct environment variable to be used (XDG_BACKEND does nothing) is GDK_BACKEND=x11, this will force a program to run on Xwayland, when it is compatible with XOrg only.

  6. Boom, it’s help me out of the terrible scroll speed in ubuntu, thank you.

    Also, I have back/forth button in my mouse too, I tried imwheel -k -b “4 5” but seem it not work, not sure what wrong, is it different between each mouse?

    • I had some issues too. I fix them by modifying the file /etc/X11/imwheel/startup.conf

      I changed IMWHEEL_START=0 to IMWHEEL_START=1
      So there’s no need to add the startup application.

      On the same file, uncommented the IMWHEEL_PARAMS line and changed it to:
      IMWHEEL_PARAMS=’-b “4 5″‘
      that kept my other buttons working

    • Not that I know – maybe others can help. If touchpad input is defined differently (button numbers, as mentioned in the Troubleshooting section), then I suppose it could be configured. But I don’t think that is the case.

  7. the imwheel’s window is opening at each login, is there an option to start and apply settings but not open windows ? – Thx anyway for the trick

    • I’m not having that problem.
      For solving, I’d start with double checking the contents of the (or however it was named in this case).
      If there’s a line, or something else missing.

    • My error.. i’ve put in the startup rather than iwheel… corrected, run perfectly ! 🙂

  8. I have two hard drives with different linux distributions. When I boot linux from disk B, the mouse scroll speed is always the same. Instead, when I start the operating system from the disk A when the last time I used a hard disk B as a mouse scroll speed is very high. When I disconnect the mouse and put it back, the mouse scroll speed returns to normal. So the problem is probably somehow on the hard drives. Operating systems don’t matter.

    Can anyone tell me why this is?

  9. If you use a logitech mouse, try installing solaar and enable wheel resolution. It will produce windows like silky smooth scrolling.


Leave a Comment