This article describes how to set up a Bluetooth mouse through the command line without relying upon a graphical application.
Install the Bluetooth for more information.package which contains the current Linux bluetooth stack (Bluez5). You may also want to install which provides the bluetoothctl utility. See
The bluetoothctl utility provides a simple interface for configuring bluetooth devices. The text below is an example of how you can connect a bluetooth mouse using bluetoothctl:
# bluetoothctl [bluetooth]# list Controller <controller mac> BlueZ 5.5 [default] [bluetooth]# select <controller mac> [bluetooth]# power on [bluetooth]# scan on [bluetooth]# agent on [bluetooth]# devices Device <mouse mac> Name: Bluetooth Mouse [bluetooth]# pair <mouse mac> [bluetooth]# trust <mouse mac> [bluetooth]# connect <mouse mac>
If you experience mouse lag you can try to increase the polling rate. See Mouse polling rate for more information.
Problems with the USB dongle
If you have trouble with your USB dongle, you may also want to try:
# modprobe -v rfcomm
At this point, you should get an hci0 device with:
# hcitool dev
Sometimes the device is not active right away. Try starting the interface with:
# hciconfig hci0 up
and searching for devices as shown above.
Mouse always disconnect
If the mouse stops working but works again after restarting bluetooth, you may need to disable USB autosuspend for the selected device.
Apple Magic Mouse scroll speed
If the scroll speed is too slow, you can try
# rmmod hid_magicmouse # modprobe hid_magicmouse scroll_acceleration=1 scroll_speed=55
Scroll speed can be set from 0 to 63.
If the speed suits you, you can make the change permanent in
options hid_magicmouse scroll_acceleration=1 scroll_speed=55
Apple Magic Mouse middle click
If you find the middle click to be too finicky, you can disable it
# rmmod hid_magicmouse # modprobe hid_magicmouse emulate_3button=0
If this setting suits you, you can make the change permantent in
options hid_magicmouse emulate_3button=0