0 0
Read Time:2 Minute, 56 Second
PLEASE NOTE – This post has been updated with new easier instructions please click HERE
A while back I bought an RTL2832u device from ebay for a very small amount and was blown away by how this piece of kit performed.


Under linux and windows it worked beautifully, I then purchased a new MacBook Pro and didn’t really know what to use as I have had no experience under Mac OSX.


So a little research came up with GQRX and I can tell you it works brilliantly and has pretty much everything you need.

Whilst there are Mac binary (DMG) files for GQRX I have not been able to find any current versions.

But I did find that MacPorts has an up to date version which is good news for us!


If you do not know what MacPorts is, it’s a an easy to use system for compiling, managing and installing open source software. Similar to Brew if you use that.

So let’s crack on and get MacPorts installed so we can get playing!



Firstly we need to install Xcode from the Apple App Store

This link will take you directly to the Xcode app in the app store.

Screen Shot 2015-02-26 at 11.54.42

Once you have Xcode installed, it’s time to install MacPorts

Download the Yosemite package here for any other version of Mac OSX please see this directory.


Install the package by double clicking it and proceeding through the next steps. You will more likely get to the stage in the installation where it says “Running package scripts”. At this stage it might take a while so please be patient it hasn’t stopped working and is downloading the latest base set behind the scenes.

Screen Shot 2015-02-26 at 11.59.52

Installing GQRX using MacPorts “Port” Command.

After the MacPorts installation has finished we then need to go ahead and issue some commands to MacPorts to install GQRX.

Fire up your Terminal of choice (I am currently using iTerm2) and issue the following command.

sudo port install gqrx

Screen Shot 2015-02-26 at 12.06.59

MacPorts will then compute all dependencies, download, compile and install them.

Screen Shot 2015-02-26 at 12.09.15This part may take a while depending on your systems hardware as it has to compile the whole of GNU Radio and some other dependencies.

Once it has finished compiling and installing there will be a new menu item in your dash (F4) called MacPorts and within that folder your will be your shiny new GQRX Icon.




Launch GQRX and you will be preseneted with the following screen.

Screen Shot 2015-02-25 at 20.17.47

No Sound Huh?

Hit the top left to activate the application and you will be surfing the airwaves in not time, I did get a little annoyed after setting this up because there was no sound at all, luckily though it was just me being lazy and expecting the application to work straight away as it has done with all other applications I have used.



What I didn’t do was set the demodulation type. In the top right hand side of the program is the receiver options with the multi choice “Mode” box. You can have a look at other options to suit yourself but I chose WFM (Stereo) and all was working well.


So.. There you have it, you are now up and running and ready to surf the air waves. I hope this worked for you as it is pretty straight forward. If I missed anything or you’d like to point anything out please contact me!

About Post Author

James Smith

Security Researcher, Penetration Tester & Linux Advocate
0 %
0 %
0 %
0 %
0 %
0 %

James Smith

Security Researcher, Penetration Tester & Linux Advocate

Average Rating

5 Star
4 Star
3 Star
2 Star
1 Star

