A Go application for monitoring and tracking the availability of Real-time Transport Protocol (RTP) streams in your network. The application discovers and displays stream information by subscribing to the actual stream data.

• Terminal User Interface: Interactive TUI for real-time monitoring
• Headless Mode: Command-line monitoring without UI for automation and logging
• Stream Discovery: Discover streams via mDNS, SAP, or static SDP files
• Live VU Meters: Real-time audio level visualization
• RTCP log: Detailed per-streamRTCP packet analysis
• Real-time Updates: Periodic refresh of stream status and statistics
• WAV Recording: Record selected stream to a WAV file
• PTP Monitor: If started with sufficient privileges, PTP time transmitters will be monitored and their equivalent RTP timestamp will be displayed in the stream details view.
• FPGA RX streaming: Support for Ravenna FPGA stream receiver (only available on Linux with special hardware)

• Go 1.21 or later

git clone https://github.com/holoplot/rtp-monitor.git
cd rtp-monitor
go mod download
go build -o rtp-monitor

The project includes a Makefile for easy development:

make build      # Build the application
make run        # Build and run the application
make clean      # Clean build artifacts
make test       # Run tests
make version    # Show version information
make release    # Build for multiple platforms

The application uses git describe to automatically determine version information:

• On a git tag: v1.0.0
• After a tag: v1.0.0-5-gabcdef0 (5 commits after v1.0.0)
• With changes: v1.0.0-5-gabcdef0-dirty
• No tags: abcdef0 (commit hash only)

# Check embedded version info
./rtp-monitor version
# Output: v0.8-12-ga55f82b-dirty (commit: a55f82b, built: 2025-12-03 09:42:30 UTC, go: go1.25.4 X:nodwarf5)

# Build with custom version (optional)
make build VERSION=v2.0.0-custom

# View build variables
make version

Launch the interactive terminal interface:

./rtp-monitor

You can also load SDP files for manual stream configuration:

./rtp-monitor --sdp stream1.sdp --sdp stream2.sdp

Run in headless mode for automated monitoring without UI:

# Basic headless mode - logs discovered/disappeared streams
./rtp-monitor --headless

# Monitor specific streams by ID hash with periodic reports
./rtp-monitor --headless --hash 71cb8481ed --hash 850fab871a

**Note**: `--hash` can only be used with `--headless`. When monitoring specific streams, the application will:
- Create RTP receivers for each monitored stream
- Report packet rates and sequence errors periodically
- Log when monitored streams appear or disappear

### Command Line Options

```bash
Usage:
  rtp-monitor [flags]

Flags:
    --headless                   Run in headless mode (no UI)
-h, --help                       help for rtp-monitor
    --interface stringArray      Network interface to use (can be used multiple times)
    --no-mdns                    Disable mDNS discovery
    --no-sap                     Disable SAP discovery
    --report-interval duration   Report interval for stream monitoring in headless mode (default 1s)
    --hash stringArray           Stream ID hash to monitor in headless mode (can be used multiple times)
    --sdp stringArray            SDP file to parse (can be used multiple times)
-v, --version                    version for rtp-monitor
    --wav string                 Folder to save WAV files

• ↑ or k: Move selection up
• ↓ or j: Move selection down
• Home: Go to first stream
• End: Go to last stream
• Page Up: Move up one page
• Page Down: Move down one page

• c: Copy selected stream's SDP to clipboard
• d: Show detailed information for selected stream
• f: Show FPGA RX modal for selected stream (Linux only)
• r: Show RTCP logs for selected stream
• R: Record selected stream to a WAV file
• m: Show live meters for selected audio stream
• q, Ctrl+C, or Esc: Quit application

• ↑ or k: Move modal content up
• ↓ or j: Move modal content down
• Esc, x: Close modal and return to main view

• Cobra: CLI framework
• Bubble Tea: Terminal UI framework
• Lipgloss: Terminal styling

1. Fork the repository
2. Create a feature branch
3. Commit your changes
4. Push to the branch
5. Open a Pull Request

This project is licensed under the MIT License - see the LICENSE file for details.