Introduction
------------
Tubexx is an ARexx script that enables the fruition of youtube.com
contents on your MorphOS machine.
Youtube.com is a video storage, where anybody can upload his own
videos and share them with every Internet user in the world.
Its main interface is web based, but video playback is handled via
a Flash applet, thus impossible to enjoy directly with the MorphOS
technologies currently available.
This is where Tubexx comes in handy, enabling you to search, download,
convert and play your favourite videos.


Features
--------
The main Tubexx features are:
- various search modes managed through the YouTube GData API calls
- possibility to receive standard feeds localized for different countries
- possibility to use an URL as a direct reference
- result browser that formats the results nicely and handles frames
  thumbnails
- support of video description, and possibility to use URLs found there
- a preferred video format can be set, including 3GP, FLV (SQ or larger)
  and MP4 (HQ or HD)
- support of video streaming with user definable cache size
- video download and archived video manager
- it is possible to convert videos into standard formats for common DVD
  readers
- it is possible to suggest a video via email
- integrated automatic check and download of program updates
- all functions are accessible via MUI4 GUI


History
-------
23.10.09
========
- Youtube has changed again data layout! Yet another name change for the
  keywords so even today it was necessary to modify Tubexx accordingly.

22.10.09
========
- Works with the new 'watch?v=' page layout.

09.09.09
========
Note:
  Because of my unorthodox handling of localization strings, german and
  french catalog (and others if any) are not to be used for this version
  until an update of them (otherwise some strings may appear in a wrong
  place...). I apologize for the inconvenience.
  =====
- Fixed streaming/downloading recent issue.
- Improved management of configuration data:
  - Optimized MUI gadgets attributes setting when Tubexx opens (faster?).
  - Tubexx no longer rewrites all configuration data on exit, but only
    those actually changed.
  - To speed up the initial configuration, external tools found in the
    system path are automatically placed in their respective fields now.
- Redesigned the configuration panel layout:
  - Users of the e-mail client YAM now have a field where to enter the
    direct path to the executable so they can finally remove the 'YAM:'
    assignment from their user-startup (if present at Tubexx use only).
    The 'Mail' button will remain enabled even when the optional YAM field
    is left empty because, in this case, the e-mail message body may still
    be generated in the clipboard and then be manually pasted into the
    preferred e-mail client.
  - Added countries selector. Now the contents of the standard-feeds are
    reported with relevance to the specified country.
  - Added selector for the favorite video streaming format.
    If the chosen format is sometime not available, Tubexx automatically
    fall back to the standard one but the setting will remain valid for
    the next video you want to watch.
  - Additions made to the MPlayer section:
    - Switch for the MPlayer embedded GUI.
    - The player window size can also be set for the half of the video
      resolution now (useful for HD videos).
    - Added 'never show' for the time counter OSD
    - Doubled from 8 to 16 MB the max value that can be set for caching
      streams and added control over the percentage of cache preload.
      This way we can set a large cache ammount without suffering long
      delays before playback begins.
    - Added 'framedrop' switch.
    - The 'autosync' factor for the automatic compensation of audio/video
      synchronization can now be adjusted.
- Added access to more standard-feeds.
  Tubexx now also receives <Most recent>, <Most popular>, <Most discussed>,
  <Most responded> and <Top favorites> rankings.
- Now a double-click on any list starts to stream/play the titles.
- Completely rewrote the listviews management for the local files.
  There is no more systematical refresh every time a list is brought to the
  foreground; the annoying, involuntary de-activation of the selected titles
  (with consequent preview frame dropping) so far had is now replaced by an
  smart management that operates only when refresh is necessary and that
  also auto re-enable the current selection, when appropriate. (...)
- Fixed the snapshot function that extracts a preview frame from the
  selected local file.
- Fixed down video re-encoding procedure to both AVI and MPEG.
- Fixed an error in calculating the video duration and changed the
  representation string from "hh:mm:ss" to "0h 0m 0s".
- Fixed the function that checks for Tubexx updates.
- ...many other minor tweaks, too many insurmountable obstacles (...) and
  some touch of fluorescent blue paint to get rid of the ordinary gray! ;-D

02.10.08
========
- Fixed connection failure (when checking remote server location).

28.09.08
========
- Fixed the broken FLV link redirection.

29.01.08
========
- Today YouTube has restructured his API feeds: transformation stylesheet
  modified to match the changed namespace order.
- Improved the parsing method applied to the video URLs schemes.

26.01.08
========
- Added UTF-8 (Unicode codepage) support. (Requires rmh.library v23.3+ and
  codesets.library v6.5+)
- Today the URL schemes for FLV files have been modified by YouTube: Tubexx
  now works again!

12.01.08
========
- Very wide rewrite, principally in order to support the new GData API and
  the localization.
