Receive, decode, log, upload APRS packets using low cost RTL-SDR devices.
This project is the next-generation successor to PyPacket with a number of enhancements and simplified cross-platform support. Please submit bug reports as you encounter them.
- 11/19/2022 (1.0.3 release)
- Removed type logging to temporarily work around a panic/subprocess hang.
- 11/15/2022 (1.0.2 release)
- Fixed an issue with config-supplied args for
rtl_fm
andmultimon-sg
. - Logging is now more verbose, including error output during the startup sequence for the underlying
rtl_fm
,multimon-ng
processes.
- Fixed an issue with config-supplied args for
- 11/4/2022 (1.0.1 release)
- Fixed an infinite loop when an unexpected APRS-IS connection drop occurs.
- Fixed panic crashes caused when parsing packet type names.
- 10/30/2022 🎃 (1.0.0 release)
- Updated Golang version to latest.
- Updated dependency packages to latest.
- Added additional connection debugging for APRS-IS.
- Fixed several APRS-IS protocol bugs.
- Added APRS-IS digipeat output.
- Documentation updates.
- Fixed numerous small bugs.
To run Ionosphere, the following are required.
- An RTL-SDR compatible device.
- rtl_fm
- multimon-ng
If you're looking to set up Ionosphere on a Raspberry Pi from source, there's a helpful script here!
- Make sure all software in the Requirements section is installed.
- Ensure your RTL-SDR device is connected.
- Download and extract the latest binary release for your OS.
- Edit
config/config.yml
to match your needs.- If configured for automatic beaconing, you may edit the
comment
element to include a latitude, longitude, and symbol i.e.!DDMM.hhN/DDDMM.hhWIhttps://ionosphere.xyz RX IGate
- You may find additional documentation on the APRS protocol and symbols useful for custom comment formats.
- If configured for automatic beaconing, you may edit the
- In a terminal, from the directory containing Ionosphere, run
./ionosphere
.
- Unit tests. Shameful there are none yet! :sadpanda:
- Live map showing packets as they are received and uploaded.
The Automatic Packet Reporting System (APRS) is never private and never secure. As an amateur radio mode, it is designed solely for experimental use by licensed operators to publicly communicate positions and messages. Encryption on amateur radio frequencies is forbidden in most localities. As such, connections to APRS-IS are also unsecured and only intended for licensed amateur radio operators.
You are welcome to contribute by submitting pull requests on GitHub if you would like. Feature / enhancement requests may be submitted via GitHub issues.
MIT license, see LICENSE.md
for more information.