Scanning from an Apple Mac
Posted by Sinclair Hughes, Last modified by Sinclair Hughes on 18 July 2022 11:50 AM

Apple do not recognise or use TWAIN drivers to interact with scanners that are used with their Mac Book computers, so it takes a few more steps to get the scanning options configured and also to complete the scanning workflow.

A short tutorial video displaying the workflow sequence to scan a document, is available from this location


  1. Install the ICA driver for the scanner on the Mac.  Test by using the Apple 'Image Capture' app.
    If the driver doesn't install check that you have sufficient permissions.
    If there is no ICA driver then the following steps will not work and you will have to scan the documents separately then attach, using the Message Centre feature.
  2. Install (or update) the latest TSscan client app (for MacOS) on the computer that is connected to the scanner (
    1. Open the app (Finder > Applications) and select 'Options'.  Then check ON the 'Redirected folder' option.
  3. Go to Preferences in Microsoft Remote Desktop and in the Redirected field, enter in the path to the ...Documents\TSDataDrive 


  1. In the Incisive application, go to Patient > Notes > Scan.  
    1. Choose 'TSScan' as the scanner
    2. Open the 'Advanced' section and check ON the 'Use Shell Scanning' option.  This must be enabled.
      You may also want to enable 'Save Automatically', 'Use Document Feeder' and 'Reverse Background' (if they appear as white text on black).

  2. Click on the 'Scan' button
    If this is the first time using TSscan, a TSscan window may appear.  Select the Tools menu and choose the 'Switch to Mac UI', then close it.

    If the above screen doesn't appear, just let it continue as it is already set to use the Mac UI.

  3. Apple's 'Image Capture' app will then appear.
    1. Select the scanner in the left-hand panel
    2. Choose configuration options in the right-hand panel.
      1. 'Text' quality is usually sufficient.  If you use Colour it will significantly increase the size of the image file.
      2. Set the 'Scan To' directory to be the same as the directory selection in point 3. of Configuration above (Microsoft Remote Desktop > Preferences
      3. Choose 'TIFF' as the format and check ON the option to 'Combine into a single document'.
      4. Select 'Scan' to start the scanning process
      5. When the scanning has completed, choose 'Finish' to close Image Capture and pass the image to the Incisive application.
    3. The TSscan application will then upload the scanned image to the remote server.

      Wait until the 'Completed' image appears.  The speed of how long this takes is dependent on your internet Upload speed

  4. If the 'Save Automatically' option is not checked On, click on the button in the Incisive application to Save and either continue scanning or Exit

If this scanning process does not work for you, then scan the documents separately to a folder and import them to the patient's records using the Message Centre import feature.