[[PageOutline(2-5,Contents,pullout)]]
= Safely embed various movies into wiki pages =

== Description ==

Embed online movies from [http://www.youtube.com/ YouTube], [http://video.google.com/ GoogleVideo] and [http://www.metacafe.com/ MetaCafe], and local movies via [http://flowplayer.org/ FlowPlayer]. If you want support for more online sites just create a ticket.

Adds support for preview rendering of movies in the browser and on attachment pages. For preview rendering to be available for all attachments, set the `max_preview_size` in the `[mimeviewer]` section of `trac.ini` to be greater than or equal to `max_size` in the `[attachment]` section.

== Bugs/Feature Requests == 

Existing bugs and feature requests for MovieMacro are 
[query:status!=closed&component=MovieMacro&order=priority here].

If you have any issues, create a 
[/newticket?component=MovieMacro&owner=lcordier new ticket].

== Download and Source ==

Download the [download:moviemacro zipped source], check out [http://trac-hacks.org/svn/moviemacro using Subversion], or [source:moviemacro browse the source] with Trac.

== Example ==

To understand [wiki:lcordier] better.
{{{
#!sh
[[Movie(http://www.youtube.com/watch?v=XUfH-BEBMoY,width=425px,height=344px)]]
}}}

To see an overview of the Scrum development methodology...
{{{
#!sh
[[Movie(http://video.google.com/videoplay?docid=-7230144396191025011)]]
}}}

To see our scale in the universe...
{{{
#!sh
[[Movie(http://www.metacafe.com/watch/1768855/the_size_of_all_planets_are_relative/)]]
}}}

For countries where bandwidth comes at a premium, I would recommend you download the flash-video file (.flv) and save it in your project's htdocs
directory. For !YouTube movies I would suggest you try [http://www.arrakis.es/~rggi3/youtube-dl/ youtube-dl].

Then reference your file like so:
{{{
#!sh
[[Movie(htdocs://site/filename.flv)]]
}}}

You can also attach the file to a ticket, wiki page or keep it in you SVN repository. Reference the file like so:

 * from your project's htdocs: `htdocs://site/filename.flv`
 * from a plugin's htdocs: `htdocs://plugin/dir/filename.flv`
 * from an attachment on ticket `#123`: `ticket://123/filename.flv`
 * from an attachment on a wiki page: `wiki://WikiWord/filename.flv`
 * from your SVN repository revision `[1024]`, you can also use `HEAD` as your revision: `source://1024/trunk/docs/filename.flv`

== Recent Changes ==

[[ChangeLog(moviemacro, 3)]]

== Author/Contributors ==

'''Author:''' [wiki:lcordier] [[BR]]
'''Maintainer:''' [wiki:lcordier] [[BR]]
'''Contributors:'''