SayIt on Mac Setup
  • 6 Minutes to read
  • Dark
    Light

SayIt on Mac Setup

  • Dark
    Light

The SayIt client is only supported on macOS Big Sur with Java 8.

Big Sur version 11.4 is the last macOS version nVoq will support.
If you are using SayIt on a Mac with remote desktop (RDP) to connect to a PC where your target application is running, we recommend that SayIt run in the RDP session and that you use one of the nVoq Wireless Microphone apps to dictate.


Step 1: Install the latest version of Java.

  1. Go to java.com and click the Java Download button to install the latest version of Java 8
    Mac-Java-download

  2. See Install Java on Mac for further instructions on installing Java. Then return to Step 2 on this page to continue installing SayIt.


Step 2: Create an application to launch SayIt.

After the upgrading to Java Version 8 Update 271 SayIt cannot access your microphone to record dictation. By following the instructions below you create a desktop application launcher which will allow SayIt access to your microphone, no matter what version of Java you are running.

  1. Launch the Script Editor application. 
    Script Editor is an Apple application that comes with macOS.
    1. Click the magnifying glass icon to open the search.Mac_Open-Spotlight-Search

    2. In the search window type script editor and then select the Script Editor from the list of applications.
      Mac-search-script-editor

  2. Create the script.

A new script document will open automatically. In the editor window, copy and paste the following script.

If you use the Healthcare system, your script would be:  
do shell script "javaws https://healthcare.nvoq.com/sayit/sayit.jnlp"
Mac-script-healthcare

If you use the Canada system, your script would be:  

do shell script "javaws https://canada.nvoq.com/sayit/sayit.jnlp"
Mac-script-canada

 

  1. Export the script as an application.
    1. Open the File menu and select Export.
      Mac-script-export
    2. In the window that opens, configure the following settings:
        Export As:SayIt Healthcare or SayIt Canada (depending on what system you need to access)
        This will be the name of your shortcut to the application.
        Where: Desktop
        This will be the location of your shortcut to the application.
        File Format: Application
        Code Sign:Sign to Run Locally YOU MUST SELECT THIS OPTION EVEN IF IT IS ALREADY SELECTED!
      Mac-M1-export-healthcare
    3. Click the Save button.
      Mac-M1-export-healthcare-save
    4. A shortcut is created on your desktop that launches SayIt on your preferred system.
      If you have any other shortcuts for SayIt from previous installations, delete them now
      Mac-launch-script-icon-healthcare  Mac-launch-script-icon-canada

  1. Close the Script Editor application.
    1. On the Script Editor Window, click the red Xbutton.
      Mac-script-close

    2. In the "Do you want to keep this new document...?" dialog box, press the Delete button.
      Mac-script-delete

 


Step 3: Connect your microphone.

For best results, use a microphone that has been approved (by nVoq) with the voice client. See Recommended Microphones for nVoq Dictation.

  1. If you're using a USB microphone, plug it in to the computer.
    plug-in-usb
  • Using a device that is not recommended for use with SayIt may result in poor audio quality, which results in poor recognition accuracy.  In other words, SayIt won’t understand what you’re saying and your transcripts will be inaccurate. See the Microphones Guide
  • Make sure your microphone is enabled and (if necessary) disable any extraneous microphones. See Enable Microphone for Mac.

 

  1. Check to see if you need to install software for your audio device.

 

 

