-
-
Notifications
You must be signed in to change notification settings - Fork 861
APRS RX

The APRS RX app receives and displays messages transmitted using the APRS (Automatic Packet Reporting System) protocol. It shows a live list of received stations including callsign, position (if available), hit count, and last received time.
Select a region to automatically tune to the correct APRS frequency for that area:
| Code | Frequency | Region |
|---|---|---|
| MAN | user-defined | Manual — frequency set manually |
| NA | 144.390 MHz | North America |
| NZ | 144.575 MHz | New Zealand |
| JAP | 144.640 MHz | Japan |
| PHI | 144.740 MHz | Philippines |
| EUR | 144.800 MHz | Europe / UK |
| THA | 144.900 MHz | Thailand |
| AUS | 145.175 MHz | Australia |
| BR | 145.570 MHz | Brazil |
| ISS | 145.825 MHz | International Space Station |
When a region is selected, the frequency field updates automatically. If you change the frequency manually afterwards, the region selector switches to MAN.
- Use the rotary encoder over the frequency field to adjust in steps
- Press the middle button over the frequency field to enter a frequency manually via keypad
- Load a frequency from SD card using the frequency manager
From left to right:
-
AMP — RF amplifier:
0= off,1= on (+14 dB). Enable if signal is weak. - LNA — IF gain (0–40 dB in 8 dB steps)
- VGA — Baseband gain (0–62 dB in 2 dB steps)
See Description of gain settings for more details.
Audio volume is shown after the signal strength bars. Use the rotary encoder when focused on it.
The main screen shows a list of recently received APRS stations with the following columns:
| Column | Description |
|---|---|
| Source | Callsign of the transmitting station (with SSID if present) |
| Location | GPS coordinates if the packet contained a position report |
| Hits | Number of times this station has been received |
| Time | Time of last received packet |
Tap or select an entry to open the Detail View.
Selecting a station from the list opens a detail screen showing the full decoded APRS packet information including the raw info field content. Two buttons are available:
- Done — return to the station list
- See Map — opens the map view centered on the station's position. This button is only visible if the station transmitted a valid GPS position.
Received packets are automatically logged to the SD card at:
LOGS/APRS.TXT
Each line contains the raw decoded APRS stream data. Logging is active as long as the app is running and a writable SD card is present.
- APRS RX on the HackRF is relatively insensitive. Enable AMP if you are not receiving stations that are clearly audible on a dedicated receiver.
- Some stations transmit with a bandwidth wider than the default 8.5 kHz. If you are missing packets, increase the reception bandwidth by editing the settings file on the SD card:
- Navigate to
SETTINGS/rx_aprs.iniusing the File Manager app - Select the file, press down to select the pen icon, press OK
- Find the line starting with
nbfm_config_indexand change the value:-
0= 8.5 kHz (default) -
1= 11 kHz -
2= 16 kHz
-
- Navigate to
- APRS TX — transmit APRS packets
- APRS Protocol Reference Manual
- aprs.fi — Live APRS map
Note
The wiki is incomplete. Please add content and collaborate.
Important
- This is a public wiki. Everything is visible to everyone. Don't use it for personal notes.
- Avoid linking to external tutorials/articles; they may become outdated or contain false information.
How to collaborate
Contributing Guidelines
Trusted contributors
How to ask questions correctly
- PortaPack Versions (which one to buy)
- Features
- HackRF Versions
-
Description of the hardware
- Enclosure/cases
- Repairs
- Mods
- Usage cautions
- First steps
- Firmware update procedure
- User interface
- Powering the PortaPack
-
Troubleshooting
- Won't boot
- Config Menu
- Firmware upgrade
- Diagnose firmware update in Windows
- Receive Quality Issues
- No TX/RX
- TX Carrier Only
- H2+ speaker modifications
- Dead Coin Cell Battery
- Factory Defaults
- SD card not recognized by PC with the SD-card over USB selected
- DFU overlay
- Full reset
- SolveBoard
- How to Format SDCard
- What if I don't like some of the apps
- 📥 Receivers
- 📤 Transmitters
- 2-Tone-TX
- ADS-B(S) TX
- Adult Toys
- APRS TX
- BHT Xy/EP
- BLE TX
- BLESpam
- Burger Pager
- CVS Spam
- EPIRB
- Flex TX
- FlipperTX
- GPS Sim
- Hopper
- Jammer
- KeeLoq TX
- Key fob TX
- LGE Tool
- MDC-1200 TX
- Morse TX
- OOK
- OOK Brute
- OOK Editor
- P25 TX
- POCSAG TX
- RDS
- RTTY TX
- SAME TX
- Signal gen
- Soundboard
- Spectrum Painter
- SSTV
- TEDI/LCR
- TouchTunes
- TPMS TX
- 🔄 Transceivers
- 🟡 Recon
- 🔴 Capture
▶️ Replay- 🖲️ Remote
- 🔍 Looking Glass
- 🛠️ Utilities
- 🎮 Games
- ⚙️ Settings
- 💻 HackRF Mode
-
Compilation of the firmware
- Compile on WSL with ninja
- How to compile on Windows faster with WSL 2
- Using Docker and Kitematic
- Docker command-line reference
- Using Buddyworks and other CI platforms
- Notes for Buddy.Works (and other CI platforms)
- Using ARM on Debian host
- All in one script for ARM on Debian host
- Compile on Arch based distro (exclude Asahi), or other weird distros
- Dev build versions
- Notes About ccache
- Create a custom map
- Code formatting
- PR process
- Description of the Structure
- Software Dev Guides
- Tools
- Research
- UI Screenshots
-
Maintaining
- Creating a prod/stable release (Maintainers only)
- Maintaining rules
- Development States Notes