Frequently Asked Questions

First, to access the free 7-day trial you’ll need to create an account by logging in on the Cursr website. Free 7-day trial is available even if you already have a license.

A free 7-day trial for up to 4 devices is available instantly on a “no questions asked” basis for accounts that agree to verify identity by adding a payment method. No payment will be taken during the trial or when it ends — the payment method is used solely to help reduce free-trial abuse.

Don’t want to add a payment method, or need to test Cursr on more than 4 devices? You can still request a 7-day trial by clicking on 'Request Custom Trial' in your account page and filling out a request form. Requests are reviewed on a case-by-case basis.
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
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 unused versions may be 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.
Because Cursr monitors and controls mouse movement (and, in KVM mode, keyboard input), it can conflict with other apps or built-in features (such as macOS Universal Control and Windows 11 'ease mouse movements' option for displays) that also monitor and control input.

Which applications may conflict with Cursr?
  • Other KVM software - If two KVM tools run in the background at the same time, they can interfere with each other’s input handling and calculations.
  • Other multi-monitor cursor tools - These may also run in the background and compete with Cursr’s cursor management.
  • Apps that "consume" mouse/keyboard input (for example, VMware) - If an app captures input exclusively, Cursr may not receive those signals. Cursr will usually work normally as long as that app’s window isn’t active.
Another application not working as expected while Cursr is running?
  • Game camera issues - Use Cursr’s Auto-Disable feature by adding the game to the Auto-Disable list so Cursr automatically disables custom transitions while the game window is active.
  • Keyboard not working in game - If you're using keyboard through Cursr KVM to play games, set the keyboard layout to 'Local' in 'Settings → Virtual Switch' on the device game is running on.
  • Windows KVM: mouse stops responding or you can’t click inside a specific app - That app is likely running with elevated (admin) privileges while Cursr is not. Run Cursr with elevated privileges too. To allow Cursr to start with elevated privileges from start disable 'Launch on startup' in settings, then create a scheduled task in Windows Task Scheduler.
Still experiencing issues? Proceed with the next steps in the help center.
If you’re using KVM, whitelist UDP 28777 (device discovery) and UDP + TCP 4440 (communication). These ports are configurable in Settings → Virtual Switch (note: versions before v1.7.3-prerelease.9 used discovery port 61650 by default, so if you installed Cursr using this or older version, the discovery port, unless manually changed, will be 61650). If you’re not using KVM on a device, you don’t need to whitelist any ports.

For domains, whitelist based on your needs:
  • github.com (specifically github.com/bitgapp/Cursr) — for auto-updates or update notifications
  • api.cursr.app — for signing in on cursr.app and automatic in-app license metadata refresh
  • cursr.app — to access/manage your online account and licenses on the secured network
  • Stripe domains — only if you need checkout, purchases, or payment method management on the secure network (all other licensing data is handled via api.cursr.app)
KVM - Connection Issues Between Devices
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, if everything looks correct sometimes it also helps to switch between the Private and Public setting and back to reapply the firewall configuration. Alternatively to avoid unnecessary search of individual firewall rules you can also temporarily disable firewall (not recommended on Public network) to check if it will help, before tracking down individual rules causing the issue.

Afterwards, make sure UDP and TCP ports used by Cursr are not occupied or reserved (Default values for 'Coms' UDP/TCP=4440 and 'Discovery' UDP=28777 (61650 for v1.7.3-prerelease.8 and earlier) ports can be changed in settings):

macOS:
  • Check occupied TCP:     sudo lsof -iTCP -sTCP:LISTEN -nP | grep :4440
  • Check occupied UDP:    sudo lsof -iUDP -nP | grep -E ':(4440|28777)'
Linux:
  • Check occupied TCP:     netstat -tln | grep :4440
  • Check occupied UDP:    netstat -uln | grep -E ':(4440|28777)'
Windows:
  • Check occupied TCP:     Get-Process -Id (Get-NetTCPConnection -LocalPort 4440).OwningProcess
  • Check occupied UDP:    Get-Process -Id $(Get-NetUDPEndpoint -LocalPort 28777, 4440 | Select-Object -ExpandProperty OwningProcess -Unique)
  • Check reserved TCP:      netsh interface ipv4 show excludedportrange protocol=tcp
  • Check reserved UDP:     netsh interface ipv4 show excludedportrange protocol=udp

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 running 'curl IP_OF_DEVICE_YOURE_CONNECTING_TO:4440/status' [for version older than 1.7.3-prerelease.9 - 'curl IP_...:4440'] between the devices. If it succeeds you should see 'Cursr is running!' [Or 'curl: (52) Empty reply from server' for versions older than 1.7.3-prerelease.9], if it takes too long and times out then it's likely that there is firewall blocking incoming connections on the other device. (Example: If you have macOS and Windows device, you would run 'curl WINDOWS_IP:4440' in macOS Terminal)
  2. macOS: Make sure that Cursr is allowed to find and communicate with devices on local network by enabling this setting in 'Privacy & Security' settings under 'Local network' permissions. Sometimes even if this permission is granted it may not work until you restart the app and macOS shows a popup again asking for permission to allow Cursr to use local network. If the popup does not show but you still see errors like 'EHOSTUNREACH' when trying to connect from macOS device, toggle the 'Use Alternative TCP Library' in General settings and restart. When you grant the permissions it should start working and for some time you may see duplicate instance of Cursr in 'Local Network' settings.
  3. Try changing 'Communications Port' in 'Virtual Switch' settings to any unused port
  4. Try restarting all instances of Cursr manually before reattempting to connect the instances
If none of the above help, please report the issue.
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.
If you encounter issues with a newly created license showing in-app status "Invalid Time" or appearing valid but generating a warning about invalid licenses when connected to other devices, please check the system clock on the device displaying the warning.

It's essential to ensure that this device's clock is accurately set to the correct time, as discrepancies can cause license validation problems. Adjust the time settings to reflect the true current time, and this should resolve the issue.

If that does not help, please report the issue.
If you added a process path to Auto Disable but Cursr is not disabling the transitions between linked displays (excluding transitions controlled by OS as these will not be affected) you can try the following options:
  • Keep Cursr open on the side (or if you have single display, enable 'Top Most Window' options in Cursr General settings) and click into the process you want auto-disable to work with, check Cursr and confirm if in-app message says that transitions are disabled
  • If the app indicates that transitions are disabled, but the mouse still moves in unexpected ways and it's not caused by the OS, report this issue to [email protected] and if possible provide a screen capture or video of the issue
  • If you don't see any indication that transitions are disabled, remove the path you added, make sure that the process is open and add process path from the 'Select from Available Windows' dropdown. This will ensure that correct path is used. Some applications may open a new window under new process with what may sometimes look like an unrelated or not very meaningful name, so if it's still not working, look for any other unidentified process names in the dropdown list and try adding them to auto-disable, then click into the window you want the auto-disable to work with and see if Cursr is now automatically disabled
If Cursr shows that transitions are disabled but randomly they get re-enabled, please check that you're not using any keyboard shortcuts that may trigger active/focused window change. This can often happen on Windows if 'Win' key is pressed by accident causing the window for which auto-focus is enabled to lose focus therefore Cursr re-enables the transitions between displays. Current solution is to avoid pressing these keys/shortcuts or to rebind them to something else. A better solution from Cursr may come in future, if you have any thoughts or ideas about this, you can share this on Cursr socials or send email directly to [email protected]
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.
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'.
If you just installed Windows on your device and Cursr is not opening on the new system, check if you have any pending Windows updates and install them. After restart Cursr should open as usual.
© Copyright 2026 Bitgapp Ltd. All rights reserved.