Dear Wiki user, You have subscribed to a wiki page or wiki category on "Freevo Wiki" for change notification.
The following page has been changed by Brian Enigma: http://freevo.sourceforge.net/cgi-bin/moin.cgi/DocumentationPage_2fFxdFiles The comment on the change is: Removed placeholder, added content ------------------------------------------------------------------------------ @@ -1,3 +1,125 @@ -PleaseUpdate +'''Index'''[[TableOfContents]] -Describe DocumentationPage/FxdFiles here. += Overview = + +FXD files are special XML files that Freevo uses to define links to "external" media and to define the appearance of directories and files. An external source can be elsewhere in your filesystem, on cdrom, or even a DVD or (S)VCD. A DTD is provided in the Freevo installation in "Docs/freevo_XML_data.dtd," but at the time of this writing, the DTD file was outdated and no longer valid. + +The root elementin FXD files is <freevo>. + += Movies = + +Movie related FXD files contain a <movie>...</movie> tree directly under the top level <freevo> tag. The movie tag can include information about a cover image, a video source, variants (for instance, different language audio tracks), and other information. + +== Cover Image == + +The cover-img tag defines the image to use for this movie--typically a movie poster or DVD box art. A simple example: +{{{ +<freevo> + <movie title="My Movie"> + <cover-img source="movieposter.jpg"/> + [...] + </movie> +</freevo> +}}} + +== Video == + +The video tag defines all of the parts that make up a movie. For instance, a movie that spans multiple VCDs or that has been broken up into multiple AVI files. Each video definition needs to have a unique id (which may be referred to in the variants section below). + +Valid child tags for <video> are <dvd>, <vcd>, and <file>. See the DTD for additional details. + +A simple example: +{{{ +<freevo> + <movie title="My Video"> + <video> + <file id="part1" name="My Video, Part 1">file1.avi</file> + <file id="part2" name="My Video, Part 2">file2.avi</file> + </video> + [...] + </movie> +</freevo> +}}} + +== Variants == + +Sometimes movies contain several soundtracks or subtitles. On DVDs this will work automagically, but for plain files it is sometimes easier to specify it explicitly. You can use the <variants>-tags in this case. A simple example will look like this: +{{{ +<freevo> + <movie> + [...] + <video> + <file id="p1">file1.avi</file> + </video> + [...] + <variants> + <variant name="Soundtrack German"> + <part ref="p1"> + <audio>audiofile.mp3</audio> + </part> + </variant> + </variants> + [...] + </movie> +</freevo> +}}} +This will link in an extra external audio-file to be played back. The ref-Parameter in part references the corresponding file in <video>. You can then use "Show Variants" in the play-menu to select this track. However in most cases extra soundtracks are encoded into the same file. You can then try to use following structure: +{{{ +<freevo> + <movie> + [...] + <variants> + <variant name="Soundtrack German" mplayer-options="-aid 0"> + <part ref="p1"></part> + </variant> + </variants> + [...] + </movie> +</freevo> +}}} +Notice the mplayer-options parameter. With -aid <number> a soundtrack is specified. +There a different tags for audio and subtitles. For a complete reference, see DocumentationPage/FxdFiles or use the DTD file in Docs/freevo_XML_data.dtd. + +== Info == + +The info tag contains various tags with movie metadata. This includes copyright, a URL (PleaseUpdate: to the movie's homepage?), genre, year, runtime, tagline, plot, and rating. See the DTD for more info. + += Multi-Disc Sets = + +A disc-set contains a set of related discs--for example, all CD-ROMs containing files of a given TV show. + +PleaseUpdate: This needs to be researched and documented more. + += Music = + +FXD files can define an external music source, such as a net radio station. + +== Streaming Audio == + +The only real requirement here is a name and URL, but several metadata fields are provided to describe the stream. + +A simple example: +{{{ +<freevo> + <title>RadioIO 80's</title> + <logo source="/opt/freevo/testfiles/netradio/">mos.jpg</logo> + <audio> + <mplayer_options></mplayer_options> + <url>http://radioio.sc.llnwd.net:8220/</url> + </audio> + <info> + <genre>Alternative</genre> + <desc>More choices, more music. Independent. Original. Digital. RadioIO 80's.</desc> + </info> +</freevo> +}}} + +PleaseUpdate: Should the code be adjusted so that this is not all part of the <freevo> element, but instead wrapped pushed down a level such as <freevo><music>...title, logo, audio, etc...</music></freevo>? + +== Local Audio == + +PleaseUpdate (needs research): Does this support local audio files? + += Skins = + +FXD files can be used to override the appearance of an individual directory. Please see DocumentationPage/SkinInfo for details. ------------------------------------------------------- This sf.net email is sponsored by:ThinkGeek Welcome to geek heaven. http://thinkgeek.com/sf _______________________________________________ Freevo-wikilog mailing list [EMAIL PROTECTED] https://lists.sourceforge.net/lists/listinfo/freevo-wikilog
