NOTICE: DTN currently recommends the use of third-party product CrossOver, for users who need to launch IQFeed on a non-Windows operating system. Click Here for instructions. (The current version of CrossOver does not support the Big Sur beta operating system. If you upgrade to Big Sur, you will not be ablet o use the CrossOver solution.)

This page is for users who may have previously installed IQFeed using Wine, or do not wish to use CrossOver.

The beta version of IQFeed will only upgrade the main application (which allows 3rd party apps like MotiveWave to use the feed) and SnapQuote (one of our display apps) to 64bit so only those pieces will run on Catalina. Please contact Support if you need help.

Overview

DTN IQFeed is a windows application. It can’t be used natively in a non-Windows operating system without a dual-boot setup, or a program that enables this. You can use Wine for this purpose.

Installation Intructions

  • macOS Snow Leopard (10.6.3) or later
  • XQuartz 2.7.11 or newer – This is required by Wine.
  • Wine (any version, but we recommend the latest Wine Stable package).

If you have already installed any of these, there is no need to re-install them, you can skip those sections. If you do not have them, or if you wish to update them to current versions, follow the instructions below to install:

Before beginning this process, be aware of the following:

  • If you installed a version 6.0.0.5 of IQFeed or earlier  (using the old WineBottler DMG file), you must uninstall IQFeed before proceeding with the below instructions.
    • If you have any saved Watchlists in IQFeed, they can be brought over to the new location. Watchlists are saved in .WAT files. Just navigate to wherever the .WAT files are saved and put them in a safe location. Then, after the new install is complete, you can open the watch files from that location, or move them wherever you want to store them.
  • MotiveWave users will need to manually launch IQFeed before entering MotiveWave. The MotiveWave functionality to automatically launch the feed will not work properly.
  • If you have Mac Catalina, you must download the Beta version.If you have Mojave, and don’t plan to update to Catalina, you may download the release version.
  • SnapQuote is the only IQFeed app that will work in the Beta version. The others are not yet updated to 64bit, though this will occur in a future release.

  • Go to The XQuartz Homepage
  • Download latest .DMG file.
  • In your browser’s download area or the Downloads folder, double-click the .DMG file.
  • Double-click XQuartz.pkg to begin the installation.
  • Follow the prompts in the install program. Grant any permission that is requested.
  • You may get a message “you must log out and back in to make Quartz your X11 server.” Disregard this message.

  • Go to The Wine Downloads page on winehq.org for macOS.
  • Click Installer For Wine Stable link at the top. This will download a .PKG file to your system.
  • Double-click the .PKG file to begin the installation.
  • Follow the prompts in the install program. Grant any permission that is requested.
    • You may get messages that wine-mono and Gecko packages are missing. Install them.
    • Use the “Install For All Users” option, unless you have a specific reason for doing otherwise.
    • Check the box to enable 64-bit support. (You may not be able to disable 32-bit support, but this is OK)

If you are installing IQFeed under Wine for the first time, follow the steps in this section. If you have a previous IQFeed install using wine, you can try these steps but if you run into errors, see our troubleshooting section below.

  • Go to The IQFeed Download page and click Download to download the latest .EXE file.
    NOTE: the command in Step 3 assumes you have downloaded this to your Downloads directory for the current user. If this is not the case, you will need to adjust the path in Step 3 accordingly.
  • You must install IQFeed using the Terminal app in macOS. To do this:
    • Launch the Terminal app from the Utilities (Shift + Command + U).
    • Type the following text into Terminal:
      /Applications/Wine\ Stable.app/Contents/Resources/wine/bin/wine64 downloads/iqfeed_client_6_1_1_7.exe
      NOTE:  Change 6_1_1_7 to the version number you downloaded. Spacing and capitalization must match exactly as above! There is a space (not an underscore) between Wine\ and Stable.app and also a space between wine64 and downloads.
  • The Windows install process will begin. Install IQFeed as a normal Windows install.

