RTSPget - download an RTSP stream

Note: This was taken from Christopher N. Deckard's RTSPget page, which was taken from Ian Collier's RTSPget page. I've fixed cnd's version to work with xine-lib 1-rcX (tested with 1-rc6). It should be compatible with xine-lib 1.0, whenever that is released. I wasn't able to find cnd's contact info, so here's another new page. Some of this information is quite dated. For instance, xine can now save streams by appending `#save:/path/to/file' to a MRL (e.g. `xine rtsp://blah/asdf.rm#save:/tmp/asdf.rm'. But I still wanted something that isn't xine-ui. -Trisk

A frequently recurring question is "How can I download an RTSP stream so that I can watch it later?" This is probably because your network bandwidth isn't high enough to make the stream watchable live, or it may just be because you want to save it for later.

Now that the folks at xine have implemented an RTSP input filter, you can do just that! However, until stream-dumping is included in xine (or RTSP is included in Mplayer) the only way to do it seems to be via a program which calls xine's RTSP code directly.

Notes:

• I hacked this program up one evening recently; it seems to work but I won't actively support it, nor present it as a paragon of programming style. I merely supply it in case it is useful. If it breaks, that's tough luck I'm afraid.
• You need to have a configured xine source tree (at least version 1-beta4) before you can build this. (You don't need to build the whole of xine, but why not go ahead and do it anyway - then you can play the movie you just downloaded!)
• Once again: this web page is the only instruction I will offer. If you can't compile it, please hack at it yourself. (If you discover a 100% genuine bug then you may email me, although I can't promise to reply, and I can't fix bugs in xine's code.)

Source code

• rtspget.c - main program (2864 bytes)
• xineutils.c - support code extracted from xine (2088 bytes)
• build - shell script to compile the whole thing (667 bytes)

Build instructions

1. First build the `libreal' and `librtsp' libraries from the xine distribution. If you haven't already built the whole of xine then something like the following might work.

    $ cd /usr/src/xine-lib-1-rc6
    $ ./configure <options>
    $ cd src/input/libreal
    $ make
    $ cd ../librtsp
    $ make
    $ cd ../xine-engine
    $ make
   

2. Now compile the two source files. You will need access to some of the include files from the xine source tree. Edit the `build' script so that the XINEBUILD setting points to the directory you compiled xine-lib in, then run `./build' in the same directory as the two source files.

    $ cd /usr/src/rtspget
    $ ./build
   

Using it

For best results, supply an MRL and an output file name (in that order). The MRL must start with `rtsp://'. You can also write (in any order):

Note: `-o' can either be followed by a file name or placed last on the command line: in the latter case, the output file will be named after the MRL's base name (starting from the last slash).

If you don't name an output file, the program will output to stdout - although you probably don't want it to do that, for reasons explained below.

If you don't specify the quiet flag you'll get a running count of bytes downloaded so far (this is displayed on stderr).

Beware!

The RTSP code in xine is not perfect, so you may encounter some problems. There were issues with big-endian systems in earlier versions that have since been corrected.

• The `-v' and `-q' options (obviously) only control the main program, and not the RTSP library, so you can still get messages output even in quiet mode. Moreover, any messages coming from the RTSP library will be written on stdout (and so they'll disrupt the stream if you are writing the stream to stdout).
• If the RTSP stream comes to an end, it takes the library a while to realise; however, it will terminate eventually.
• So far, the streams I've downloaded with this will play fine on xine, but RealPlayer 8 just gives a blank screen. That's why you need to compile xine (or Mplayer) as well as just this program. :-)

That's it

Yup. Enjoy!