====== tatort-dl - an ARD-mediathek download utility ======
~~NOTOC~~

<note>
With the new ARD mediathek this script has become deprecated.

It is no longer needed. You can directly grab the URLs in JSON format from ''%%http://www.ardmediathek.de/play/media/${DOCUMENTID}?devicetype=pc&features=flash%%'' - even HTTP ones but also rtmpdump (>=2.4) keeps working just fine.

For all those who can't read JSON, Felix Knecht wrote a python script to simplify the process: https://github.com/dicer/auto-tatort (works with cron automatically). Leo Gaggl provides a shell scripted solution for manual downloads: https://github.com/leogaggl/media/

</note>

{{  :wiki:tatort-dl.png}}
''tatort-dl'' is a [[wp>Shell_script|shell-script]]ed [[wp>Command-line_interface|CLI]] tool for downloading films from [[http://www.ardmediathek.de/]].

It's named after it's main purpose: to download [[http://de.wikipedia.org/wiki/Liste_der_Tatort-Folgen|Tatorts]] ;) However - as of Jan 25 2010 - it also works with any other content on [[http://www.ardmediathek.de/]].

Please read the license under "help" at ardmediathek.de before using ''tatort-dl''. Some Films or Clips are only available during certain hours and/or time-periods.


===== Installation and Usage =====
//tatort-dl// will work on all systems supporting //bash//, //curl// and //rtmpdump//. It's developed for GNU/Linux and may work on OSX and BSD.

Download: [[http://rg42.org/gitweb/?p=scripts.git;a=blob_plain;f=tatort-dl.sh;hb=HEAD|tatort-dl.sh (latest)]].

Save it as ''tatort-dl'' in ''~/bin'' or ''/usr/local/bin/'' and mark it as executable ''chmod +x tatort-dl''. 

You need to have //rtmpdump// and //curl// software installed (''sudo apt-get install rtmpdump curl'').

  Usage:
    tatort-dl <ARDmediathek-URL> [out-file]
  The default out-file name is ./format<ard-uid>.f4v
   
  Example:
    tatort-dl "http://www.ardmediathek.de/ard/servlet/content/3517136?documentId=3701294"


===== Source Code =====

Update: 2012/05/28 - fix parser for new ARD web-player.

<code|h view tatort-dl.sh source|h>
extern>http://rg42.org/gitweb/?p=scripts.git;a=blob_plain;f=tatort-dl.sh;hb=HEAD
</code>

{{tag>floss video}}