[[PageOutline(2-5,Contents,pullout)]]

= Safely embed movies of various formats into Trac wiki pages

== Description

This page is for version 2.0 documentation pypi:TracMovieMacro/0.2.

This plugin allows you to 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 other 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 new ticket].

[[TicketQuery(component=MovieMacro&group=type,format=progress)]]

== Download

Download the zipped source from [export:moviemacro here].

== Source

Check out MovieMacro using Subversion from [/svn/moviemacro here], or [source:moviemacro browse the source] with Trac.

== Installation

General instructions on installing Trac plugins can be found on the [TracPlugins#InstallingaTracplugin TracPlugins] page.

== Example

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

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

'''MetaCafe''': 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 is at a premium, download the flash-video file (.flv) and save it in your project's htdocs directory. For !YouTube movies, 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 your Subversion 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:''' [[Maintainer]] [[BR]]
'''Contributors:'''