{"id":13418891,"url":"https://github.com/watson/airplanejs","last_synced_at":"2025-04-04T12:06:35.738Z","repository":{"id":57175010,"uuid":"113716716","full_name":"watson/airplanejs","owner":"watson","description":"📡 ✈️ App that picks up ADS-B radio signals from airplanes and plots them in real time on a map in your browser","archived":false,"fork":false,"pushed_at":"2019-05-28T13:57:11.000Z","size":110,"stargazers_count":700,"open_issues_count":8,"forks_count":46,"subscribers_count":15,"default_branch":"master","last_synced_at":"2025-03-28T11:08:58.857Z","etag":null,"topics":["ads-b","rtl-sdr","sdr"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/watson.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2017-12-10T02:29:18.000Z","updated_at":"2025-03-10T09:00:36.000Z","dependencies_parsed_at":"2022-08-28T21:00:23.027Z","dependency_job_id":null,"html_url":"https://github.com/watson/airplanejs","commit_stats":null,"previous_names":[],"tags_count":19,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/watson%2Fairplanejs","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/watson%2Fairplanejs/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/watson%2Fairplanejs/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/watson%2Fairplanejs/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/watson","download_url":"https://codeload.github.com/watson/airplanejs/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247174415,"owners_count":20896078,"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":["ads-b","rtl-sdr","sdr"],"created_at":"2024-07-30T22:01:08.490Z","updated_at":"2025-04-04T12:06:35.717Z","avatar_url":"https://github.com/watson.png","language":"JavaScript","funding_links":[],"categories":["JavaScript"],"sub_categories":[],"readme":"# AirplaneJS\n\n📡 ✈️ An SDR app written in JavaScript that picks up ADS-B radio signals from airplanes and plots them in real time on a map in your browser ✨🐢🚀✨\n\n![Map with aircrafts plottet](https://user-images.githubusercontent.com/10602/33808194-7cca8eda-dde2-11e7-8542-e09d9e600791.png)\n\n[![Build status](https://travis-ci.org/watson/airplanejs.svg?branch=master)](https://travis-ci.org/watson/airplanejs)\n[![js-standard-style](https://img.shields.io/badge/code%20style-standard-brightgreen.svg?style=flat)](https://github.com/feross/standard)\n\n## Prerequisites\n\n### Hardware\n\nThis software requires an [RTL-SDR USB dongle with an RTL2832U\nchip][az-search] in order run. Here's a few that I like:\n\n- [RTL-SDR.com dongle with 2x telescopic antennas][az-d1]\n- [Very tiny and cheap no-name RTL2832U dongle with an antenna][az-d2]\n- Or just [search Amazon for RTL2832U dongles][az-search]\n\n*Disclaimer: I'm trying out the Amazon Affiliate Program to support my\nfree open source work. So if you decide to buy an RTL-SDR dongle using\none of the links above I'll be grateful (the search link should work as\nwell).*\n\nFor more information about buying RTL-SDR dongles, check out the\n[RTL-SDR.com blog buyers\nguide](https://www.rtl-sdr.com/buy-rtl-sdr-dvb-t-dongles/).\n\n### Software\n\nThis software also requires that you have [Node.js](https://nodejs.org)\nand [librtlsdr](https://github.com/steve-m/librtlsdr) installed on your\nsystem. You can install librtlsdr with most package managers which will\nensure you have the right dependencies.\n\nHomebrew (macOS):\n\n```\nbrew install librtlsdr\n```\n\nDebian based Linux distros:\n\n```\napt-get install librtlsdr-dev\n```\n\n## Usage\n\nThe easiest way to run AirplaneJS is using the `npx` command that you'll\nhave availble if you have Node.js 8+ installed. Simply plug in your\nRTL-SDR dongle and type:\n\n```\nnpx airplanejs\n```\n\nThis will download and run AirplaneJS without any hassle.\n\nWhen AirplaneJS successfully have connected to the USB dongle, your\ndefault browser should automatically open to\n[http://localhost:3000](http://localhost:3000).\n\nAlternatively install the module globally like in the old days:\n\n1. Install AirplaneJS globally:\n   ```\n   npm install airplanejs -g\n   ```\n1. Run AirplaneJS:\n   ```\n   airplanejs\n   ```\n\n### Options\n\nThe following options are available when running `airplanejs`:\n\n- `--help` - Show help (alias: `-h`)\n- `--version` - Output AirplaneJS version (alias: `-v`)\n- `--device \u003cindex\u003e` - Select RTL dongle (alias: `-d`, default: `0`)\n- `--frequency \u003chz\u003e` - Set custom frequency (alias: `-f`, default: `1090000000`)\n- `--gain \u003cgain\u003e` - Set custom tuner gain (alias: `-g`)\n- `--auto-gain` - Disable manual tuner gain (default: off)\n- `--enable-agc` - Use Automatic Gain Control (default: off)\n- `--port \u003cport\u003e` - Set custom HTTP server port (alias: `-p`, default: `3000`)\n- `--no-browser` - Disable automatic opening of default browser\n\n## License\n\nMIT\n\n[az-search]: https://www.amazon.com/gp/search/ref=as_li_qf_sp_sr_tl?ie=UTF8\u0026tag=wa7son-20\u0026keywords=RTL2832U\u0026index=aps\u0026camp=1789\u0026creative=9325\u0026linkCode=ur2\u0026linkId=90c68a1417396c5538f5f30ca8ff74d0\n[az-d1]: https://www.amazon.com/gp/product/B011HVUEME/ref=as_li_tl?ie=UTF8\u0026camp=1789\u0026creative=9325\u0026creativeASIN=B011HVUEME\u0026linkCode=as2\u0026tag=wa7son-20\u0026linkId=ae47931667148dc42699cd9c9705422e\n[az-d2]: https://www.amazon.com/gp/product/B076H4MQBQ/ref=as_li_tl?ie=UTF8\u0026camp=1789\u0026creative=9325\u0026creativeASIN=B076H4MQBQ\u0026linkCode=as2\u0026tag=wa7son-20\u0026linkId=54c7091aa09eb38e512351437cdf43b8\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwatson%2Fairplanejs","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwatson%2Fairplanejs","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwatson%2Fairplanejs/lists"}