cgminer for Mac OS X

Maintained by Kerry Cupit (http://spaceman.ca/cgminer)

This program is distributed under the terms of the GNU GPL v3
This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free
Software Foundation, either version 3 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

Cgminer for Mac OS X is a set of pre-compiled binaries of cgminer that should run on Intel or PPC Macs, running OS X
10.5 through 10.9. Cgminer is a cutting-edge bitcoin mining software package. More details on cgminer can be found
here: https://bitcointalk.org/index.php?topic=28402.0
I maintain these binaries on a voluntary basis, and I enjoy doing so. I have incorporated these binaries into my own miner
called Asteroid, which is a super-easy Mac-friendly miner, which I suggest you consider checking out at
http://www.asteroidapp.com/
I do not troubleshoot nor modify the cgminer source code, and I am not affiliated with the original developers of cgminer. I
merely pre-compile their publicly available source code, package it with pre-compiled binaries, make them universal
binaries and make them available for the Mac community.

Installation:

No special steps necessary. Just drag-and-drop anywhere you want to keep it. Also works from locked volumes.

FAQ:

Q: No USB devices are found and/or I'm getting "incorrect device" errors, but they're plugged in and everything
should be good!
A: You may have conflicting USB drivers installed on your machine. cgminer does not require any additional drivers of any
sort. Mac OS X 10.9 Mavericks unfortunately includes a conflicting USB driver by default though. But you can disable all
known conflicting USB drivers with the following command in Terminal:
sudo kextunload -b com.silabs.driver.CP210xVCPDriver; sudo kextunload -b com.silabs.driver.CP210xVCPDriver64;
sudo kextunload -b com.FTDI.driver.FTDIUSBSerialDriver; sudo kextunload -b com.apple.driver.AppleUSBCDC;
sudo kextunload -b com.apple.driver.AppleUSBCDCACMData; sudo kextunload -b
com.apple.driver.AppleUSBCDCACMControl; sudo kextunload
/System/Library/Extensions/IOUSBFamily.kext/Contents/PlugIns/AppleUSBFTDI.kext
This will temporarily disable these conflicting drivers. To re-enable them, simply log out and back in, or restart your
machine, or enter the following into Terminal:
sudo kextload -b com.silabs.driver.CP210xVCPDriver; sudo kextload -b com.silabs.driver.CP210xVCPDriver64; sudo
kextload -b com.FTDI.driver.FTDIUSBSerialDriver; sudo kextload -b com.apple.driver.AppleUSBCDC; sudo kextload
-b com.apple.driver.AppleUSBCDCACMData; sudo kextload -b com.apple.driver.AppleUSBCDCACMControl; sudo
kextload /System/Library/Extensions/IOUSBFamily.kext/Contents/PlugIns/AppleUSBFTDI.kext
You will also be prompted for your Mac's username and password to each time.
Q: I'm uncomfortable with the Terminal and command-line interfaces, there must be an easier Mac-like way.
A: Yes! Multiple people have released their own graphical user interfaces (GUIs) to cgminer. Asteroid is my favourite
(http://www.asteroidapp.com/) since I made it myself. Others can be found here: https://bitcointalk.org/index.php?
board=42.0

Q: cgminer cannot detect my graphics card (GPU)

A: cgminer no longer supports graphics cards (GPUs) for mining. If you wish to mine with your GPU, please download
cgminer 3.7.2, as this was the last version with GPU support.
Q: cgminer crashes right away
A: If cgminer crashes, it could be due to a number of different reasons. It could be that your specific graphics card is not
fully supported or is of an older variety. If cgminer crashes after attempting to connect to a pool, try a different pool. Also,
try googling the error to see what others have tried.
Q: My keyboard / trackpad on my MacBook stops working
A: This shouldn't be happening, please let me know if you see it (my email can be found at spaceman.ca). You can
temporarily work around this problem by adding "--hotplug 0" to your command-line options. With this option set, cgminer
will not automatically detect USB-based miners as you plug/unplug them (you will have to plug them in before you start
cgminer, in other words).
Q: I found a bug
A: If it is a bug with the launcher script or you see errors related to "dyld", then report them to me directly. My email
address can be found at spaceman.ca.
If it is a bug with cgminer, report the problem on the official cgminer forum thread here: https://bitcointalk.org/index.php?
topic=28402.0
Q: I have a suggestion / feature request
A: Post it to the official cgminer forum thread here: https://bitcointalk.org/index.php?topic=28402.0
Please note that, in general, no one is paid to work on cgminer and it's various distributions. Therefore you will be asking
volunteers to spend time accommodating your request. Requests that are succinct and (hopefully) applicable to many

users will have the best chance of being implemented. You can also donate to further encourage the authors to work on a
specific feature for you.
Q: I'm interested in what license your software is released under.
A: My launcher is released under the GNU GPL v3 (http://www.gnu.org/licenses/gpl.html). Licenses for each of the
included binaries are different, and are included in the app bundle. Source code for cgminer and the packaged libraries
(curl, jansson and libusb) can be found from the following websites:
https://github.com/ckolivas/cgminer (cgminer)
http://curl.haxx.se (curl)
http://www.digip.org/jansson/ (jansson)
https://github.com/libusbx/libusbx/tree/v1.0.16-rc1 (libusb)
Q: I want to see the source code to your launcher.
A: The source code to the launcher is included in the app bundle. Rght-click on "cgminer for Mac OS X.app" and choose
"Show Package Contents". You will find the source code here: Contents/Resources/Scripts/main.scpt
Q: None of these FAQ's are actually questions.
A: Really?