43 thoughts on “RTLSDR – Up and running in Mac OSX Yosemite with GQRX & GNURadio

  1. […] mode receiver GUI that is similar to the Windows software SDR#. Over on smittix’s blog, the author has created a post showing how to install the latest version of GQRX on OSX. The installation involves using Macports, a system that allows some open source programs like […]

  2. Just tried to install on MBP, 8 GB RAM, i7, and SSD. All seemed to go fine but didn’t create the final GQRX icon. Tried repeating the terminal command but keep getting an error at the end. Any ideas anyone. Kind regards, Roger

    BTW, also Yosemite OSX, DVB-T+DAB+FM SDR. Is 8GB not enough memory?

    1. Sorry for the late reply, I have the same specification of Macbook and have no issues here at all. I’m not sure to be honest how to combat the issue? Have you done code-select –install?

  3. Fails to say that if you haven’t agreed to xcode conditions after installing or upgrading, the instructions fall flat on their face…

  4. Take 2: Apparently, before running “sudo port install gqrx” you must run “xcode-select –install” in Terminal. The instructions don’t tell you that either, you a see message fly up, but there’s no obvious safe way to interrupt the process.

    1. Hi Chris thanks for adding that I’ve just reinstalled and noticed the same thing. I thing it may have been a change that was added after writing the article. I will update it, thanks.

  5. Goood job overall but a crucial missing step. The above makes it seem like you can just install XCode and issue the sudo command for MacPorts. Actually, you have to open XCode at least once for it to complete configuration, for you to agree to license, install XCode command line tools, &c.

  6. Hi all just one prob. once the install is finish I don’t have the GQRX icon, many other ICON but not the essential ICON I need !!! any help ? Thanks and bravo….

  7. The install went fine. However it seems as though the program does not see the antenna. I can make changes to all the assorted options, but there is no indication that the antenna is being “seen”. I know it works because I have run the same dongle with SDR# on my Windows 10 laptop. I prefer working with the MacBook Air.

  8. I love this! Thanks for the article… I have read and followed it and the comments to the letter [I think] and still get:

    —> Building uhd

    Error: org.macports.build for port uhd returned: command execution failed

    Error: Failed to install uhd

    Please see the log file for port uhd for details:


    Error: The following dependencies were not installed: gnuradio uhd volk orc xmlto coreutils docbook-xml docbook-xml-4.1.2 docbook-xml-4.2 xmlcatmgr docbook-xml-4.3 docbook-xml-4.4 docbook-xml-4.5 docbook-xml-5.0 docbook-xsl findutils fop getopt libpaper gr-osmosdr airspy bladeRF tecla gr-fcdproplus hackrf rtl-sdr

    To report a bug, follow the instructions in the guide:


    Error: Processing of port gqrx failed

    dBs-Mini-Me:~ username$

    ANY ideas? Sorta, kinda at a loss….

  9. I had an error about 4 hours into / sudo port gqrx / .. Failed to install libgcc …
    therefore the command execution failed …. What should i do now…? Any advice is appreciate… thanks

  10. I followed the instructions to the t. Got an error from not agreeing to the license. went thru all that followed the steps I do not have GQRX icon nor do I have the Macports icon either. So I am at a loss as to what to do..
    Thanks in advance for any help you can provide

  11. I-m running el capitan, installed FIRST Macports, Then Xcode, started xcode and installed gqrx, all seems to run fine , still running the installer…

  12. This is taking all night! Why do we even have to do this at all? Why doesn’t the author build/compile/whatever this himself and we download, install and enjoy it? This is absurd! Oh great! “Command line tools don’t appear to be installed…” Now I have to start again as soon as this finishes. Hope it’s ready before the weekend. Hope it’s worth it!

  13. Hello! Running ElCap.., downloaded iTerm2, ran your suggested MacPorts command, and it ran for probably two hours, processing dozens of routines and staging them into the ‘desroot’ collection. But then it stalled, at llvm-3.7. And it won’t re-start, reporting: “Waiting for lock on /opt/local/var/macports/registry/.registry.lock”. Any suggestions? I really don’t want to return my radio dongle when I got so close!

  14. This is crazy, I have followed all the directions to a tee, I have had to download a dozen programs and updates, (not counting the other ones that magically appear every time), the terminal programs has run two or three times for HOURS only to end up with an error message at the end every time. F— THIS!

  15. It all installed surprisingly with out issue on El Capitan. Thanks! Now I just need to figure out TV (video) signals, etc.

  16. Works fine on my mid 2010 iMac with a nooelec nesdr mini2+. I now need a better antenna. Any suggestions for something that won’t need to be erected high up and can receive weather sat transmissions and acars?

  17. I was able to download everything and get it installed. But when I click the Gqrx icon, I get a segmentation fault and it fails to run. I’m on a MacBook Pro running MacOS Sierra. The backtrace is long. Here are the important sections:

    Model: MacBookPro10,2, BootROM MBP102.0106.B12, 2 processors, Intel Core i5, 2.5 GHz, 8 GB
    Graphics: Intel HD Graphics 4000, Intel HD Graphics 4000, Built-In

    Mac OS; Clang version 8.1.0 (clang-802.0.38); Boost_105900; UHD_003.010.001.001-MacPorts-Release

    Crashed Thread: 0 Dispatch queue: com.apple.main-thread
    Exception Type: EXC_BAD_ACCESS (SIGSEGV)
    Exception Codes: KERN_INVALID_ADDRESS at 0x0000000000000008
    Exception Note: EXC_CORPSE_NOTIFY
    Termination Signal: Segmentation fault: 11
    Termination Reason: Namespace SIGNAL, Code 0xb
    Terminating Process: exc handler [0]
    VM Regions Near 0x8:
    __TEXT 0000000100d18000-0000000100ec0000 [ 1696K] r-x/rwx SM=COW /Applications/MacPorts/*/Gqrx.app/Contents/MacOS/Gqrx

    Thread 0 Crashed:: Dispatch queue: com.apple.main-thread

    gr-osmosdr v0.1.x-xxx-xunknown (0.1.5git) gnuradio 3.7.11
    built-in source types: file fcd rtl rtl_tcp uhd sdrplay hackrf bladerf rfspace airspy soapy
    Segmentation fault: 11

  18. Hi James, everything seems to have installed OK. I ran the selfupdate and upgraded outdated afterwards, both reported no errors. However I don’t see the MacPorts menus in the dashboard – searched a lot on the internet to see how to manually add MacPorts to dashboard but no luck so far. Gqrx has downloaded, I copied to Apps, however when it runs, my mac pops up the config screen, then the app stops. Mac menus reports the app has stopped responding – any suggestions gratefully received, thanks Robin

  19. I got very far into the installation and then these errors at the end. I felt like i was so close!

    Error: Failed to activate freetype: Image error: /opt/local/lib/libfreetype.6.dylib already exists and does not belong to a registered port. Unable to activate port freetype. Use ‘port -f activate freetype’ to force the activation.
    Error: See /opt/local/var/macports/logs/_opt_local_var_macports_sources_rsync.macports.org_macports_release_tarballs_ports_print_freetype/freetype/main.log for details.
    Error: Follow https://guide.macports.org/#project.tickets to report a bug.
    Error: Processing of port gqrx failed
    —> Some of the ports you installed have notes:
    libpsl has the following notes:
    libpsl API documentation is provided by the port ‘libpsl-docs’.
    python27 has the following notes:
    To make this the default Python or Python 2 (i.e., the version run by the
    ‘python’ or ‘python2’ commands), run one or both of:

    sudo port select –set python python27
    sudo port select –set python2 python27
    MacBook-Pro-124:gqrx_sdr_linux rslokey$ port -f activate freetype
    Error: Insufficient privileges to write to MacPorts install prefix.
    MacBook-Pro-124:gqrx_sdr_linux rslokey$

Leave a Reply

This site uses Akismet to reduce spam. Learn how your comment data is processed.

%d bloggers like this: