Short:        get video files from YouTube etc.
Author:       Juergen Lucas
Uploader:     Juergen Lucas <antibike web de>
Type:         comm/www
Version:      0.24
Replaces:     comm/www/getvideo.lha
Architecture: generic
Distribution: Aminet


getVideo
--------

This ARexx script can be used to grab some information from popular video
portals like YouTube so you can download the video files and play it using
mplayer.

It is based on the youtube_downloader ARexx script from Fabien Coeurjoly.
Many thanks to FAB for this pattern because my ARexx skills are limited
and without his help I wouldn't had a chance to write this script.


Readme Index:
   1. Requirements
   2. History
   3. Install
   4. Usage
   5. Setup for OWB MorphOS
   6. Setup for IBrowse
   7. Supported Sites


1. Requirements:
   * working ARexx setup
   * a TCP/IP stack with a working TCP handler
   * some cli commands (filenote,delete,touch,requestchoice,requestfile)
   * wget command in your system path or another path (setup required)
   * mplayer for playing FLV files. mplayer must be in system path or
     another path (setup required)
   * rtmpdump (prefered) or flvstreamer in your system path or another
     path (setup required) - this is only needed for some of the supported
     sites.


2. History:
   * 0.24 [2010-02-04]
          + some small changes in youtube support
          + improved support for zdf, but no more filetype preselection
          + add support for
            - web.de
            - gmx
            - amazon
            - jpc
            - foxnews
          + fixed support for
            - ard
            - vox (need rtmpdump 2.1)
            - rtl (need rtmpdump 2.1)
            - sevenload

   * 0.23 [2009-11-21]
          + fixed youtube HD support and title parsing
          + changed youtube filetype preselection, look at getvideo.cfg
          + fixed a bug in getVideo startscript that lead to errors if
            a url contain a semicolon (;)
          + fixed support for zdf
          + add support for
            - yahoo (http streams only)
            - bild

   * 0.22 [2009-09-17]
          + changed youtube flv from stereo (fmt=34) back to standard
          + fixed support for
            - dailymotion
            - break
            - myspace
          + add support for
            - vox
            - rtl
            - pbs
          + sevenload now also with support for rtmp streams
          + add save_rtmp, rtmp_auth and rtmp_dlcomp option to getvideo.cfg
          + getVideo.html includes now some more info

   * 0.21 [2009-08-13]
          + fixed support for youtube (not very much tested)

   * 0.20 [2009-07-23]
          + add support for the following sites
             - blip.tv
             - megavideo
             - vimeo

   * 0.19 [2009-07-13]
          + add support for the following sites
             - dumpert
             - funnyordie
          + add some kind of development pack but it is not well described

   * 0.18 [2009-06-25]
          + removed a bug in youtube playlist support
          + fixed a stupid bug in youtube support that leads to 404 error
          + add support for youtube HD video if available
          + improved google video support
          + little bit improved polylog support
          + add "Setup for OWB MorphOS" to this readme

   * 0.17 [2009-06-03]
          + add support for sevenload again (only for http streams)
          + improved youtube playlist support
          + add "max_rc_buttons" settings to getvideo.cfg

   * 0.16 [2009-05-11]
          + add 3GP filetype for youtube
          + extended support for ardmediathek
          + fixed support for the following sites
             - cttv
             - myvideo
             - current.tv
             - dailymotion
             - fitforfun
             - google
             - metacafe
             - youtube
          - dailymotion filetype preselection in getvideo.cfg is no more
            available
          - google filetype "mp4" removed
          - removed support for sevenload
             
   * 0.15 [2008-10-14]
          + changed the setup for mplayer_exe and wget_exe in the config.
            if you use default settings this don't concern you. if you have
            wget and mplayer in a special directory then you have to setup
            the path again ... sorry :)
            with this change you can easily setup another player if you want
          + add a "ask" filetype and set it as default. if you don't want a
            requester that ask you for the prefered filetype than you have
            to preset it in getvideo.cfg
          + add support for the following sites
             - ardmediathek
             - ct-tv
             - YLE
          + add .asx and mms: direct support
          - removed support for hronline

   * 0.14 [2008-09-23]
          + changed gametrailers support (i hope it is more useable now)
          + add support for the following sites
             - 3sat
             - arte
             - stream-tv (only linking)
             - zdf
          + fixed support for the following sites
             - dailymotion
             - clipfish
             - tubevube (only linking)
          + dailymotion filetypes changed in config
          - google filetype "avi" removed
          - videotube support removed
          + support now all urls that use a http reroute to a supported url

   * 0.13 [2008-08-27]
          + add youtube filetype selection in config file
          + add crackle filetype selection in config file
          + add support for the following sites
              - evisor
              - gamersyde (only low quality)
              - gametrailers (very limited, not realy useable)
              - polylog
              - searchforvideo
          + fixed support for the following sites
              - crackle
              - hausgemacht
              - metacafe
              - sevenload
          + removed support for the following sites, because
            i can't fix the support for it ... sorry
              - mail.ru
              - ntv.ru
              - yahoo

   * 0.12 [2008-03-01]
          + add support for the following sites
              - video.mail.ru
          + fixed support for the following sites
              - hronline (ctmagazin.tv)
              - dailymotion
          + add dailymotion filetype selection in config file
          - removed Stage6 support, because site has closed
          - yahoo support is broken
            it seems they use RTMP now and no more RTMPT
            http://en.wikipedia.org/wiki/Real_Time_Messaging_Protocol
            can't get it to work currently and don't see many chances
            for the future

   * 0.11 [2008-01-28]
          + fixed support for the following sites
              - clipfish music videos
              - last.fm
              - metacafe
          + fixed a stupid TYPO that leads to errors with saveplay action
          + add alternative installpaths
            more info in the install section of this readme

   * 0.10 [2008-01-28]
          + fixed support for youtube

   * 0.9  [2007-12-01]
          + i found a site with embedded YouTube video that had the
            following url scheme: http://www.youtube.com/p/xxxxxx
            this is a link to a playlist >> add Playlist support for YouTube.
          + add infolevel option in config file and set the default info
            output for action "play" to "only errors".
          + getVideo.html is now also a feedback tool ... please take the
            two minutes and make sure you are connected to the internet.

   * 0.8  [2007-11-26]
          + add support for the following sites
              - last.fm
              - dailymotion.com (embedded videos)
              - guba.com
              - crackle.com (linked by google, crackle interface need flash)

   * 0.7a [2007-10-25]
          + emergency release. 0.7 executable don't work on OS4, so all is
            changed back to script files. this is also good for the guys who
            want it open source :)

   * 0.7  [2007-10-21]
          + add support for the following sites
              - stage6.com
          + add support for age control videos on youtube
            some work some not ... just try it
            sorry can't grab a title here
          + add mplayer_arg_net variable to getVideo.cfg
          + getvideo is a executable now (thanks for your feedback Michael)
            sorry this kills support for R the gui generator
          + add overwrite option, if the output file allready exists
          - yahoo support is broken for some vids and i don't get it to work :(

   * 0.6  [2007-10-10]
          + add a action selection. this changes the command args (sorry)
            please look in the usage area for more info
            (thx for your feedback sami)
          + add support for 'http://www.youtube.com/v/xxxxxx' URL scheme
            this way you can download embedded youtube videos using the
            Plugin File contextmenu of IBrowse. Also works with embedded
            google video files. (thx for your feedback Kicko)
            Please look at the "Setup for IBrowse" area for setup instruction
          + replaced the crap implementation of the thirdlevel domain check
            with a better(?) one
          + add support for the following sites
              - video.yahoo.com (thx for your feedback Paul)
          + add config file support to get the settings out of the rexx file
            getVideo.cfg is optional and not needed if you only use default
            settings

   * 0.5  [2007-10-01]
          + add support for the following sites
              - tubevube (YouTube frontend)
              - fitforfun.de (not realy interessting)
          + changed the filetype selection for google and break to the
            settings area on top of the getvideo.rexx file
          + configurable path to wget in getvideo.rexx
          + fixed a problem with aweb that gave to much quotes (thx Hubert)
          + supported portals now in alphabetic order (killerfeature!)

   * 0.4  [2007-09-06]
          + add support for domains without thirdlevel domain (www)
            Example: http://youtube.com/watch?v=xxxxxx
            This is a crap implementation, because domains with 'co.uk'
            or 'com.tr' or other toplevel domains with point will fail.
          + add support for URLs without 'http://'
          + add support for the following sites
              - videotube.de

   * 0.3  [2007-08-26]
          + add support for the following sites
              - hausgemacht.tv
              - scivee.tv
              - sevenload.de
          + fixed support for MyVideo

   * 0.2  [2007-08-11]
          + add Resume and Save as... requester
          + add more input checks
          + add support for the following sites
              - myspace.com
              - metacafe.com
              - current.tv
              - news.ntv.ru
              - hronline.de (ctmagazin.tv)
          + add filetype selection for google and break - default is flv
            to change this you have to edit the getvideo.rexx file in the
            main part. search for host='google' or host='break' and edit the
            extension variable to your need.

   * 0.1  [2007-08-05]
          + first public release


3. Install:
   simply copy getVideo, getVideo.rexx and getVideo.cfg (optional) to c:
   or use the following alternative installpaths
   getVideo                to c:
   getVideo.rexx           to rexx:
   getVideo.cfg (optional) to env: or envarc:


4. Usage:
   getVideo "url" "action" "download directory"

   Example: getVideo "http://www.youtube.com/watch?v=xxxxxx" save ram:
            This will download the FLV file to ram disk.

   Actions: save     - save file to download directory
            play     - gives the FLV URL to mplayer
                       for this option the filetype is set to flv
            saveplay - save file to download directory and try to play the
                       file using mplayer

   Config:  please look inside the getVideo.cfg file for instructions


5. Setup for OWB MorphOS
   * go to Settings Menu -> Preferences... -> Contextual Menus
   * click on 'Add' and edit this new menu entry to
       Category: Link
       Name:     getVideo
       Action:   c:getvideo "%l" save ram:

   * click on 'Add' and edit this new menu entry to
       Category: Page
       Name:     getVideo
       Action:   c:getvideo "%u" save ram:


6. Setup for IBrowse:
   * go to Settings -> GUI -> FAB Menus

   * Open 'Link' and add a Custom menu entry
   * Edit Custom menu entry to
       Name:   getVideo
       Action: Command [c:getvideo] [%l save ram:]

   * Open 'Imagelink' and add a Custom menu entry
   * Edit Custom menu entry to
       Name:   getVideo
       Action: Command [c:getvideo] [%l save ram:]

   * Open 'Page' and add a Custom menu entry
   * Edit Custom menu entry to
       Name:   getVideo
       Action: Command [c:getvideo] [%u save ram:]

   * Open 'Plugin File' and add a Custom menu entry
   * Edit Custom menu entry to
       Name:   getVideo
       Action: Command [c:getvideo] [%e save ram:]


7. Supported Sites
   please have a look at getVideo.html