📡
This software requires an RTL-SDR USB dongle with an RTL2832U chip in order run. Here's a few that I like:
- RTL-SDR.com dongle with 2x telescopic antennas
- Very tiny and cheap no-name RTL2832U dongle with an antenna
- Or just search Amazon for RTL2832U dongles
Disclaimer: I'm trying out the Amazon Affiliate Program to support my free open source work. So if you decide to buy an RTL-SDR dongle using one of the links above I'll be grateful (the search link should work as well).
For more information about buying RTL-SDR dongles, check out the RTL-SDR.com blog buyers guide.
This software also requires that you have Node.js and librtlsdr installed on your system. You can install librtlsdr with most package managers which will ensure you have the right dependencies.
Homebrew (macOS):
brew install librtlsdr
Debian based Linux distros:
apt-get install librtlsdr-dev
The easiest way to run AirplaneJS is using the npx command that you'll
have availble if you have Node.js 8+ installed. Simply plug in your
RTL-SDR dongle and type:
npx airplanejs
This will download and run AirplaneJS without any hassle.
When AirplaneJS successfully have connected to the USB dongle, your default browser should automatically open to http://localhost:3000.
Alternatively install the module globally like in the old days:
- Install AirplaneJS globally:
npm install airplanejs -g - Run AirplaneJS:
airplanejs
The following options are available when running airplanejs:
--help- Show help (alias:-h)--version- Output AirplaneJS version (alias:-v)--device <index>- Select RTL dongle (alias:-d, default:0)--frequency <hz>- Set custom frequency (alias:-f, default:1090000000)--gain <gain>- Set custom tuner gain (alias:-g)--auto-gain- Disable manual tuner gain (default: off)--enable-agc- Use Automatic Gain Control (default: off)--port <port>- Set custom HTTP server port (alias:-p, default:3000)--no-browser- Disable automatic opening of default browser
MIT