Ideally you will not need to launch IQFeed yourself because the software you are using with IQFeed should launch IQFeed for you. However, we understand there will be times that you need to manually launch IQFeed for whatever reason. For this purpose, we have provided a terminal shell script to accomplish this. You can find this shell script in your User directory under the filename iqconnect.sh. You can run this script either from the terminal or from the finder and you will be prompted with the IQFeed login screen to enter your IQFeed authentication credentials. You will then need to launch another app (one of the included IQFeed display apps or a 3rd party app) to provide the application credentials IQFeed needs before you will be able to connect.

  • Using Terminal
    • Launch the Terminal app from the Utilities (Shift + Command + U).
    • Type ./iqconnect.sh and hit enter/return. The IQFeed Login screen will appear. You can enter credentials now but the Connect button will be disabled.
      • At this point, you can launch your 3rd party app and skip to the last 2 steps unde Using Finder or you can use one of our display apps by continuing with the next step.
    • Locate the IQFeed icon in the status menu and secondary-click (both fingers) on it. A menu will appear.
    • Select “Display Apps” from the menu. A sub-menu will appear.
    • Select the application you wish to use (SnapQuote is recommended if you are unsure).
    • Navigate back to the IQFeed Login window and you should now be able to connect.
  • Using Finder
    • Open Finder
    • Navigate to your Home directory (Shift + Command + H)
    • Control-Click iqconnect.sh and choose Open With. If Terminal is in the list, choose it and move on to the next step. Otherwise choose Other…,
      • A Finder window will appear. Enable All Applications.
      • Navigate to the Utilities and select Terminal.
    • The IQFeed Login screen will appear. You can enter credentials now but the Connect button will be disabled.
      • At this point, you can launch your 3rd party app and skip to step 7 or you can use one of our display apps by continuing with step 4.
    • Locate the IQFeed icon in the status menu and Ctrl-Click on it. A menu will appear.
    • Select “Display Apps” from the menu. A sub-menu will appear.
    • Select the application you wish to use (SnapQuote is recommended if you are unsure).
    • Navigate back to the IQFeed Login window and you should now be able to connect.

NOTE: If you are an API customer writing your own application to interface with IQFeed, please check the IQFeed API documentation page for initializing the feed

FAQ's

Wine is a technology that lets you run Windows programs within macOS. More technically, the makers of Wine describe it as “a compatibility layer capable of running Windows applications on POSIX-compliant operating systems”, which includes macOS. For more information, see their website at winehg.org.

Unfortunately, DTN can no longer offer the WineBottler install of IQFeed. To make IQFeed work on a macOS, you must install Wine and run IQFeed under Wine.

It is a prerequisite of Wine.

No. But it is advisable to ensure you are on the latest version of XQuartz/Wine and update if necessary.

No. You may download, install and run IQFeed under Windows. The installation process is the same as for any Windows computer.

On previous IQFeed versions, through 6.0.0.5, we used a package manager called WineBottler to package Wine and IQFeed into a single, standard macOS dmg installation file. Due to conditions outside of our control, this package manager no longer works for our installations.

As of version 5.0, wine isn’t 100% Catalina compatible yet (it’s close and good enough for out needs, but not 100%0/ The application icon that gets created in the Applications folder still launches the 32bit version of Wine even when 64bit support is installed. This is also why DTN had to update the instructions to use Terminal.

Troubleshooting

  • In this scenario, it depends on which version of IQFeed you have and/or how Wine was installed to determine what steps to take.
    • If you have IQFeed Version 6.0.0.5 or older that was installed using the IQFeed Client dmg (WineBottler version), you will need to uninstall this version by dragging the icon from the Applications folder to the trash.
    • If you have a version of IQFeed installed using standalone Wine (similar to above instructions) you may need to delete and recreate your WINEPREFIX directory on your machine.

  • This happens if you have previously installed IQFeed with a Wine installation that didn’t include 64bit Wine support. When you attempt to install 64bit IQFeed using a 32bit WINEPREFIX, you will get this error.
  • macOS will block certain apps that are not distributed through the app store. In this scenario, you have to create an exception for the application in your system preferences to allow the app to install. Once the app is installed, you should not have to do anything further.
    • Go to System Preferences
    • Open Security & Privacy
    • From the General Tab, you should see the Wine of IQFeed installer file you downloaded
      • Click Open Anyway

Tthat means you have a mismatched version of macOS and IQFeed. You are trying to do one of the following.

    • Install 32bit IQFeed on a 64bit macOS (Catalina or newer)
    • Install 64bit IQFeed using 32bit Wine on macOS (Mojave or older)

  • The first step is to re-install Wine to get 64bit support. If you still have the original package you used to install Wine, you can run it again and check the box for 64bit support.
  • If you do not have any other software that uses Wine, you will need to remove your current 32bit WINEPREFIX.
  • If you do have other software that uses Wine (or if you aren’t sure) you can skip this process and follow the instructions below for having multiple WINEPREFIX installed.
    • A WINEPREFIX is simply a hidden directory on your machine that simulates the windows file system directory structure. To remove it,  you simply delete the directory
      • Open Finder
      • Press Shift + Command + H to open your home directory
      • Press Shift + Command + “.” (period) to show hidden files / folders
      • Locate the Wine directory and drag it to the Trash
      • Press Shift + Command + “.” (period) to hide hidden files / folders

  • To install IQFeed insto a new WINEPREFIX, you need to follow the steps outlined for installing IQFeed above except you will put WINEPREFIX=~/.wine64 in front of the command to launch the IQFeed installation as follows:
    • WINEPREFIX=~/.wine64 /Applications/Wine\ Stable.app/Contents/Resources/wine/bin/wine64 downloads/iqfeed_client_6_1_1_6.exe