- The dedicated web site, in english, has been opened.

26.08.07
========
- First version published, based on the Legacy API and italian interface
  only.

 PERMSSN    UID  GID    PACKED    SIZE  RATIO METHOD CRC     STAMP          NAME
---------- ----------- ------- ------- ------ ---------- ------------ -------------
[generic]                 4564    4708  96.9% -lh5- dd72 Sep  9 16:50 Tubexx.info
[generic]                 3100    6420  48.3% -lh5- b592 Sep  9 13:07 Tubexx/catalogs/italiano/Tubexx.catalog
[generic]                 5552   16677  33.3% -lh5- be95 Sep  9 13:07 Tubexx/catalogs/italiano/Tubexx.ct
[generic]                 3441    9290  37.0% -lh5- f25b Sep  9 10:33 Tubexx/catalogs/Tubexx.cd
[generic]                   77     106  72.6% -lh5- 5e41 Jan 29  2008 Tubexx/env/GUI_PREFS
[generic]                 2226    4837  46.0% -lh5- 7558 Oct 23 12:59 Tubexx/history
[generic]                 1800    1868  96.4% -lh5- b21e Sep  9 16:52 Tubexx/history.info
[generic]                 2276    2276 100.0% -lh0- e664 Sep  1 16:47 Tubexx/pix/button_convert.png
[generic]                 2156    2156 100.0% -lh0- aeb6 Jan  1  2008 Tubexx/pix/button_delete.png
[generic]                 1897    1897 100.0% -lh0- 4f4a Jan  1  2008 Tubexx/pix/button_download.png
[generic]                 2280    2280 100.0% -lh0- 23cd Jan  1  2008 Tubexx/pix/button_email.png
[generic]                 1471    1471 100.0% -lh0- a20f Jan  1  2008 Tubexx/pix/button_fold.png
[generic]                  998    1041  95.9% -lh5- 9f41 Jan  1  2008 Tubexx/pix/button_page_next.png
[generic]                  966    1000  96.6% -lh5- f3e5 Jan  1  2008 Tubexx/pix/button_page_prev.png
[generic]                 1392    1454  95.7% -lh5- 4841 Jan  1  2008 Tubexx/pix/button_play.png
[generic]                 2434    2434 100.0% -lh0- a59f Jan  1  2008 Tubexx/pix/button_reload.png
[generic]                  455     468  97.2% -lh5- 76ef Jan  1  2008 Tubexx/pix/button_stop.png
[generic]                 2798    2798 100.0% -lh0- 87de Jan  1  2008 Tubexx/pix/button_stop_connect.png
[generic]                 2992    2992 100.0% -lh0- 0d4b Sep  1 16:48 Tubexx/pix/check_g.png
[generic]                 2888    2888 100.0% -lh0- e00f Sep  1 16:48 Tubexx/pix/check_r.png
[generic]                 2989    2989 100.0% -lh0- 4471 Sep  1 16:48 Tubexx/pix/check_v.png
[generic]                 2303    2303 100.0% -lh0- cf4f Jan  1  2008 Tubexx/pix/extra_clip_video.png
[generic]                 2818    2818 100.0% -lh0- ebca Sep  1 16:48 Tubexx/pix/extra_clip_web.png
[generic]                 3354    3354 100.0% -lh0- d09f Jan  1  2008 Tubexx/pix/extra_openurl.png
[generic]                 3327    3327 100.0% -lh0- f3e2 Sep  1 16:48 Tubexx/pix/extra_update.png
[generic]                 2246    2246 100.0% -lh0- f398 Sep  2 00:41 Tubexx/pix/flag_au.png
[generic]                 1830    1830 100.0% -lh0- 1e87 Sep  2 00:41 Tubexx/pix/flag_br.png
[generic]                 1284    1284 100.0% -lh0- 22d8 Sep  2 00:41 Tubexx/pix/flag_ca.png
[generic]                 1034    1034 100.0% -lh0- f24c Sep  2 00:41 Tubexx/pix/flag_cz.png
[generic]                  345     345 100.0% -lh0- 1cf1 Sep  2 00:41 Tubexx/pix/flag_de.png
[generic]                 1024    1024 100.0% -lh0- c0d7 Sep  2 00:41 Tubexx/pix/flag_es.png
[generic]                  422     422 100.0% -lh0- 115b Sep  2 00:41 Tubexx/pix/flag_fr.png
[generic]                 2256    2256 100.0% -lh0- 139f Sep  2 00:41 Tubexx/pix/flag_gb.png
[generic]                 1334    1334 100.0% -lh0- 59bb Sep  2 00:41 Tubexx/pix/flag_hk.png
[generic]                  403     403 100.0% -lh0- 0e44 Sep  2 00:41 Tubexx/pix/flag_ie.png
[generic]                 1094    1094 100.0% -lh0- 7ddd Sep  2 00:41 Tubexx/pix/flag_il.png
[generic]                  900     900 100.0% -lh0- 88d4 Sep  2 00:41 Tubexx/pix/flag_in.png
[generic]                  418     418 100.0% -lh0- 6bee Sep  2 00:41 Tubexx/pix/flag_it.png
[generic]                 1005    1005 100.0% -lh0- d225 Sep  2 00:41 Tubexx/pix/flag_jp.png
[generic]                 1792    1792 100.0% -lh0- 1790 Sep  2 00:41 Tubexx/pix/flag_kr.png
[generic]                 1000    1000 100.0% -lh0- 7c1c Sep  2 00:41 Tubexx/pix/flag_mx.png
[generic]                  393     393 100.0% -lh0- ab75 Sep  2 00:41 Tubexx/pix/flag_nl.png
[generic]                 2048    2048 100.0% -lh0- 24ab Sep  2 00:41 Tubexx/pix/flag_nz.png
[generic]                  359     359 100.0% -lh0- ec81 Sep  2 00:41 Tubexx/pix/flag_pl.png
[generic]                  359     359 100.0% -lh0- cfd5 Sep  2 00:41 Tubexx/pix/flag_ru.png
[generic]                  715     715 100.0% -lh0- 0a5a Sep  2 00:41 Tubexx/pix/flag_se.png
[generic]                  987     987 100.0% -lh0- 5390 Sep  2 00:41 Tubexx/pix/flag_tw.png
[generic]                 1503    1503 100.0% -lh0- aa1e Sep  2 00:41 Tubexx/pix/flag_us.png
[generic]                 4127    4127 100.0% -lh0- 2d22 Jan  1  2008 Tubexx/pix/frame.png
[generic]                 4029    4029 100.0% -lh0- 355c Jan  1  2008 Tubexx/pix/frame_empty.png
[generic]                 4635    4635 100.0% -lh0- fc79 Jan  1  2008 Tubexx/pix/frame_lost.png
[generic]                 2732    2774  98.5% -lh5- 0704 Jan  1  2008 Tubexx/pix/frame_scope.png
[generic]                 7166    7166 100.0% -lh0- 155c Jan  1  2008 Tubexx/pix/frame_wait.png
[generic]                 8393    8393 100.0% -lh0- 3a5a Jan  1  2008 Tubexx/pix/frame_yt.png
[generic]                 1222    1222 100.0% -lh0- 8779 Sep  1 16:48 Tubexx/pix/paste.png
[generic]                 6603    6843  96.5% -lh5- 4d74 Sep  4 23:51 Tubexx/pix/snapshot_error.png
[generic]                 5081    5186  98.0% -lh5- f9ad Sep  4 23:51 Tubexx/pix/snapshot_scope.png
[generic]                 4668    4856  96.1% -lh5- bbe3 Sep  4 23:52 Tubexx/pix/snapshot_wait.png
[generic]                 5009    5009 100.0% -lh0- 9043 Jan  1  2008 Tubexx/pix/to_disk.png
[generic]                36601   36601 100.0% -lh0- 8aed Sep  5 18:14 Tubexx/pix/tubexx.png
[generic]                  373     373 100.0% -lh0- 5f30 Sep  5 12:02 Tubexx/pix/vq_0.png
[generic]                  518     518 100.0% -lh0- e1d5 Sep  5 12:02 Tubexx/pix/vq_1.png
[generic]                  520     520 100.0% -lh0- 6fee Sep  5 12:02 Tubexx/pix/vq_2.png
[generic]                  520     520 100.0% -lh0- 6d28 Sep  5 12:02 Tubexx/pix/vq_3.png
[generic]                  517     517 100.0% -lh0- 145b Sep  5 12:02 Tubexx/pix/vq_4.png
[generic]                 7129    7129 100.0% -lh0- fa27 Jan  1  2008 Tubexx/pix/youtube.png
[generic]                 3442    7782  44.2% -lh5- 170f Sep  9 11:02 Tubexx/readme
[generic]                 1800    1868  96.4% -lh5- b21e Sep  9 16:52 Tubexx/readme.info
[generic]                   46      46 100.0% -lh0- 0656 Jan 29  2008 Tubexx/Tubexx
[generic]                10614   10614 100.0% -lh0- 6aa3 Sep  5 18:16 Tubexx/Tubexx.info
[generic]                47963  199807  24.0% -lh5- d08b Oct 23 09:43 Tubexx/Tubexx.rexx
---------- ----------- ------- ------- ------ ---------- ------------ -------------
 Total        71 files  249013  429138  58.0%            Oct 23 17:22