Step 4: Launch SayIt and enable accessibility.

    1. Click the desktop shortcut created in Step 1 to launch SayIt. 
      You must always launch SayIt using this desktop shortcut.
      Mac-launch-script-icon-healthcare  Mac-launch-script-icon-canada
      If you have any other shortcuts for SayIt from previous installations, delete them now

       
    2. Java will launch.
      Mac-Java-launch

    3. On the "Do you want to run this application?" dialog box, check the box next to "Do not show this again..." so that this warning will not appear again, then click the Run button.
      Mac-SayIt-do-you-want-to-run-this-application

    4. An Enable Accessibility message tells you that SayIt requires Accessibility permissions. Click the Open Accessibility Pane button on the message.
      Mac-enable-accessibility-message-open-access-pane

    5. The Security & Privacy window should open with the Privacy tab already selected. 
      Click on Accessibility in the list of services on the left side of the window.
      Mac-Security-and-Privacy-open-Accessibility

    6. You need to allow the SayIt Healthcare (or SayIt Canada) app to control the computer, but the setting is locked (grayed out). Click the lock icon in the lower left corner of the Security & Privacy window to unlock the window.
      Mac-Accessibility-unlock

    7. You will be prompted to enter your password. Enter your computer password and click the Unlock button.
      Mac-unlock-security-and-privacy-password

    8. Put a checkmark in the box beside the SayIt application that you created in Step 2 (SayIt Healthcare or SayIt Canada).
      Mac-Accessibility-checkmark-healthcare

    9. Click the lock icon in the lower left corner of the window to lock the Accessibility screen again.
      Mac-lock-security-and-privacy

    10. Return to the Enable Accessibility message and now press the Ignore button so that you can proceed with the SayIt launch.
      Mac-enable-accessibility-message-ignore
    11. In the SayIt Sign In window enter your SayIt username and password (see your Welcome email or training information for your username and password) and click the Sign In button.
      Mac_SayIt_signin
      In most cases, you will be prompted to enter a new password the first time you log in.


    12. The client may download resources that are required to run certain types of shortcuts, if needed. While that's happening you will see a Loading message with a progress bar.
      Launch_DownloadResources-1 
    13. Once the resources have downloaded, the progress bar will disappear and the client will take a few additional moments to finish building and starting the resources so that you can use them.
      Launch_DownloadResources-2
    14. The first time you log in to SayIt the Microphone Setup Wizard (MSW) opens automatically. The MSW will set your recording volume level. Click the Next button to continue your way through the wizard.
      Mac-SayIt-MSW
    15. Select the microphone you will be using to record dictation in SayIt and then click Next. (The microphone that is highlighted is the one SayIt will use.)
      •  USB microphones must be installed BEFORE launching SayIt in order to appear in this menu.
      •   If you are using the nVoq Wireless Microphone, select "Wireless Microphone". 

         Do NOT select "Built-in Microphone". This is the internal microphone on your computer and will not give you good dictation accuracy.
      Mac-SayIt-MSW-select-mic
    16. The next screen will ask you to record some sample text. Press the dictation button on your microphone or the dictation hotkey(s) on your keyboard to record yourself reading the sample text out loud. 
      •  If you're using a headset microphone you will need to press the fn key with the F2 key to record audio unless you enable standard function keys (see Step 5 below).
      • If you're using the nVoq Wireless Microphone, press the microphone button on the Dictation screen of the app. Follow the instructions at Setup in SayIt (for iOS/Apple) or Setup in SayIt (for Android).


      The first time you attempt to record audio in SayIt, a dialog will open letting you know that your application would like to access the microphone. Click the OK button to grant access to the microphone.
      Mac-SayIt-MSW-access-microphone-message

      If you encounter an error at this step, make sure to click OK on dialog and restart SayIt by force quit if necessary.


    17. Once you've enabled the microphone, press the dictation button on your microphone or the dictation hotkeys on your keyboard and read the sample text out loud. Keep talking until you see the status bar say Completed. Then click Next.

    18. Click Finish to save your settings.
      MSW-5See Known Limitations of using SayIt with Mac.
       

      Step 5: Optionally, enable the standard Function Keys for SayIt.

      The dictation window displays the current hotkeys (by default, Dictation = F2, Voice Shortcut = F3, Popup Shortcut = F4).
      By default on a Mac you will need to press the fn key in combination with those F2 / F3 / F4 function keys. However, you can configure your Mac to use a single hotkey by enabling the standard function keys using the instructions below.
      This is recommended when using a headset microphone.
      If you have a Mac with Touch Bar, see Enable Standard Function Keys on Mac with Touch Bar.
       
       
  1. Open System Preferences.
    Mac-open-System-Preferences
  2. Open Keyboard.
    Mac-system-preferences-keyboard 
  3. Click Keyboard.
    Mac-Keyboard-keyboard-tab
      
  4. Put a checkmark next to Use all F1, F2, etc. keys as standard function keys.
    Mac-Keyboard-enable-function-keys