Giter Club home page Giter Club logo

rtpdump's Introduction

rtpdump

Extract media files from RTP streams in pcap format

codec support

This program is intended to support usual audio/video codecs used on IMS networks (VoLTE/VoWiFi).
Therefore, some codecs might be limited to usual scenarios on these networks.

  • AMR - RFC 4867
    Supports bandwidth-efficient and octet-aligned modes.
    Single-channel, single-frame per packet only.
  • H264 - RFC 6184
    Supports Single NAL Mode and some Non-Interleaved Mode streams, due to current lack of STAP-A support
Payload Type Support
1-23 NAL Unit Yes
24 STAP-A No - planned
25 STAP-B No
26 MTAP16 No
27 MTAP24 Yes
28 FU-A Yes
29 FU-B No

ipsec support

In order to support dumping VoWiFi media some support for ESP (Encapsulating Security Payload) decryption is present.

Encryption Algorithm Support
3DES CBC Yes
DES CBC No - Planned
AES CBC No - Planned

Keys are read from file 'esp-keys.txt' on the current directory by default. One key per file, for example:

[SPI] [Encryption Algorithm] [Key]
0x00d40016 des3_cbc 0x091199869ec18afd8e38f77eb1252685924937d3921a178e
0xcb97da43 des3_cbc 0xaaa316cd3fa41daa9afe6e8f42a9ae0ce2bd5128cef5a60f

Global flag -k can be used to indicate another key file path. Check -help.

replaying

Its possible to replay a RTP stream, specifying the destination host and port. The stream consumer can be a actual mobile handset or any application that can interpret RTP streams (e.g VLC).

The stream is replayed as is, taking into account the original timestamps in the pcap file and mantaining the original RTP payload type. It's up to the receiver to interpret the appropriate stream codec.

For example, VLC accepts a SDP input file:

v=0
c=IN IP4 127.0.0.1
m=audio 1234 RTP/AVP 99
a=rtpmap:99 AMR/8000

rtpdump play --host localhost --port 1234 [pcap containing amr-nb payload type 99]

usage

  • rtpdump streams [pcap]
    displays RTP streams
  • rtpdump dump [pcap] dumps a media stream.
  • rtpdump play (--host localhost --port port) [pcap] replays a RTP stream over UDP.

compiling

Checkout gopacket. Linux should be straightforward.
For Windows, make sure mingw(32/64) toolchain is on PATH for gopacket WinPcap dependency. Install WinPcap on standard location C:\WpdPack

planned features

  1. Better automation and scription support
  2. Include stream analisys, packets lost, jitter, etc
  3. Media player directly from pcap. ffmpeg support.
  4. Jitter buffer to simulate original condition, i.e. packet loss due to jitter
  5. Support multiple speach frames in audio packet

contributions

Are always appreciated.

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.