This documentation refers to ShareMouse v6 beta. The documentation for production version 5 is available here.

Installation

ShareMouse is available for Microsoft Windows and Apple macOS and needs to be installed on all computers.

A regular, local network connection is used by ShareMouse to transmit the mouse cursor movements and keyboard input. ShareMouse does not work over the internet.

We recommend to use a cabled Ethernet network connection as wireless connections are prone to temporary drop-outs due to radio interferences or reception issues.

Windows installation

Video tutorial

To install ShareMouse on a Windows computer:
  1. Download and double-click the installation file.
  2. Follow the on-screen instructions.
  3. Repeat the installation on all computers you wish to link with ShareMouse.
  4. If you already purchased a license key, register the license key on one(!) of the installations.

The installation requires administrative rights. If you cannot obtain admin rights on your computer, you can run ShareMouse without admin rights with the portable edition

Windows service

ShareMouse installs two Windows services with following benefits:

  • Remote control of secured UAC-dialogs.
  • Remote control between applications running with different access rights (admin vs. user rights).
  • Sending of CTRL+ALT+DEL to a remote PC.
  • Synchronize remote login/lock and shutdown.
  • Optional automatic software updates

The ShareMouse client appends "(service)" to the program name to indicate that it has been launched by the ShareMouse service

The ShareMouse service is not available in portable mode as it requires an installation on the guest computer.

If you need to restart ShareMouse with the service installed, you need to restart the ShareMouse service, not the regular program file (video tutorial).

Installation without admin rights

Video instructions

If you cannot obtain admin rights for the installatiokn:
  1. Instead using the regular installation program, download the portable edition.
  2. The portable edition is a ZIP archive file. Extract its content anywhere on your hard drive.
  3. Launch the program from there.

The portable edition does not include the ShareMouse Windows service.

Portable mode

If you want to use ShareMouse temporarily in different environments, e.g. a freelancer working in a client office, you can run it from an USB memory device:

  1. Download the ShareMouse Portable Edition ZIP file.
  2. Extract the ZIP file contents into any folder of the USB device.
  3. Double-click the program file "ShareMouse.exe" located in the program folder on the USB device.

ShareMouse automatically enables portable mode if being launched from a USB stick. If USB device detection fails, you can force portable mode by launching ShareMouse with command-line parameter -portable (video instructions).

In portable mode, ShareMouse does not write any files onto a guest computer.

  • Shut down the program before unplugging the USB device to prevent losing program settings changes.
  • In portable mode, ShareMouse cannot install/use the ShareMouse Windows service.

MacOS installation

To install ShareMouse on a Mac:
  1. Download the Mac installation file.
  2. Double-click the setup program to open the installer.
  3. Drag the ShareMouse icon from left to right into the application folder:

  4. Repeat the installation on all other computers.
  5. Apply following important settings:

Important macOS system settings

MacOS does not allow 3rd party apps to access system functions without manual approval for security reasons. This is a very good thing as you become aware which system functions an app is accessing on your Mac.

ShareMouse works on a system-level and must be granted access to a selection of system functions:
  1. Open the macOS System Preferences:

  2. Switch to section "Security & Privacy":

  3. Click the "Privacy" tab, unlock the padlock in the lower left. On the left, click section "Accessibility" and add ShareMouse to the list of programs (Video tutorial):



    Reason: The accessibility option allows ShareMouse to read your mouse and keyboard input to transmit it to the remote computer.

    Important: Never uncheck this option while ShareMouse is running. Exit ShareMouse first before unchecking this option. Otherwise, the system locks up and you need to reboot your Mac.
  4. On the left, click section "Full disk access" and add ShareMouse to the list of programs:



    Reason: ShareMouse allows you to drag & drop files and to synchronize the clipboard between computers which requires that ShareMouse can write to your harddisk.

ShareMouse never stores or transmits your files and/or mouse/keyboard input over the internet (see our privacy policy).

MacOS seem to want you reconfirming these settings with every ShareMouse update.

Solution: Exit ShareMouse (important!), uncheck and check above settings again for each ShareMouse software update.

The macOS security & privacy database seem to be unstable at times. To perform a reset of Accessibility settings (of all Apps!), use command "sudo tccutil reset Accessibility" in the macOS Terminal App.

Make sure to exit ShareMouse - Otherwise mouse clicks may get blocked and a Mac reboot would be required: Press the power button for a couple of seconds to perform a system reset. In some cases, you would need to delete the ShareMouse and manually add the ShareMouse entry again using the + button.

Upgrade

Newer ShareMouse versions can be safely installed over an existing installation. Settings will be preserved.

If you renewed an expired maintenance, deregister the old license key from the installation and register the new license key.

Make sure to update/upgrade ShareMouse on all computers. Do not mix different ShareMouse versions.

MacOS may require to uncheck and check again the macOS security settings.