{"id":13583786,"url":"https://github.com/ha7ilm/openwebrx","last_synced_at":"2025-04-06T21:32:59.615Z","repository":{"id":23902043,"uuid":"27281931","full_name":"ha7ilm/openwebrx","owner":"ha7ilm","description":"Open source, multi-user SDR receiver software with a web interface","archived":true,"fork":false,"pushed_at":"2024-06-16T14:28:22.000Z","size":6602,"stargazers_count":992,"open_issues_count":79,"forks_count":478,"subscribers_count":107,"default_branch":"master","last_synced_at":"2024-11-06T00:39:27.596Z","etag":null,"topics":["html5","rtl-sdr","sdr","software-defined-radio","waterfall"],"latest_commit_sha":null,"homepage":"https://sdr.hu/openwebrx","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ha7ilm.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.txt","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}},"created_at":"2014-11-28T20:55:31.000Z","updated_at":"2024-11-02T14:32:53.000Z","dependencies_parsed_at":"2023-02-15T18:16:01.837Z","dependency_job_id":"c3400956-adc6-44aa-8d5f-e89769aeccb0","html_url":"https://github.com/ha7ilm/openwebrx","commit_stats":null,"previous_names":[],"tags_count":6,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ha7ilm%2Fopenwebrx","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ha7ilm%2Fopenwebrx/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ha7ilm%2Fopenwebrx/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ha7ilm%2Fopenwebrx/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ha7ilm","download_url":"https://codeload.github.com/ha7ilm/openwebrx/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247556431,"owners_count":20957970,"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","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":["html5","rtl-sdr","sdr","software-defined-radio","waterfall"],"created_at":"2024-08-01T15:03:47.783Z","updated_at":"2025-04-06T21:32:59.252Z","avatar_url":"https://github.com/ha7ilm.png","language":"JavaScript","funding_links":[],"categories":["JavaScript","JavaScript (485)"],"sub_categories":[],"readme":"# OpenWebRX\n\nOpenWebRX is a multi-user SDR receiver software with a web interface.\n\n----\n\n### ⚠️ From 2019-12-29 OpenWebRX development is discontinued. ⚠️\n\nI'm would like to say a big thanks to everyone who supported me during this project, including those who contributed either code or donations. It has been a very fruitful 6 years, but now it's time to move on to other projects. See also my [blog](https://blog.sdr.hu) about that.  \n\n(@simonyiszk, please keep this GitHub repo for historic purposes.)\n\nKnow limitations of the last version:\n\n- Python 2.7, a main dependency of the project, will be not be officially maintained from 1 January 2020. By time, probably it will not be secure to use this version on public servers, unless someone still provides security patches for Python 2. \n- Some specific parts of the DSP code could be improved for better SNR.\n\nEven though these limitations are probably acceptable in an amateur radio project, I would not build critical infrastructure on it.  \n\nFor commercial inquiries (e.g. if someone wants me to develop an improved version without these limitations), I'm still open, [drop me an e-mail](mailto:randras@sdr.hu).\n\n----\n\n[:floppy_disk: Setup guide for Ubuntu](http://blog.sdr.hu/2015/06/30/quick-setup-openwebrx.html)  |  [:blue_book: Knowledge base on the Wiki](https://github.com/simonyiszk/openwebrx/wiki/)  |  [:earth_americas: Receivers on SDR.hu](http://sdr.hu/) \n\n![OpenWebRX](http://blog.sdr.hu/images/openwebrx/screenshot.png)\n\nIt has the following features:\n\n- \u003ca href=\"https://github.com/simonyiszk/csdr\"\u003ecsdr\u003c/a\u003e based demodulators (AM/FM/SSB/CW/BPSK31),\n- filter passband can be set from GUI,\n- waterfall display can be shifted back in time,\n- it extensively uses HTML5 features like WebSocket, Web Audio API, and \u0026lt;canvas\u0026gt;,\n- it works in Google Chrome, Chromium (above version 37) and Mozilla Firefox (above version 28),\n- currently supports RTL-SDR, HackRF, SDRplay, AirSpy and many other devices, see the \u003ca href=\"https://github.com/simonyiszk/openwebrx/wiki/\"\u003eOpenWebRX Wiki\u003c/a\u003e,\n- it has a 3D waterfall display:\n\n![OpenWebRX 3D waterfall](http://blog.sdr.hu/images/openwebrx/screenshot-3d.gif)\n\n**News (2015-08-18)**\n- My BSc. thesis written on OpenWebRX is \u003ca href=\"https://sdr.hu/static/bsc-thesis.pdf\"\u003eavailable here.\u003c/a\u003e\n- Several bugs were fixed to improve reliability and stability.\n- OpenWebRX now supports compression of audio and waterfall stream, so the required network uplink bandwidth has been decreased from 2 Mbit/s to about 200 kbit/s per client! (Measured with the default settings. It is also dependent on `fft_size`.)\n- OpenWebRX now uses \u003ca href=\"https://github.com/simonyiszk/csdr#sdrjs\"\u003esdr.js\u003c/a\u003e (*libcsdr* compiled to JavaScript) for some client-side DSP tasks. \n- Receivers can now be listed on \u003ca href=\"http://sdr.hu/\"\u003eSDR.hu\u003c/a\u003e.\n- License for OpenWebRX is now Affero GPL v3. \n\n**News (2016-02-14)**\n- The DDC in *csdr* has been manually optimized for ARM NEON, so it runs around 3 times faster on the Raspberry Pi 2 than before. \n- Also we use *ncat* instead of *rtl_mus*, and it is 3 times faster in some cases.\n- OpenWebRX now supports URLs like: `http://localhost:8073/#freq=145555000,mod=usb`\n- UI improvements were made, thanks to John Seamons and Gnoxter.\n\n**News (2017-04-04)**\n- *ncat* has been replaced with a custom implementation called *nmux* due to a bug that caused regular crashes on some machines. The *nmux* tool is part of the *csdr* package.\n- Most consumer SDR devices are supported via \u003ca href=\"https://github.com/rxseger/rx_tools\"\u003erx_tools\u003c/a\u003e, see the \u003ca href=\"https://github.com/simonyiszk/openwebrx/wiki/Using-rx_tools-with-OpenWebRX\"\u003eOpenWebRX Wiki\u003c/a\u003e on that.\n\n**News (2017-07-12)**\n- OpenWebRX now has a BPSK31 demodulator and a 3D waterfall display.\n\n\u003e When upgrading OpenWebRX, please make sure that you also upgrade *csdr*!\n\n## OpenWebRX servers on SDR.hu\n\n[SDR.hu](http://sdr.hu) is a site which lists the active, public OpenWebRX servers. Your receiver [can also be part of it](http://sdr.hu/openwebrx), if you want.\n\n![sdr.hu](http://blog.sdr.hu/images/openwebrx/screenshot-sdrhu.png)\n\n## Setup\n\nOpenWebRX currently requires Linux and python 2.7 to run. \n\nFirst you will need to install the dependencies:\n\n- \u003ca href=\"https://github.com/simonyiszk/csdr\"\u003elibcsdr\u003c/a\u003e\n- \u003ca href=\"http://sdr.osmocom.org/trac/wiki/rtl-sdr\"\u003ertl-sdr\u003c/a\u003e\n\nAfter cloning this repository and connecting an RTL-SDR dongle to your computer, you can run the server:\n\n\tpython openwebrx.py\n\nYou can now open the GUI at \u003ca href=\"http://localhost:8073\"\u003ehttp://localhost:8073\u003c/a\u003e.\n\nPlease note that the server is also listening on the following ports (on localhost only):\n\n- port 4951 for the multi-user I/Q server.\n\nNow the next step is to customize the parameters of your server in `config_webrx.py`.\n\nActually, if you do something cool with OpenWebRX, please drop me a mail:  \n*Andras Retzler, HA7ILM \u0026lt;randras@sdr.hu\u0026gt;*\n\n## Usage tips\n\nYou can zoom the waterfall display by the mouse wheel. You can also drag the waterfall to pan across it.\n\nThe filter envelope can be dragged at its ends and moved around to set the passband.\n\nHowever, if you hold down the shift key, you can drag the center line (BFO) or the whole passband (PBS).\n\n## Setup tips\n\nIf you have any problems installing OpenWebRX, you should check out the \u003ca href=\"https://github.com/simonyiszk/openwebrx/wiki\"\u003eWiki\u003c/a\u003e about it, which has a page on the \u003ca href=\"https://github.com/simonyiszk/openwebrx/wiki/Common-problems-and-their-solutions\"\u003ecommon problems and their solutions\u003c/a\u003e.\n\nSometimes the actual error message is not at the end of the terminal output, you may have to look at the whole output to find it.\n\nIf you want to run OpenWebRX on a remote server instead of *localhost*, do not forget to set *server_hostname* in `config_webrx.py`.\n\n## Licensing\n\nOpenWebRX is available under Affero GPL v3 license (\u003ca href=\"https://tldrlegal.com/license/gnu-affero-general-public-license-v3-(agpl-3.0)\"\u003esummary\u003c/a\u003e).\n\nOpenWebRX is also available under a commercial license on request. Please contact me at the address *\u0026lt;randras@sdr.hu\u0026gt;* for licensing options. \n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fha7ilm%2Fopenwebrx","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fha7ilm%2Fopenwebrx","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fha7ilm%2Fopenwebrx/lists"}