manpagez: man pages & more
man rtmpdump(1)
Home | html | info | man
rtmpdump(1)                                                        rtmpdump(1)




NAME

       rtmpdump - RTMP streaming media client


SYNOPSIS

       rtmpdump  -r url  [-n hostname]  [-c port] [-l protocol] [-S host:port]
       [-a app] [-t tcUrl] [-p pageUrl]  [-s swfUrl]  [-f flashVer]  [-u auth]
       [-C conndata]  [-y playpath] [-Y] [-v] [-d subscription] [-e] [-k skip]
       [-A start] [-B stop]  [-b buffer]  [-m timeout]  [-T key]  [-w swfHash]
       [-x swfSize] [-W swfUrl] [-X swfAge] [-o output] [-#] [-q] [-V] [-z]
       rtmpdump -h


DESCRIPTION

       rtmpdump is a tool for dumping media content streamed over RTMP.

       rtmpdump  makes a connection to the specified RTMP server and plays the
       media specified by the given url.  The url should be of the form
         rtmp[t][e]://hostname[:port][/app[/playpath]]

       Plain rtmp, as well as tunneled and encrypted sessions are supported.


OPTIONS

   Network Parameters
       These options define how to connect to the media server.

       --rtmp         -r url
              URL of the server and media content.

       --host         -n hostname
              Overrides the hostname in the RTMP URL.

       --port         -c port
              Overrides the port number in the RTMP URL.

       --protocol     -l number
              Overrides the protocol in the RTMP URL.
                0 = rtmp
                1 = rtmpt
                2 = rtmpe
                3 = rtmpte
                4 = rtmps
                5 = rtmpts

       --socks        -S host:port
              Use the specified SOCKS4 proxy.

   Connection Parameters
       These options define the content of the RTMP  Connect  request  packet.
       If  correct  values  are not provided, the media server will reject the
       connection attempt.

       --app          -a app
              Name of application to connect to on the RTMP server.  Overrides
              the  app in the RTMP URL. Sometimes the rtmpdump URL parser can-
              not determine the app name automatically, so it  must  be  given
              explicitly using this option.

       --tcUrl        -t url
              URL      of      the      target     stream.     Defaults     to
              rtmp[e]://host[:port]/app/playpath.

       --pageUrl      -p url
              URL of the web page in which the media was embedded. By  default
              no value will be sent.

       --swfUrl       -s url
              URL of the SWF player for the media. By default no value will be
              sent.

       --flashVer     -f version
              Version of the Flash plugin used to  run  the  SWF  player.  The
              default is "LNX 10,0,32,18".

       --auth         -u string
              An  authentication string to be appended to the Connect message.
              Using this option will append a Boolean TRUE and then the speci-
              fied  string.   This  option  is  only  used  by some particular
              servers and is deprecated. The more general --conn option should
              be used instead.

       --conn         -C type:data
              Append  arbitrary AMF data to the Connect message. The type must
              be B for Boolean, N for number, S for string, O for object, or Z
              for  null. For Booleans the data must be either 0 or 1 for FALSE
              or TRUE, respectively. Likewise for Objects the data must  be  0
              or 1 to end or begin an object, respectively. Data items in sub-
              objects may be named, by prefixing the type with 'N' and  speci-
              fying  the name before the value, e.g.  NB:myFlag:1. This option
              may be used multiple times to construct arbitrary AMF sequences.
              E.g.
                -C B:1 -C S:authMe -C O:1 -C NN:code:1.23 -C NS:flag:ok -C O:0

   Session Parameters
       These options take effect after the Connect request has succeeded.

       --playpath     -y path
              Overrides  the  playpath parsed from the RTMP URL. Sometimes the
              rtmpdump URL parser cannot determine the correct playpath  auto-
              matically, so it must be given explicitly using this option.

       --playlist          -Y
              Issue  a  set_playlist  command before sending the play command.
              The playlist will just contain the current playpath.

       --live         -v
              Specify that the media is a live stream. No resuming or  seeking
              in live streams is possible.

       --subscribe    -d stream
              Name of live stream to subscribe to. Defaults to playpath.

       --resume       -e
              Resume an incomplete RTMP download.

       --skip         -k num
              Skip num keyframes when looking for the last keyframe from which
              to resume. This may be useful if a  regular  attempt  to  resume
              fails. The default is 0.

       --start        -A num
              Start  at  num  seconds  into  the  stream.  Not  valid for live
              streams.

       --stop         -B num
              Stop at num seconds into the stream.

       --buffer       -b num
              Set buffer time to num milliseconds. The default is 36000000.

       --timeout      -m num
              Timeout the session after num seconds without receiving any data
              from the server. The default is 120.

   Security Parameters
       These  options  handle  additional  authentication  requests  from  the
       server.

       --token        -T key
              Key for  SecureToken  response,  used  if  the  server  requires
              SecureToken authentication.

       --swfhash      -w hexstring
              SHA256  hash  of  the  decompressed SWF file. This option may be
              needed if the server uses SWF Verification, but see the --swfVfy
              option  below.  The hash is 32 bytes, and must be given in hexa-
              decimal. The --swfsize option must  always  be  used  with  this
              option.

       --swfsize      -x num
              Size  of the decompressed SWF file. This option may be needed if
              the server uses SWF Verification, but see  the  --swfVfy  option
              below.  The  --swfhash  option  must  always  be  used with this
              option.

       --swfVfy       -W url
              URL of the SWF player for this media. This option  replaces  all
              three  of  the  --swfUrl, --swfhash, and --swfsize options. When
              this option is used, the SWF player is retrieved from the speci-
              fied  URL and the hash and size are computed automatically. Also
              the information is cached in a .swfinfo file in the user's  home
              directory,  so that it doesn't need to be retrieved and recalcu-
              lated every time rtmpdump is run. The .swfinfo file records  the
              URL,  the time it was fetched, the modification timestamp of the
              SWF file, its size, and its hash. By default,  the  cached  info
              will be used for 30 days before re-checking.

       --swfAge       -X days
              Specify  how  many  days  to  use the cached SWF info before re-
              checking. Use 0 to always check the SWF URL. Note  that  if  the
              check  shows  that  the SWF file has the same modification time-
              stamp as before, it will not be retrieved again.

   Miscellaneous
       --flv          -o output
              Specify the output file name. If the name is -  or  is  omitted,
              the stream is written to stdout.

       --hashes       -#
              Display  streaming  progress  with  a  hash  mark for each 1% of
              progress, instead of a byte counter.

       --quiet        -q
              Suppress all command output.

       --verbose      -V
              Verbose command output.

       --debug        -z
              Debug level output. Extremely verbose, including  hex  dumps  of
              all packet data.

       --help         -h
              Print a summary of command options.


EXIT STATUS

       0      Successful program execution.

       1      Unrecoverable error.

       2      Incomplete transfer, resuming may get further.


ENVIRONMENT

       HOME   The  value  of  $HOME  is  used as the location for the .swfinfo
              file.


FILES

       $HOME/.swfinfo
              Cache of SWF Verification information


SEE ALSO

       rtmpgw(8)


AUTHORS

       Andrej Stepanchuk, Howard Chu, The Flvstreamer Team
       <http://rtmpdump.mplayerhq.hu>



RTMPDump v2.2e                    2010-05-02                       rtmpdump(1)

rtmpdump 2.4 - Generated Tue Oct 18 15:56:36 CDT 2016
© manpagez.com 2000-2021
Individual documents may contain additional copyright information.