Table of contents
Main Menu
The main menu is the first screen shown after boot. It is a 2-column button grid that provides access to all major areas of the firmware.
Menu items
| Entry | Color | Description |
|---|---|---|
| Receive | Cyan | Receiver applications — audio, ADS-B, AIS, APRS, BLE, POCSAG, and more |
| Transmit | Cyan | Transmitter applications — APRS TX, BLE TX, OOK, RDS, TouchTunes, and more |
| Transceiver | Cyan | Bidirectional apps — Microphone TX/RX and KISS TNC |
| Recon | Green | Automated frequency scanning and signal reconnaissance |
| Capture | Red | Raw IQ capture to SD card |
| Replay | Green | Playback of previously captured IQ files |
| Looking Glass | Green | Wideband spectrum sweep visualizer |
| Utilities | Cyan | Tools — File Manager, Freq. Manager, IQ Trim, Notepad, Flash Utility, Debug, and more |
| Games | Cyan | Built-in games |
| Settings | Cyan | Device configuration — radio, display, UI, P.Memory, and more |
| HackRF | Cyan | Switch to standard HackRF mode (USB SDR) |
Note
HackRF always appears as the last item in the menu. It is not a navigation target but a mode switch — selecting it opens a confirmation dialog. See HackRF for details.
External apps in the main menu
External apps (.ppma or .ppmp files in the APPS/ folder on the SD card) can be configured to appear directly in the main menu rather than inside a submenu. Apps registered at the HOME location are inserted between Settings and HackRF in the order they appear in the APPS/ directory.
See External-apps-informations for how to configure an external app's menu location.
App Search
Tapping the info bar (the status bar at the top of the screen) opens an alphanumeric keyboard. Type part of an app name (up to 20 characters) and confirm to search across all built-in and external apps. A results list is shown with matching entries — select one to launch it directly. If no match is found a modal displays "No matching app found." Pressing back or submitting an empty query cancels the search.
Navigation
From the main menu, pressing the back button (or the left hardware button on H1/H2, or navigating back on H4M) has no effect — the main menu is the root of the navigation stack.
The title bar at the top of every screen provides access to quick settings (converter, clock output, speaker, stealth mode) and shows the current UTC time, battery status, and SD card status. See Title-Bar for details.
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
Start here
Contributors
How to collaborate
Contributing Guidelines
Trusted contributors
How to ask questions correctly
Hardware
- PortaPack Versions (which one to buy)
- Features
- HackRF Versions
- Description of the hardware
- Enclosure/cases
- Repairs
- Mods
User manual
Intended use and Legality
- 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
- 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
Applications
- 📥 Receivers
- 2-Tone-RX
- ACARS
- ADS-B
- AFSK
- AIS Boats
- Analog TV
- APRS RX
- Audio
- BLE RX
- Detector
- EPIRB RX
- ERT Meter
- Flex RX
- Radio
- Fox-Hunt
- FPV-Detect
- gfxEQ
- Level
- Meteor
- Morse RX
- NOAA
- NRF
- POCSAG
- ProtoView
- Radiosonde
- RTTY RX
- Scanner
- Search
- Signal Hunter
- SSTV RX
- SubCar
- SubGhzD
- Tetra RX
- Time Sink
- TPMS RX
- Weather
- WeFax
- VOR RX
- 📤 Transmitters
- 2-Tone-TX
- ADS-B(S) TX
- Adult Toys
- APRS TX
- BHT Xy/EP
- BLE TX
- BLESpam
- Burger Pager
- CVS Spam
- EPIRB TX
- 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
- Security+ TX
- Signal gen
- Soundboard
- Spectrum Painter
- SSTV
- TEDI/LCR
- TouchTunes
- TPMS TX
- VOR TX
- 🔄 Transceivers
- 🟡 Recon
- 🔴 Capture
- ▶️ Replay
- 🖲️ Remote
- 🔍 Looking Glass
- 🛠️ Utilities
- 🎮 Games
- ⚙️ Settings
- 💻 HackRF Mode
Misc
Developer Manual
- 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