Table of Contents
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.
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.
Main UI
- 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.
Button Edit UI
- 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.
Available colors (index → name)
| 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 |
Technical details
| 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 |
REM file format
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.
Tips
- Use the IQ Trim utility to trim silence from captures so they start transmitting instantly.
- If a
.metmetadata file exists alongside a capture, its frequency and sample rate are used automatically. - Button positions can be rearranged by editing the
.REMfile directly.
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
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
- 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
Applications
- 📥 Receivers
- 📤 Transmitters
- ADS-B(S) TX
- Adult Toys
- APRS TX
- BHT Xy/EP
- BLE TX
- BLESpam
- Burger Pager
- CVS Spam
- EPIRB
- 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
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
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.
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.