YOUCHOOB V1.20
==============
  Author  : Joseph Cox
  Website : http://www.bootblock.co.uk
  Forum   : http://forum.bootblock.co.uk
  Support : http://software.bootblock.co.uk/?id=youchoob
  Twitter : http://twitter.com/BootBlock
  Released: 8th July, 2013.
  License : Freeware


CONTENTS
--------
Contents          - List of sections in this help file
Purpose           - The aim of YouChoob
Batch Downloading - How Batch downloading works
Upgrading         - Upgrading to new versions
Removing          - How to uninstall
YouChoob 2        - YouChoob: Rewritten
Trouble-Shooting  - Fixing common problems
History           - Release history


PURPOSE
-------
[Please note:  YouChoob v1.20  and  above use a different settings format and
thus is incompatible with previous versions.  Because of this,  any  previous
settings will be lost.]

YouChoob   is   an   application   that   allows   you   to  download  videos
directly  from  the  YouTube.com  website  and  save  them   to  a   location
on  your  system.   YC   is  the  easiest  way  to  download  videos  as  all
it requires is the URL address to the page that contains the video,  or  even
just the video's ID.

YouChoob   supports   downloading  from  all  language  versions  of  YouTube
and   will   automatically  download  the  highest  quality  version  of  all
videos, if available. (Can be changed within the Settings->Downloads area)

If  there  is  a  YouTube  link  in  the  clipboard  when   YouChoob  starts,
it'll   automatically   being  downloading  the  video  after  prompting  you
for its filename;  if  you  would  like  to  stop  it  doing this at startup,
simply hold down the Shift key when it launches.

YouChoob  will  automatically   download  high-quality  versions  of  videos,
if it detects they  are  available.  Download  priority  is  given  to  high-
definition,  then  high  quality,  and  finally  standard  quality.  YC  will
notify you of the video quality  of  the  downloading  video  in  the  Status
text.

Once a video has downloaded,  you can either left-click the video's thumbnail
image to play it, or right-click the thumbnail image for a context menu.

Statistics: v1.08 added application statistics. Opening the About window will
show  the  statistics  at  the  end  of  the  scroller.   You  can  view  the
statistics in a more complete  form  by  viewing  the  YouChoob-Stats-new.xml
file  within  your Windows user profile application directory. (%APPDATA%\)

YouChoob keeps track of the following informational statistics:

  AppLaunched: The total number of times YouChoob has been launched.
  AppRunningTime: The total duration of YouChoob's running time.
  DownloadedVideos: The total number of complete video downloads.
  DownloadedMB: The total size, in megabytes, of completed video downloads.

