{"id":13418616,"url":"https://github.com/gqrx-sdr/gqrx","last_synced_at":"2025-12-17T12:59:31.405Z","repository":{"id":1149699,"uuid":"1033271","full_name":"gqrx-sdr/gqrx","owner":"gqrx-sdr","description":"Software defined radio receiver powered by GNU Radio and Qt.","archived":false,"fork":false,"pushed_at":"2025-10-29T05:16:25.000Z","size":9397,"stargazers_count":3438,"open_issues_count":252,"forks_count":573,"subscribers_count":162,"default_branch":"master","last_synced_at":"2025-11-10T04:27:11.260Z","etag":null,"topics":["airspy","fft","funcube-dongle","gnuradio","gqrx","hackrf","hacktoberfest","qt","receiver","rfspace","rtl-sdr","sdr"],"latest_commit_sha":null,"homepage":"http://gqrx.dk","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/gqrx-sdr.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"COPYING","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2010-10-28T21:41:07.000Z","updated_at":"2025-11-09T18:56:56.000Z","dependencies_parsed_at":"2023-12-24T02:28:19.016Z","dependency_job_id":"e735f68d-8e58-47fb-8049-df09d87bcb4f","html_url":"https://github.com/gqrx-sdr/gqrx","commit_stats":{"total_commits":2243,"total_committers":116,"mean_commits":"19.336206896551722","dds":0.4337940258582256,"last_synced_commit":"25fdbb5a6b21696aebd6f264490a5c04f4ed8748"},"previous_names":["csete/gqrx"],"tags_count":64,"template":false,"template_full_name":null,"purl":"pkg:github/gqrx-sdr/gqrx","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gqrx-sdr%2Fgqrx","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gqrx-sdr%2Fgqrx/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gqrx-sdr%2Fgqrx/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gqrx-sdr%2Fgqrx/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/gqrx-sdr","download_url":"https://codeload.github.com/gqrx-sdr/gqrx/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gqrx-sdr%2Fgqrx/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":27783446,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-12-17T02:00:08.291Z","response_time":55,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["airspy","fft","funcube-dongle","gnuradio","gqrx","hackrf","hacktoberfest","qt","receiver","rfspace","rtl-sdr","sdr"],"created_at":"2024-07-30T22:01:04.531Z","updated_at":"2025-12-17T12:59:31.389Z","avatar_url":"https://github.com/gqrx-sdr.png","language":"C++","funding_links":[],"categories":["C++","Software","\u003ca name=\"cpp\"\u003e\u003c/a\u003eC++","Misc RF Tools"],"sub_categories":["CTS used","Telemetry Detection \u0026 Eavesdropping Tools"],"readme":"Gqrx\n====\n\n[![CI](https://github.com/gqrx-sdr/gqrx/workflows/CI/badge.svg)](https://github.com/gqrx-sdr/gqrx/actions?query=workflow%3ACI+branch%3Amaster)\n[![Build](https://github.com/gqrx-sdr/gqrx/workflows/Build/badge.svg)](https://github.com/gqrx-sdr/gqrx/actions?query=workflow%3ABuild+branch%3Amaster)\n\nGqrx is an open source software defined radio (SDR) receiver implemented using\n[GNU Radio](https://gnuradio.org) and the [Qt GUI toolkit](https://www.qt.io/).\nCurrently it works on Linux and Mac with hardware supported by gr-osmosdr,\nincluding Funcube Dongle, RTL-SDR, Airspy, HackRF, BladeRF, RFSpace, USRP and\nSoapySDR.\n\nGqrx can operate as an AM/FM/SSB receiver with audio output or as an FFT-only\ninstrument. There are also various hooks for interacting with external\napplications using network sockets.\n\n![Screenshot of the main Gqrx window](resources/screenshots/gqrx-main.png)\n\n\nDownload\n--------\n\nGqrx is distributed as a source code package and binaries for Linux and Mac.\nMany Linux distributions provide gqrx in their package repositories.\nAlternate Mac support is available through [MacPorts](https://ports.macports.org/port/gqrx/summary) and [Homebrew](https://formulae.brew.sh/cask/gqrx).\nWindows support is available through [radioconda](https://github.com/ryanvolz/radioconda#radioconda).\n\n* [Official releases](https://github.com/gqrx-sdr/gqrx/releases)\n* [Pre-release builds](https://github.com/gqrx-sdr/gqrx/actions?query=workflow%3ABuild+branch%3Amaster)\n\nUsage\n-----\n\nIt is strongly recommended to run the `volk_profile` utility before\nrunning gqrx. This will detect and enable processor-specific optimisations and\nwill in many cases give a significant performance boost.\n\nThe first time you start gqrx it will open a device configuration dialog.\nSupported devices that are connected to the computer are discovered\nautomatically and you can select any of them in the drop-down list.\n\nIf you don't see your device listed in the drop-down list it could be because:\n- The driver has not been included in a binary distribution\n- The udev rule has not been properly configured\n- Linux kernel driver is blocking access to the device\n\nYou can test your device using device specific tools, such as rtl_test,\nairspy_rx, hackrf_transfer, qthid, etc.\n\nGqrx supports multiple configurations and sessions if you have several devices\nor if you want to use the same device under different configurations. You can\nload a configuration from the GUI or using the `-c` command line argument. See\n`gqrx --help` for a complete list of command line arguments.\n\nTutorials and howtos are being written and published on the website\nhttps://gqrx.dk/\n\n\nKnown problems\n--------------\n\nSee the bug tracker on Github: https://github.com/gqrx-sdr/gqrx/issues\n\n\nGetting help and reporting bugs\n-------------------------------\n\nThere is a Google group for discussing anything related to Gqrx:\nhttps://groups.google.com/g/gqrx\nThis includes getting help with installation and troubleshooting. Please\nremember to provide detailed description of your problem, your setup, what\nsteps you followed, etc.\n\nPlease stick around and help others with their problems. Otherwise, if only\ndevelopers provide user support there will be no more time for further\ndevelopment.\n\n\nInstallation from source\n------------------------\n\nThe source code is hosted on Github: https://github.com/gqrx-sdr/gqrx\n\nTo compile gqrx from source you need the following dependencies:\n- GNU Radio 3.8, 3.9, or 3.10 with the following components:\n    - gnuradio-runtime\n    - gnuradio-analog\n    - gnuradio-audio\n    - gnuradio-blocks\n    - gnuradio-digital\n    - gnuradio-fft\n    - gnuradio-filter\n    - gnuradio-network (GNU Radio 3.10 only)\n    - gnuradio-pmt\n- The gr-iqbalance library (optional)\n- Drivers for the hardware you want to have support for:\n    - UHD driver via gr-uhd\n    - FUNcube Dongle and FUNcube Dongle Pro+ driver from https://github.com/dl1ksv/gr-funcube\n    - RTL-SDR driver from https://gitea.osmocom.org/sdr/rtl-sdr\n    - HackRF driver from https://github.com/mossmann/hackrf\n    - Airspy driver from https://github.com/airspy/airspyone_host\n    - SoapySDR from https://github.com/pothosware/SoapySDR\n    - RFSpace driver is built in\n- gnuradio-osmosdr from https://gitea.osmocom.org/sdr/gr-osmosdr\n- pulseaudio or portaudio (Linux-only and optional)\n- Qt 5 or Qt 6 with the following components:\n    - Core\n    - GUI\n    - Network\n    - Widgets\n    - Svg (runtime-only)\n- cmake version \u003e= 3.5.0\n\nGqrx can be compiled from within Qt Creator or in a terminal:\n\nFor command line builds:\n\u003cpre\u003e\n$ git clone https://github.com/gqrx-sdr/gqrx.git gqrx.git\n$ cd gqrx.git\n$ mkdir build\n$ cd build\n$ cmake ..\n$ make\n\u003c/pre\u003e\nOn some systems, the default cmake release builds are \"over-optimized\" and\nperform poorly. In that case try forcing -O2 using\n\u003cpre\u003e\nexport CXXFLAGS=-O2\n\u003c/pre\u003e\nbefore the cmake step.\n\nFor Qt Creator builds:\n\u003cpre\u003e\n$ git clone https://github.com/gqrx-sdr/gqrx.git gqrx.git\n$ cd gqrx.git\n$ mkdir build\nStart Qt Creator\nOpen gqrx.git/CMakeLists.txt file\nAt the dialog asking for build location, select gqrx.git/build\nclick continue\nIf asked to choose cmake executable, do so\nclick continue\nclick the run cmake button\nclick done\noptionally, on the Projects page, under Build Steps/Make/Additional arguments,\n\tenter -j4 (replacing 4 with the number of cores in your CPU).\nUse Qt Creator as before\n\u003c/pre\u003e\n\n\nDebugging\n---------\n\nDebug logging can be enabled by setting the `QT_LOGGING_RULES` environment\nvariable:\n\n```\nQT_LOGGING_RULES=\"*.debug=true;plotter.debug=false;qt.*.debug=false\" gqrx\n```\n\nTo turn on plotter debugging as well, use the following command:\n\n```\nQT_LOGGING_RULES=\"*.debug=true;qt.*.debug=false\" gqrx\n```\n\n\nCredits and License\n-------------------\n\nGqrx is designed and written by Alexandru Csete OZ9AEC, and it is licensed\nunder the GNU General Public License.\n\nSome of the source files were adapted from Cutesdr by Moe Weatley and these\ncome with a Simplified BSD license.\n\nThe following people and organisations have contributed to gqrx:\n\n* Alex Grinkov\n* Alexander Fasching\n* Andrea Merello\n* Andrea Montefusco, IW0HDV\n* Andy Sloane\n* Anthony Willard\n* Anton Blanchard\n* AsciiWolf\n* Bastian Bloessl\n* Ben Reese\n* Bob McGwier, N4HY\n* Brandonn Etheve\n* charlylima\n* Chris Kuethe\n* Christian Lindner, DL2VCL\n* Clayton Smith, VE3IRR\n* Dallas Epperson\n* Daniil Cherednik\n* Darin Franklin\n* Davide Gerhard\n* Dominic Chen\n* Doron Behar\n* Doug Hammond\n* Edouard Lafargue\n* Elias Önal\n* Federico Fuga\n* Frank Brickle, AB2KT\n* Frank Werner-Krippendorf, HB9FXQ\n* Ganael Laplanche\n* Gisle Vanem\n* Göran Weinholt, SA6CJK\n* Grigory Shipunov\n* Gwenhael Goavec-Merou\n* Herman Semenov\n* James Yuzawa\n* Jaroslav Škarvada\n* Jeff Long\n* Jiawei Chen\n* Jiří Pinkava\n* Joachim Schueth, DL2KCD\n* Jon Bergli Heier\n* Josh Blum\n* Kate Adams\n* Kenji Rikitake, JJ1BDX\n* Kitware Inc.\n* Konrad Beckmann\n* Luna Gräfje\n* luzpaz\n* Marco Savelli\n* Markus Kolb\n* Michael Dickens\n* Michael Lass\n* Michael Tatarinov\n* Moe Weatley\n* Nadeem Hasan\n* Nate Temple\n* Nick Robinson, KE5YWP\n* Nokia\n* Oliver Grossmann, DH2WQ\n* Pavel Milanes, CO7WT\n* Pavel Stano\n* Phil Vachon\n* Radoslav Gerganov\n* Rob Frohne\n* Ron Economos, W6RZ\n* Ruslan Migirov\n* Russell Dwarshuis, KB8U\n* Ryan Volz\n* Shuyuan Liu\n* Stefano Leucci\n* Sultan Qasim Khan\n* Sylvain Munaut\n* Tarmo Tanilsoo\n* Tomasz Lemiech\n* Timothy Reaves\n* Valentin Ochs\n* Vesa Solonen\n* Vincent Pelletier\n* Vladisslav P\n* Will Scales\n* Wolfgang Fritz, DK7OB\n* Youssef Touil\n* Zero_Chaos\n\nSome of the icons are from:\n- The GNOME icon theme CC-SA 3.0 by GNOME icon artists\n- Tango icon theme, Public Domain by The people from the Tango! project\n- Mint-X icon theme, GPL by Clement Lefebvre\n\nAlso thanks to Volker Schroer and Alexey Bazhin for bringing Funcube Dongle\nPro+ support to GNU Radio and Gqrx.\n\nLet me know if somebody is missing from the list.\n\nAlex OZ9AEC\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgqrx-sdr%2Fgqrx","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgqrx-sdr%2Fgqrx","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgqrx-sdr%2Fgqrx/lists"}