Frequently Asked Questions

Quit the application and:

Windows
Cursr is shipped with uninstaller, therefore it can be uninstalled like any other Windows application from settings 'Add or Remove Programs' section or by searching for Cursr in 'Start', right clicking it and selecting 'Uninstall'. Alternatively you can find an uninstaller.exe in the installation directory for Cursr.

If you installed Cursr for all users, during uninstall Cursr will only remove app data for current user. App data for other user, if they used Cursr, will have to be removed manually by deleting directory C:\\Users\\_insert_user_\\AppData\\Roaming\\cursr

macOS
For macOS Cursr is shipped as portable application and it does not contain uninstaller. To fully remove it you'll need to delete the application file and remove app data by deleting directory ~/Library/Application Support/cursr

Linux
AppImage is a portable application without uninstaller and debian package currently also does not contain an uninstaller due to some limitations. Therefore you'll need to delete a list of files and directories manually to fully remove Cursr. These include:
  • App data directory - ~/.config/cursr
  • Startup file - ~/.config/autostart/cursr-autostart.desktop
  • Desktop entry - /usr/share/applications/cursr.desktop OR ~/.local/share/applications/cursr.desktop
  • AppImage - downloaded AppImage OR integrated ~/Applications/Cursr_*.AppImage
  • Debian package - /opt/Cursr
How to update or downgrade Cursr?
Update
All builds with exception of Linux (.deb and .tar.gz) have auto-updates available which are enabled by default and can be disabled. If this functionality is disabled or not supported, Cursr will still notify you when a new update will be available.

If auto-updates are not supported you will be able to select option to open cursr.app and download latest version. You'll need to close Cursr, install downloaded update and launch Cursr again.

Downgrade
In app downgrade is not supported, but if after update Cursr is not working as expected you can always report the issue and then manually downgrade by downloading previous version build from Cursr Releases on Github:

  • Windows - Install-Cursr.exe
  • macOS - Cursr-mac-x64.dmg (or previously Cursr.dmg) and Cursr-mac-arm64.dmg
  • Linux - Cursr.AppImage, Cursr.deb and Cursr.tar.gz
But please note that when downgrading, reverse compatibility is not guaranteed and you might need to re-do all/some of the layout/link setups.

Old and/or unused versions are regularly removed from Github releases. If file for version that you want to use has been removed you can request it by sending a request to [email protected] with explanation why you need that version.
Cursr requires information updates for mouse movement in order to function. To allow monitoring such information macOS requires that user grants access for the application to use Accessibility features.
Cursr uses 'TCP' and 'UDP' communications which can be blocked by firewall, therefore first make sure there are no Inbound Firewall rules blocking 'UDP' or 'TCP' communications for 'cursr.exe' or 'Cursr'. By default these should be allowed on Private networks unless you chose otherwise, therefore check if your network is set to Private or Public and then check corresponding firewall settings. Alternatively to avoid unnecessarily looking for individual firewall rules you can also disable firewall (not recommended on Public network) to check if it will help, before tracking down individual rules causing the issue.

If the above did not help open up all instances of Cursr and try connecting manually by clicking red 'connect' button in bottom right corner of Cursr. You should see popup appear on all instances saying ' Scanning for all available devices' which will change as connection gets set up.

If popup does not appear on one or more instances:
  1. Make sure that all devices are connected to same network
  2. Make sure that the same 'Network Range' is available and selected in 'Virtual Switch' settings across all Cursr instances. If these are not matching and matching options are not available try clicking 'Refresh Network'.
  3. Make sure that 'Hide from Network' is not enabled in 'Virtual Switch' settings
  4. Make sure that all Cursr instances have same 'Discovery Port' set in 'Virtual Switch' settings
If none of the above help, try renewing DHCP lease:
  • macOS - open Wi-Fi settings, for connected network open 'Details...', select 'TCP/IP' section on left and click 'Renew DHCP Lease'
  • Windows - open Command Prompt or PowerShell and execute 'ipconfig /renew'
  • Linux - open terminal and execute 'sudo dhclient -r' to release current lease and 'sudo dhclient' to obtain new lease. Note that solution might vary based on distribution
If popup indicating connection appears on all instances but disappears and connection still does not get established:
  1. Try changing 'Communications Port' in 'Virtual Switch' settings to any unused port
  2. Try restarting all instances of Cursr manually before reattempting to connect the instances
If none of the above help, please report the issue.
If another application is launched using Administrator privileges, it can prevent other applications (like Cursr) running without Administrator from receiving information about system events like mouse movement, which is necessary for functionality of Cursr. Applications like Task Manager runs as admin by default when possible without asking user for elevated access even if user is not an Administrator.

If you require Cursr to work while another application with Administrator access is open/focused, you can simply close Cursr, right-click on Cursr launcher and select 'Run as administrator'.
Some games or applications may not be compatible with default 'Source' keyboard layout option in Cursr. Go to 'Settings > Virtual Switch' and set 'Keyboard Layout' to 'Current'.

If that does not help, please report the issue.
© Copyright 2024 Bitgapp Ltd. All rights reserved.