Murnong
	Version 1.40 (21-Nov-09)

Given a webpage saved from the YouTube website, Murnong launches Wget to fetch the linked video. A downloaded FLV video may in turn be given to Murnong to generate an MPEG copy, using FFmpeg, which KinoAmp can play.

"Murnong" is an Aboriginal name for an Australian native plant also known as "Yam Daisy". Once common across a widespread region of southern Australia, its tuber was a very important food source for Aborigines. But the wholesale introduction of exotic grazing animals led to its near extinction. It is still endangered.

Contents

Requirements

In principle, any machine running RISC OS 3.10 or later can launch Wget to fetch videos from YouTube's website. However, the conversion of videos from FLV to MPEG requires a StrongARM or newer processor due to the demands of FFmpeg. A detailed list of requirements follows with links to software current at time of writing.

• 2MB system RAM for downloading, 8MB system RAM for conversion. Wget needs over half a megabyte to start. FFmpeg needs over 2MB to start and over 4MB in operation.
• For video conversion, ARM architecture version 4 or later. In pragmatic terms, this means a StrongARM RiscPC, Iyonix or A9home.
• The SharedUnixLibrary module, version 1.07 or greater. A !System update containing this module can be obtained through http://www.riscos.info/index.php/SharedUnixLibrary.
• Wget version 1.10 or greater. This must be runnable as a *command; that is, either by Run:wget or by <Alias$wget>. A !Wget application can be obtained through http://www.riscos.info/packages/NetworkDetails.html.
• !KinoAmp to play the converted video. This application can be obtained through http://users.skynet.be/Andre.Timmermans/image/kinoamp/kinoamp.htm.

The DDEUtils module is highly recommended, particularly with RISC OS 4 or later. If you don't already have it, a version can be obtained from RISC OS OPEN. It should be installed in System:Modules.

Installation

Murnong comes in parts which you select and assemble to suit your computer and the functionality you want. A full !Murnong package is made of three (3) parts. Part 1 is a common baseline and provides the video fetching functionality. Part 2 adds some files needed for video conversion. Part 3 completes the video conversion functionality if required; it comes in three variants to cater for various RISC OS platforms. (If in doubt, choose the StrongARM RiscPC variant.)

• If you want only to fetch videos, download and install Part 1.
• If you want to fetch and convert videos with !FFmpeg, then download and install Parts 1 and 2.
• If you want to fetch and convert videos, but without a full !FFmpeg installation, then download and install Parts 1 and 2, and a Part 3 variant.

Essential	Part 1	For all systems	DOWNLOAD (118 Kbytes ZIP)	Download and install this core part to run Murnong. Sufficient to fetch videos. (Updated 21 November 2009)
Optional (for video conversion)	Part 2	For all systems	DOWNLOAD (823 Kbytes ZIP)	Download and add to your Part 1 installation to support video conversion. (Updated 15 July 2008)
	Part 3	For Iyonix	DOWNLOAD (772 Kbytes ZIP)	Download one and add to your Part 1 & 2 installation to enable video conversion without !FFmpeg.
		For A9home	DOWNLOAD (776 Kbytes ZIP)
		For StrongARM RiscPC	DOWNLOAD (767 Kbytes ZIP)

It is possible to have two, or even three, of the customised FFmpeg variants installed at once. (And !FFmpeg too!) But contrary to what you might expect, Murnong's default behaviour is to choose the variant that will work more widely, rather than the best performer. You can change this behaviour after installation; see the section on customisation in the manual.

Caveats

Murnong depends upon the implicit norms of YouTube's webpages. It is quite likely that any changes to YouTube's website organisation will cause Murnong to stop working. Therefore, you should consider Murnong to be a perpetual work-in-progress.

Murnong was developed and released without the knowledge or authorisation of YouTube. It is not intended to infringe the rights of YouTube or its Users. Nor is Murnong intended to hinder YouTube in conducting its business. This application is merely intended to narrow the gap between RISC OS and other operating systems with regard to the capability of viewing content provided by YouTube. However, it is possible that by using Murnong you may breach clauses 4C and 5B of YouTube's Terms of Use (as last checked on 16 August 2008).

Licence

!Murnong is Copyright (©) 2008-2009 Christopher Martin <belles AT internode on net>. All rights reserved.

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.