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!

James Smith

Security Researcher, Penetration Tester & Linux Advocate


sunray091 · February 26, 2015 at 7:02 pm

I am running GQRX and I did not do any of that..I dowloaded it..and ran it in Mavericks…and then upgraded to Yosemite…and it just ran there too..

    Smittix · February 26, 2015 at 9:41 pm

    You will probably have an old version lacking some of the newer features.

Smittix · February 26, 2015 at 9:40 pm

Yeah I did notice, you know some times things happen like that.

Roger Dieterich · May 4, 2015 at 12:23 am

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?

    smittix · May 4, 2015 at 6:11 am

    Hi Roger, not sure what could be causing this but 8GB Ram is plenty. I will have a look to see if I can help.

    Smittix · August 12, 2015 at 7:21 pm

    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?

IXQUS · May 5, 2015 at 4:56 am

These instructions worked well. Since I use homebrew, I wanted to make sure there weren’t any problems. So, I used the script described here: https://www.topbug.net/blog/2013/10/23/use-both-homebrew-and-macports-on-your-os-x/ and ran $ sudo use_macports.sh port install gqrx

Chris_M_Ward · May 27, 2015 at 1:59 pm

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

    Smittix · August 12, 2015 at 7:23 pm

    Indeed, this came in to force in an update which was after this article.

Chris_M_Ward · May 27, 2015 at 4:18 pm

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.

    smittix · May 28, 2015 at 11:35 am

    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.

Dag Spicer · August 16, 2015 at 11:11 pm

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.

    smittix · August 17, 2015 at 5:16 am

    Thanks for your comment, I’ll update the article

Ritchie · September 1, 2015 at 5:10 pm

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….

Ron Samson · September 20, 2015 at 11:25 pm

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.

    smittix · September 21, 2015 at 6:56 am

    What dongle are you using?

daniel Brooks · September 29, 2015 at 2:42 pm

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….

Me2 · October 4, 2015 at 3:15 am

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

    Smittix · January 21, 2016 at 12:00 pm

    Try installing the latest binary for mac from their website.

Mikael Grön · October 7, 2015 at 9:58 am

Now write this post for El Capitan!

    Smittix · January 21, 2016 at 12:00 pm

    The latest DMG file on the GQRX website was built for El Capitan and should work, although I have not tested it.

Mike · October 16, 2015 at 6:05 am

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

    Smittix · January 21, 2016 at 12:01 pm

    Have you tried the latest DMG file on the GQRX web site?

David Hadley · October 25, 2015 at 4:17 pm

How do you get the sound working? I tried all the output options with no luck 🙁

hans loos · November 4, 2015 at 8:47 am

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

    Aditya Gupte · November 22, 2015 at 2:32 pm

    How did u install on el capitan. I have xcode and macports. But it gives error something about darwin incompatibility

hans loos · November 4, 2015 at 8:49 am

I´ll use the fun-dongle for listening sir, i keep you posted

Ken Alexander · November 19, 2015 at 3:41 am

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!

Geoff Sale · December 1, 2015 at 6:48 am

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!

Mike Douglas MacIntyre · December 11, 2015 at 10:18 pm

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!

Matthew Thomas · December 17, 2015 at 2:36 pm

I second El Capitan. Time to update. There isn’t even anything in the repository.
Back to square one.

    Smittix · January 21, 2016 at 12:01 pm

    The latest DMG file available on the GQRX website should work fine for El Capitan

aquariusbutafly · January 18, 2016 at 5:06 am

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

aquariusbutafly · January 18, 2016 at 5:15 am

Has anyone tried this?


oranaadnaro · May 24, 2016 at 5:12 pm

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?

Cliff Weber · April 29, 2017 at 12:38 pm

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 Codes: KERN_INVALID_ADDRESS at 0x0000000000000008
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

robin hugo · August 18, 2017 at 8:09 am

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

Scott Lokey · February 11, 2019 at 2:17 pm

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$

Installing GQRX on Mac OSX - rtl-sdr.com · March 6, 2015 at 2:28 am

[…] 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 […]

RTL-SDR – virittely OS X | RaivoGalleria · July 13, 2015 at 6:52 am

[…] tässä hieman valaista toimenpidettä. Tarpeelliset palikat ovat asennettavissa joko hombrew:n tai macports:n avustuksella. Diggaan enemmän homebrew:sta, joten opastukseni kattaa vain sen. Oletan että […]

GQRX with SDR USB Dongle OSX | Cavern of Time · November 20, 2015 at 8:58 pm

[…] guide is solid so I’m not going to reiterate parts of it, it was seamless and everything worked as […]

GQRX with SDR USB Dongle OSX | Cavern of Time · November 24, 2015 at 6:33 pm

[…] there is a lot of information on the page I previously link. Breaking it down for easier consumption Isn’t such a bad idea.  So that being said, here is […]

Leave a Reply

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

%d bloggers like this: