IQFeed for Mac Installation
NOTICE: 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
IQFeed is a windows application. As a result, we (DTN) utilize a 3rd party
application called Wine to run our Windows application on macOS.
We realize this is a less convenient approach than what we have used in the past and we are exploring options towards having
an integrated installer again. If you run into any issues or would like help walking through this installation, please contact
our Technical Support using the chat link to the left or call our support hotline.
Prerequisites
- 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 Starting
Before beginning this process, be aware of the following:
- If you installed a version of IQFeed earlier or including 6.0.0.5 (using the old WineBottler dmg file), this should be uninstalled 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. DO NOT SKIP THIS STEP. If you are unsure, please
contact our support group BEFORE uninstalling the previous version of IQFeed.
- MotiveWave users will need to manually launch IQFeed before entering MotiveWave. The MotiveWave functionality to automatically launch
the feed will not work properly.
Once we again have a integrated solution we will work with MotiveWave developers to streamline this process once again.
Installing XQuartz
- 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.
Installing Wine
- 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)
Installing IQFeed
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.
- 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_6.exe
NOTE: 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.
Manually Launching IQFeed
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 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 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 reccomended 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 Step 4. 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 reccomended 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
Q. What is Wine?
A. 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 winehq.org.
Q. Why do I need to install Wine to run IQFeed?
A. Unfortunately, DTN can no longer offer the WineBottler install of IQFeed. To make IQFeed
work on a macOS operating system, you must install Wine, and run IQFeed under Wine.
Q. Why do I need to install XQuartz?
A. It is a pre-requisite of Wine.
Q. I already have XQuartz and/or Wine, do I need to install them again? Do I need to install them each time IQFeed releases a new version?
A. No. But it is advisable to ensure you are on the latest version of XQuartz/Wine, and update if necessary.
Q. I have the Windows operating system installed on my Mac under Boot Camp. Do I need to install Wine?
A. No. You may download, install, and run IQFeed under Windows. The installation process is
the same as for any Windows computer.
Q. I use something other than Wine (e.g., Crossover) to run Windows programs under MacOS. Can I use that instead?
A. Yes, but DTN can only provide limited support if it doesn't work.
Q. What happened to the old WineBottler installer?
A. 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.
Q. Why does Wine show as disabled in Applications on Catalina?
A. As of version 5.0, Wine isn't 100% Catalina compatible yet (it's close and good enough for our needs but not 100%). 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 we (DTN) had to update the instructions to use Terminal.
Troubleshooting
I have an old version of IQFeed installed:
In this scenario, it depends on which version of IQFeed you have installed 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 the 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
When I try to install Wine or IQFeed, I get an error stating that it can't be opened
macOS will block certain apps that ate 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.
- Navigate to System Preferences
- Open Security & Privacy
- On the General Tab you should see the wine or IQFeed installer file that you downloaded listed there. Click Open Anyway.

When I try to install Wine or IQFeed, I get an error stating that it isn't supported on this system.
This means you have a mis-matched version of macOS and IQFeed.
You are trying to do one of the following:
- Install 32bit IQFeed on 64bit macOS (Catalina or newer)
- Install 64bit IQFeed using 32bit wine on macOS Mojave or older
When I try to install IQFeed, I get an error stating Bad CPU type in executable
This means you are trying to use the 32bit wine app on macOS Catalina or newer. You must use wine64 on these versions of macOS.
I only have 32bit wine installed, how do I install 64bit IQFeed?
The first step here is to re-install Wine to get 64bit support available. If you still have the original pkg you used to install wine, you can
run it again and make sure to check the box for 64bit support. Following that, if you do not have any other software that uses IQFeed, you will want 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 + . (that's a period) to show hidden files/folders.
- locate the .wine directory and drag it to the Trash
- Press Shift + Command + . to hide hidden files/folders again
I need to keep my existing WINEPREFIX. How do I install IQFeed into a new one?
To use install IQFeed into 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
|