Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ktemkin/gnuradio-for-mac-without-macports
GNURadio bundled as an app for Mac OS X (does not require MacPorts)
https://github.com/ktemkin/gnuradio-for-mac-without-macports
Last synced: 5 days ago
JSON representation
GNURadio bundled as an app for Mac OS X (does not require MacPorts)
- Host: GitHub
- URL: https://github.com/ktemkin/gnuradio-for-mac-without-macports
- Owner: ktemkin
- License: gpl-3.0
- Created: 2017-02-19T04:57:11.000Z (almost 8 years ago)
- Default Branch: master
- Last Pushed: 2022-05-28T10:59:25.000Z (over 2 years ago)
- Last Synced: 2025-01-11T03:16:21.666Z (10 days ago)
- Language: Shell
- Size: 869 KB
- Stars: 324
- Watchers: 28
- Forks: 44
- Open Issues: 54
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# GNURadio.app
This project is here to simplify installation of [GNURadio](http://gnuradio.org/) for Mac OS X; and provides a standalone
application that's intended to be usable on modern MacOS systems and a variety of common SDR hardware. This branch provides
GNURadio v3.8, which is configured to run on top of Python3, and with GTK3 and Qt5 for UI.
Note that this version contains some major changes from GNURadio 3.7: the WX UI has been removed following its deprecation;
and, per the end-of-life of Python 2.x, we now are intended to run off of GNURadio 3.8.
Built with backend support for:
* Airspy (via osmosdr and soapy)
* AirspyHF (via soapy)
* BladeRF (via osmosdr and soapy; bitstreams included)
* HackRF (via osmosdr and soapy)
* LimeSDR (via gr-limesdr and soapy)
* NetSDR (via soapy)
* Pluto SDR (via soapy)
* Red Pitaya (via osmosdr and soapy)
* RTLSDR (via osmosdr and soapy)
* UHD/USRP (via osmosdr and soapy)
Currently tested platforms include:
* BladeRF
* HackRF
* LimeSDR
* RTLSDR
* UHD
If you've successfully tested one of the other backends, feel free to PR an addition to this list. :)
## Requirements
This distribution is meant to run on modern versions of macOS; technically, it should support releases as old as 10.7;
but this is untested. It should support modern processor features (e.g. AVX512), but shouldn't require them.
There are two software requirements you'll need to install first:
You must install Python 3.7 using the python.org installer; GNURadio.app can't use the version installed with macOS (or MacPorts or Homebrew).
## Installation
Following Apple conventions, installation is easy.
Simply [download a release](https://github.com/ktemkin/gnuradio-for-mac-without-macports/releases), open the DMG file, and then drag & drop GNURadio into your Applications directory.
## Additional steps for specific platforms
### UHD
You'll need to download the USRP firmware images with the `uhd_images_downloader.py` tool.
```bash
$ /Library/Frameworks/Python.framework/Versions/3.7/bin/pip install six requests
$ /Applications/GNURadio.app/Contents/MacOS/usr/lib/uhd/utils/uhd_images_downloader.py
```
### Trackpad users
If you're using a trackpad you'll need a way to emulate a middle-click, especially for configuring the GUI blocks. One such tool is [MiddleClick](https://github.com/DaFuqtor/MiddleClick-Catalina).
## Motivation
Some users just do not want to install [MacPorts](https://www.macports.org) only to use GNURadio. We get it. To each their own.
## Getting Started
After you have installed GNURadio, check out the [Tutorials](https://wiki.gnuradio.org/index.php/Tutorials).
Once you are confident with using some basic blocks, and if you don't already have an [SDR](https://en.wikipedia.org/wiki/Software-defined_radio) you might want to consider purchasing one. [RTL-SDR](http://www.rtl-sdr.com/) has a good [roundup of SDR devices](http://www.rtl-sdr.com/roundup-software-defined-radios/).
## Advanced Usage: Out of Tree Modules
There are only a few extra steps to use before following [Out of Tree Module Guide](https://wiki.gnuradio.org/index.php/OutOfTreeModules).
TODO: write #exactsteps [Issue #9](https://github.com/cfriedt/gnuradio-for-mac-without-macports/issues/9)
## DIY
For those who desperately want to build GNURadio for Mac from scratch using our method, you will only need two requirements listed above and to run [build.sh](https://github.com/cfriedt/gnuradio-for-mac-without-macports/blob/master/build.sh).
Keep in mind, that building most dependencies from scratch will take some amount of time, but it should work without any errors.
If you encounter any errors, or if there is a particular runtime bug or feature that you would like to see, please create a new [Issue](https://github.com/cfriedt/gnuradio-for-mac-without-macports/issues).
Pull Requests are welcome!
## License
Our shell script is released under the same [LICENSE](https://github.com/cfriedt/gnuradio-for-mac-without-macports/blob/master/LICENSE) that GNURadio is released under, namely the [GPLv3](https://raw.githubusercontent.com/cfriedt/gnuradio-for-mac-without-macports/master/LICENSE).
GNURadio graphics are freely available under the [CC BY-ND 2.0 license](https://creativecommons.org/licenses/by-nd/2.0/)1
1
Note, we have not transformed gnuradio_logo_icon-square.svg when building gnuradio.icns. It is identical to the original graphic in every way, sampled at various resolutions. See here for the #exactsteps followed. Also note that Issue #8 exists to simplify that process.
