Table of Contents
This app allows captured signals to be replayed.
The UI
Top controls
- The top line is the name of the currently selected capture file to play (*.C8 or *.C16) .
- The second line has the Frequency (which can be modified) and the capture's sample rate.
- At the end of the second line, there are two progress bars. The top indicates the progress in playlist, and the bottom indicates the transmit progress of the current item.
- The third line indicates the length in seconds of the current item. You can set the TX gain (0-47), TX amp (0|14), loop mode, and toggle playback.
- The fourth line indicates in the left part , the current item number / from total items in that list , (example 1/2) , and in the right , the current playlist file name (could be new if we want to save later , or existing one if we are pre-loading it ).
Buttons
- Left/Right buttons allow you to change the currently selected track.
- "+ File" button will open the file picker to select a new C8/C16 (capture) file to add at the END of the playlist.
- X button will delete the currently selected item from the playlist.
- Open button will open the file picker to select a new PPL (playlist) file. This will overwrite the current playlist.
- Save button will save the modification to the current playlist.
Tips and Quirks
- When "Loop" is checked, it will continue to play the entire playlist until stopped.
- Playback always restarts from the beginning of the playlist.
- Once a capture has been added to the playlist, you can modify the playback center frequency. This is done on a per-track basis and is NOT saved as part of the playlist.
- If a capture file is missing its metadata (partner) file, then the TX frequency and 500K sample rate are assumed.
- A new, unique file name is created when a new capture file is added to an empty playlist. This playlist is not saved unless you press save.
- You can also browse to a Capture (C8/C16) or Playlist (PPL) file in the FileMan and select it to open it in Replay.
- NB: Delay (see below) hangs the UI thread and will appear to freeze the device. You have to restart to interrupt the delay.
Replay Single File
When the app starts, you have an empty playlist and the "+ File" button is focused. If you just want to play back a single item, press the "+ File" button and select a C8/C16 file with the file picker. The play button will be automatically focused once you've made a selection. This allows for fast, 2-click, playback.
Playlist
A sample TESLA.PPL file is included in the SD card.
The file with PPL extension is just text file, you could edit it with any of the text editor.
Playlist files are comma delimited and have the following structure:
ABSOLUTE_PATH_TO_C16_FILE,DELAY
#COMMENTS
For example, a valid playlist file could contain:
# Playlist file example
# capture path, pre-delay milliseconds (optional)
/SAMPLES/TeslaChargePort_US.C16
/SAMPLES/TeslaChargePort_EU_AU.C16,100
It will do:
- Play SAMPLES/TeslaChargePort_US.C16 referring the freq and rate config of its partner file
- pause 100 ms
- Play SAMPLES/TeslaChargePort_EU_AU.C16 referring the freq and rate config of its partner file
- over.
When "Loop" is checked, the playlist will be repeated until you manually stop it by press the "stop" button. Once stopped, playback will start over from the beginning of the list.
How to collaborate
How to ask questions correctly
User manual
- First steps
- Usage cautions
- Intended use and Legality
- Features
- PortaPack Versions (which one to buy)
- HackRF Versions
- Firmware update procedure
- Description of the hardware
- User interface
- Powering the PortaPack
- Troubleshooting
- Applications
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)
- 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
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.