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

== Description ==

Embed online movies from [https://www.youtube.com/ YouTube], [http://www.metacafe.com/ MetaCafe] and [https://vimeo.com/ Vimeo], 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 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.

It's available if you want to install from PyPI.

 - https://pypi.python.org/pypi/TracMovieMacro

== Configuration ==

Default parameter can be set in trac.ini.

{{{ #!ini
[moviemacro]
width = 320px
height = 180px
splash = black.jpg  ; should be put /deployed/to/movie/htdocs/img/
}}}

**Notes:**

For attachments, Flowplayer try to resolve appropriate size ignoring width/height settings since flowplayer settings has `adaptiveRatio=true` by default in MovieMacro. It's preferred that adjusting player size automatically than particular size in almost every case.

If you won't the behavior, pass `adaptiveRatio=false` as a query string and `style=width: 320px; height:240px;` parameter.

 - see also: https://flowplayer.org/docs/setup.html

== Example ==

To understand [wiki:lcordier] better.

=== Embed youtube video ===

{{{ #!sh
[[Movie(http://www.youtube.com/watch?v=9dfWzp7rYR4&start=5&rel=0,style=width: 320px; height:240px;)]]
}}}

Player's parameter can be passed as a query string.

 - see also: https://developers.google.com/youtube/player_parameters

=== Embed metacafe video ===

{{{ #!sh
[[Movie(http://www.metacafe.com/watch/1768855/the_size_of_all_planets_are_relative/)]]
}}}

=== Embed vimeo video ===

{{{ #!sh
[[Movie(http://vimeo.com/106808835)]]
}}}

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://rg3.github.io/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:

* Simple form if an attachment is in the ticket/wiki.
 {{{ #!sh
[[Movie(sample.webm)]]
}}}

* Restricted ImageMacro format style
 {{{ #!sh
[[Movie(ticket:123:sample.mp4)]]
[[Movie(wiki:test/sub/sample.mp4)]]
}}}

* Fully qualified form.
  * 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:'''