-
-
Notifications
You must be signed in to change notification settings - Fork 914
Remote
Kyle Reed edited this page Aug 28, 2026
·
8 revisions
The Remote app lets you create a custom button panel and bind each button to a capture file for one-touch playback.
Remote files (.REM) are stored in the REMOTES/ folder on the SD card. New remotes are automatically named REMOTE_0001.REM, REMOTE_0002.REM, etc.
- Title — The top line shows the remote's name. Select it to rename it (max 30 characters).
- Buttons — Up to 12 customizable buttons arranged in a 4×3 grid. Select a button to transmit its capture file. Select the same button again to stop. Long-press Select to open the button edit screen.
- Waterfall — A small waterfall display shown between the button grid and the bottom bar while transmitting.
- Gain / Amp — Transmitter gain and amplifier control (via the TX bar at the bottom). The indicator color reflects transmitter power.
- Loop — When checked, continuously retransmits the capture until stopped.
- Filename — Shows the current remote filename (without extension). Select it to rename the file.
- Add button (+ icon) — Adds a new empty button to the grid. New buttons open in edit mode the first time they are selected.
- New remote (new-file icon) — Saves the current remote and starts a new empty one.
-
Open remote (folder icon) — Saves the current remote and opens an existing
.REMfile from theREMOTES/folder.
Remotes are automatically saved when the app exits.
- Name — The text label shown on the button (max 30 characters).
-
Path — Select to pick a capture file (
.C16/.C8) from theCAPTURES/folder. -
Freq — The center frequency to transmit on. Defaults to the capture file's metadata frequency if a
.metfile is found, otherwise falls back to the current TX frequency. - Rate — The sample rate read from the capture file's metadata, or 500 ksps if no metadata is found. Display only — cannot be changed here.
- Icon — Selects an icon to show on the button (index 0 = no icon; indices 1–24 select from the available icon set).
- FG Color — Foreground (text/icon) color index (0–20).
- BG Color — Background color index (0–20).
- Preview — Live preview of the button as it will appear in the main UI.
- Trash (red) — Deletes this button after a confirmation prompt and returns to the main screen.
- Done — Saves changes and returns to the main screen.
| Index | Color | Index | Color | Index | Color |
|---|---|---|---|---|---|
| 0 | Black | 7 | Orange | 14 | Dark orange |
| 1 | White | 8 | Yellow | 15 | Dark yellow |
| 2 | Darker grey | 9 | Green | 16 | Dark green |
| 3 | Dark grey | 10 | Blue | 17 | Dark blue |
| 4 | Grey | 11 | Cyan | 18 | Dark cyan |
| 5 | Light grey | 12 | Magenta | 19 | Dark magenta |
| 6 | Red | 13 | Dark red | 20 | Purple |
| Parameter | Value |
|---|---|
| Baseband bandwidth | 2.5 MHz |
| Sample rate | From capture metadata (or 500 ksps fallback) |
| Metadata fallback frequency | Current TX frequency |
| Settings file | tx_remote.ini |
Remote files are plain text and can be edited in any text editor. Empty lines and lines beginning with # are ignored.
- The first non-ignored line is the remote title.
- Each subsequent line (up to 12) defines one button in this comma-separated format:
capture_path,button_name,icon_index,bg_color_index,fg_color_index,center_frequency_hz,sample_rate_sps
Example:
My Remote
CAPTURES/door.C16,Door,6,3,1,433920000,500000
CAPTURES/lock.C16,Lock,0,17,1,433920000,500000
The order of buttons on screen matches the order of lines in the file, so buttons can be rearranged by reordering lines.
- Use the IQ Trim utility to trim silence from captures so they start transmitting instantly.
- If a
.txtmetadata file exists alongside a capture, its frequency and sample rate are used automatically. - Button positions can be rearranged by editing the
.REMfile directly.
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
- 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
- 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
-
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