NOTE: Please contact your Adoption Specialist to obtain the latest Fluency Direct MacOS installer pkg file or download from https://fluencydirect-distro.s3.amazonaws.com/releases.macOS/Latest.html

  1. System Requirements
    • MacOS Catalina (version 10.15), Big Sur (version 11), Monterey (version 12), Ventura (version 13) and more recent are supported by the latest versions of the Fluency Direct MacOS Client.
    • MacOS High Sierra (version 10.13) and Mojave (version 10.14) are supported but are limited to Fluency Direct MacOS Client version 11.0.3.90.
    • Fluency Direct MacOS Client version 11.0.3.90 or higher is needed for customers using a web based EMR.
    • 4GB of memory
    • 500 MB of available storage
    • Internet Connection
  2. All Fluency Direct for macOS users should already have a valid Fluency Direct User ID and password. You should make note of the following needed information from your current Windows install before proceeding with a macOS install.
  3. Username: ______________________________________

    Password: ______________________________________

    Base endpoint (CDS URL): ____________________________________________________________________________

    Location (CDS account): ______________________________________

    Once you have signed onto Fluency Direct for Windows you can obtain the above information from System Check.

  5. If you are installing Fluency Direct on a MacBook (laptop), it is very likely that laptop does not support USB A connector used by the Olympus, Philips or other microphone you already own. The MacBook likely only supports USB C ports. In this case you will need to purchase a USB A to USB C Adapter or use the M*Modal Mobile Microphone.

    USBCSupport
  6. Please contact your Adoption Specialist to obtain the latest Fluency Direct macOS installer pkg file.

  7. Once downloaded, double-click on the "MModal Fluency Direct" pkg file. PKG files are macOS installation (setup) packages that contain installer scripts and compressed installation files that are used to install Mac software applications onto a user's hard drive. The MModal Fluency Direct PKG file can act as both an upgrader to previously installed versions of M*Modal Fluency Direct and an original installer.

    image002
  8. Walk through the installer by selecting “Continue” and then “Install”

    image003InstallerDestinationimage005
  9. When prompted, enter the password for the current macOS user (this is NOT your Fluency Direct password, but the password you use to access your mac) to supply the Installer with sufficient rights to complete the install\upgrade process.

    image007
  10. Select “Close” when the install is complete.

    image009
  11. When prompted, you can optionally move the original pkg file to the trash.

    image011
  12. M*Modal Fluency Direct can be found in the applications folder . You can Launch by using a single click on the icon.

    image013
  13. Once launched for the first time after an install or upgrade, you will need to give Fluency Direct permissions to use the macOS Accessibility API. The Accessibility API is used for dictating into native macOS applications such as Safari, Notes and macOS specific EHRs. Open System Preferences when prompted.  You should not see this prompt again, unless you upgrade Fluency Direct,

    image015You will need to unlock via “click the lock to make changes” and present your password again when prompted. The system is NOT asking for your Fluency Direct password, but the password you use to access your mac.

    image017Once unlocked, select the checkbox next to “M*Modal Fluency Direct”. You can close this screen once this is done. You should only need to do this after initial install\upgrade.

    image019
  1. When prompted give permission to use the keychain storage. Make sure you specify "always allow". This is used so that Fluency Direct can remember your credentials and you don't need to type them in every time you launch Fluency Direct. Use the password for your current account macOS. The system is NOT asking for your Fluency Direct password, but the password you use to access your mac. You should not see this prompt again, unless you upgrade Fluency Direct,

    KeyChain
  2. If you are using macOS 10.14 (Mojave) and above,  you will have an additional prompt to allow the application to grant access to your microphone. The system is NOT asking for your Fluency Direct password, but the password you use to access your mac. You should not see this prompt again, unless you upgrade Fluency Direct,
  3. Once Fluency Direct is launched. Shift+ Click on the Fluency Direct Control Bar to launch the “Advanced Sign In” dialog to make sure Fluency Direct is pointing to the correct Base Endpoint and Location. 

    image021Make sure that username, password, base endpoint and location are correct. 

    The base endpoint (CDS URL) and location (CDS account) should have been written down as part of Step #1 above. 

    Assuming all of this information is defined correctly. This will allow Fluency Direct for macOS to share information with Fluency Direct for Windows by sharing the same speech profile.

    image022You should only need to do this step one time after install\upgrade (at least during the program). Once you have successfully signed in once via the “Advanced Sign In” after install\upgrade the base endpoint and location values should be remembered by Fluency Direct. You will only need to type in the username and password moving forward by using a single click on the control bar.

    image024
  4. If this is the first time you are installing Fluency Direct on your macOS device, Fluency Direct might need to download a recognizer before you can start using the system. A recognizer is the data the system needs in order to translate speech into text. Be patient this can take up to 5 minutes. Once the download is complete you should be able to do speech recognition.

  5. At this time, the macOS client for Fluency Direct does not have full parity with the Windows client. 

    • Only local recognition is supported
    • CAPD functionality (CDI-Engage, CDI-Engage One and HCC Engage) is not supported
    • Command Scripting is not supported.
    • Commands are cross platform, but care should be taken when developing commands with mouse actions since screen coordinates for the same application may be different across OSes.
    • Only support for the Citrix Connector exists. The Connection is not currently supported for Terminal Services and VMWare Horizon View.

Installing the Fluency Direct macOS client at home

The Fluency Direct macOS client can be installed on personal devices for users to use in the office or at home. When using Fluency Direct client for macOS, the same user profile is available to users on macOS as they would normally access on Windows. When using either client, command, dictionary abbreviation and formatting changes are saved in a central place and are available to both the macOS and Windows Client on any device. Some things to note before you install the macOS client.

  • If you are accessing your EHR via Citrix, make sure the Citrix Workspace App is installed before you install Fluency Direct. You can obtain the latest Citrix Workspace App at https://www.citrix.com/downloads/workspace-app/mac/workspace-app-for-mac-latest.html
  • If you are accessing your EHR via Google Chrome, make sure you have installed the Fluency Direct Connector for Google Chrome. You can obtain the latest Connector at https://chrome.google.com/webstore/detail/mmodal-fluency-direct-web/phgddhgfnjjaobkeekohieahfingldac\
  • Unlike the Windows Client, the Fluency Direct macOS client is not organizational specific. You will need to obtain configuration information from either your organization or a working Windows install. Information on how to obtain the needed information from a Windows install can be found below.

  • Depending upon how your organization uses Single Signon Tools, the Password you use for Fluency Direct when accessing the system from a macOS might be different than in your organization. Its not uncommon for users to not know their passwords because of various auto-signon technology used at the hospital or office. While your user ID would be the same, you don't have access to the same single signon tools that are available via Windows and on your organization's standard devices. If you find that you do not know your password, contact your organization's IT department for a password reset.

  • If you find that the Fluency Direct Mobile Microphone application does not work, it is possible your computer's firewall is configured to block some types of outbound network traffic. You will need to assure that TCP port 8077 is not blocked. It is also possible, but less likely, that TCP port 8077 is blocked on your home router. You will need to consult your ISP or home router documentation to remedy this issue. If you find that you can not use the mobile microphone because of connectivity issues, we suggest you try either an onboard microphone, handheld microphone or headset.

  • 3M M*Modal is unable to provide direct support for personally owned computers. M*Modal works with customers to support computers, workstations and infrastructure that is under direct control of it's IT organization or contractors.