This information tracking can be disabled within the Settings window. YouChoob
has this statistical tracking ability as some users may  find  it  interesting
(and it was an easter egg within the About  window;  but  it  was  decided  it
would be best to explain what these stats track and why they're being tracked).


BATCH DOWNLOADING
-----------------
Since v1.06, YouChoob has supported true  multi-video  downloading,  although
it should be noted that parallel (that is, all at the same time)  downloading
of videos isn't supported as YC  wasn't  originally  designed  with  this  in
mind.

To  sequentially  download  multiple  videos  without  having to run multiple
instances,  click  on  the  Batch  Download  icon (the right-most icon on the
"Copy video page URL into box below"  section  at  the  top  of  the  window)
to open the Batch window.  The  Batch  window is simply a textbox that allows
you to place a YouTube page link on their own line.

If Monitor Clipboard is enabled (bottom of Batch window), then right-clicking
a  YT  link  from  within your browser will have YC automatically insert that
link into its own line in the batch list.  This  can save considerable effort
if you need to download a large amount of videos.

When you have finished added links to the batch list,  click  on  Save at the
bottom.  If YC isn't already downloading,  the  first  link in the batch list
will be placed into the URL textbox in the  main  window;  clicking  Download
will begin downloading that video,  and sequentially,  the rest of the videos
within the batch list.

Once the current video has finished downloading,  the next video in the batch
list (at the top) will be placed into the URL textbox  in  the  main  window,
removed from the batch list, and downloading  will  commence.  YouChoob  will
continue to do this until the last video has been downloaded.

If  "Save Batch entries across YouChoob sessions"  (within Settings -> Batch)
is enabled,  closing  the  application  and re-opening it later will preserve
the batch list so it can be continued.  If  the  video  that  was downloading
when YC was closed didn't complete,  it  will  be automatically added back to
the batch list by YouChoob when YC is closed,  so  it doesn't "go missing" at
the next program startup.

You can click Stop during the  download of videos at any time and it will not
interrupt the batch list.

If you restart YouChoob and would like to start downloading  from  the  Batch
list (and it has batch entries),  then  click on the Batch button and then on
Save within the Batch window. Then click on Download in the main window.

Please note: To help with automation,  YouChoob will not prompt you for video
filenames while downloading from the batch list.  The names are automatically
taken from the video's title within their respective YouTube.com page.


UPGRADING
---------
To upgrade your current installation of YouChoob to a newer  version,  simply
delete the YouChoob directory and extract the  new  version's  archive  to  a
location of your choice.

Work has begun on the successor of YouChoob that supports various  video  and
music sites, as well as true multi-download support.  Further information can
be found on YouChoob 2  at the following location:

    http://software.bootblock.co.uk/?id=youchoob2


REMOVING
--------
To  remove  YouChoob  from  your  system,   just  quit  the  application  and
delete  the  YouChoob  directory.  YC  does   not   store  any  data  in  the
Windows registry.

Two YouChoob files can be found and deleted at the following location:

    %APPDATA%\YouChoob-new.xml
	%APPDATA%\YouChoob-Stats-new.xml

The  "-new"  in  the filenames was added in v1.20 due to a file format change
that was incompatible with previous versions.  The new format is much quicker
at being loaded and saved, and uses even less space than the previous format.


YOUCHOOB 2
----------
YouChoob 2 is the  more  fully-featured  version  of  YouChoob  which  has been
designed from the  start  to  support  multiple  parallel  downloads.  It  also
features the browsing and downloading of videos from  subscriptions,  channels,
playlists, and more.

  http://software.bootblock.co.uk/?id=youchoob2


TROUBLE-SHOOTING
----------------
If you get an error when you  start  YouChoob,  you  will
need to download the Microsoft .NET 4.5 runtimes package.
Please beware of wordwrap in the URL:
  http://www.microsoft.com/en-gb/download/details.aspx?id=30653


Joseph Cox
(AKA BootBlock)


HISTORY
-------
v1.20; 8th July, 2013.
  - Added: Documentation and YouChoob 2 links to the About menu.
  - Other: Uses a new file format for storing settings; previous settings are lost.
  - Other: Changed parts of the interface.
  - Other: Minor changes.
  - Fixed: Now works correctly after a major (backend) YouTube site change.

v1.19; 10th August, 2011.
  - Added: Additional formats are recognised, such as WebM.
  - Added: High-quality (480x360) thumbnails are now downloaded.
  - Other: Minor interface changes and improvements.
  - Other: Download the MP4/WEBM versions of videos if FLV does not work.
  - Fixed: Now works correctly after a major (backend) YouTube site change.

v1.18; 25th March, 2011.
  - Added: Delete Incomplete Downloads to the Settings -> Downloads window.
  - Added: Donate button to the main window.
  - Other: Slight re-design of the main window.
  - Other: YouChoob will notify you if you don't have the full .NET4 installed.

v1.17; 13th December, 2010.
  - Added: Support for videos linked from profile pages (ie. "profile?user=...").
  - Other: Improved video title -to- filename conversion.
  - Fixed: Now works correctly after the recent YouTube site changes.
  - Fixed: Minimising YouChoob sent it to the system tray, even if Minimise To Tray was disabled.

v1.16; 28th August, 2010.
  - Added: Interface tab to the settings window.
  - Added: System tray support (see Settings - Interface).
  - Added: Filenames are now HTML entity decoded, where appropriate.
  - Fixed: "When All Downloads Complete" button drop-down didn't re-position correctly.
  - Fixed: The image in the taskbar preview didn't show the video thumbnail correctly. [Windows 7]

v1.15; 27th July, 2010.
  - Fixed: Now works correctly after a minor YouTube site change.

v1.14; 25th May, 2010.
  - Added: "When All Downloads Complete..." drop-down to the main window.
  - Other: Improved clipboard importing of YouTube video IDs.

v1.13; 15th May, 2010.
  - Fixed: Now works correctly after a minor YouTube site change.

v1.12; 3rd April, 2010.
  - Added: Now accepts raw video IDs.
  - Fixed: Now works correctly after a major YouTube site change.
  - Other: Downloaded video thumbnail is now of a mucher higher quality.
  - Other: Faster start-up.
  - Other: Updated BiQubic.Update.

v1.11; 3rd March, 2010.
  - Added: More recognised video formats to the selection dialog.
           Note that YouChoob could always download these formats;
		   it is merely added as a user-convenience.

v1.10; 5th February, 2010.
  - Fixed: YouChoob couldn't work out a video's title.
  - Fixed: Video Quality Selection window was displaying a taskbar entry. Removed.
  - Other: Minor interface fixes.

v1.09; 25th October, 2009.
  - Added: Internally converts embedded URLs into the correct format.
  - Other: Changed the way the "page parse failed" step works.
  - Fixed: Now works correctly after a minor YouTube site change.

v1.08; 10th October, 2009.
  - Added: Video Quality Selection option to Settings -> Downloads.
  - Added: The correct extension is used for saving based on video quality.
  - Added: Application and download statistics. See Readme.
  - Other: Replaced the About dialog with a true About window.

v1.07; 19th September, 2009.
  - Added: Do Not Prompt For Video Filename to Settings -> Downloads.
  - Added: Optional video thumbnail saving to Settings -> Downloads.
  - Other: Much better video quality detection; will download best available at all times.
  - Fixed: Now works correctly after the recent YouTube site changes.

v1.06; 19th February, 2009. (Beta)
  - Added: Native batch downloading.
  - Added: Settings window.
  - Added: Context menu to the video thumbnail image.
  - Added: Download transfer rate to the main window.
  - Added: Windows 7 download progress indication to YouChoob's taskbar entry.
  - Fixed: Minor GUI layout issue in pre-Vista versions of Windows.
  - Other: Updated help file.
  - Other: Minor tweaks.

v1.05; 29th January, 2009.
  - Fixed: Sometimes the thumbnail for the video didn't appear. This may also fix
    a rare "not a valid video" error prior to downloading.
  - Other: Minor tweaks.

v1.04; 16th January, 2009.
  - Added: Automatic support for downloading high quality versions of videos.
  - Added: Links can be dragged and dropped onto the URL textbox.

v1.03; 22nd April, 2008.
  - Added: Clicking the video thumbnail will view the video.
  - Added: Update checker.
  - Fixed: Location issue with the progress bar and thumbnail during sizing.
  - Other: General application and interface improvements.
  - Other: "Download Another Video" wasn't working 100%.

v1.02; 18th April, 2008.
  - Added: The thumbnail image of the video being downloaded is now displayed.
  - Added: YC will auto-download any YouTube links in the clipboard at startup.
  - Added: Clicking Import Link From Clipboard will begin auto-downloading.
  - Other: Slight interface modifications for when downloads start and finish.

v1.01; 15th April, 2008.
  - Added: Stop button so a downloading video can be cancelled.
  - Added: "Download Another Video" button that launches another YC instance.
  - Fixed: Accepts URLs that start with "http://youtube.*".
  - Fixed: The main window didn't size correctly.
  - Other: Now suggests a filename for the video based on the video's title.
  - Other: Executable is now signed with a strong key for security purposes.
  - Other: Modifications based on code analysis by FxCop.

v1.00; 11th April, 2008.
  - Initial public release.
