Skip to content
ge2301 edited this page Jan 14, 2024 · 6 revisions

Introduction

This plugin integrates websites that host videos or stream live tv into MediaPortal. Examples are YouTube and wwitv.

The videos/streams can be discovered by reading RSS feeds, parsing HTML, programming against provided APIs or directly adding urls of live streams. Only direct links to video files or streams (.flv, .mp4, ...) are supported, because they will be rendered using directshow. This allows usage of your favorite codecs to control audio and video quality (e.g. using ffdshow you can upscale low quality videos as well as upmix stereo sound and output to spdif) and gives the best integration with MediaPortal.

Remark: The information below are only valid for MediaPortal 1. For MediaPortal 2 please refer to our wiki.


Features

  • automatic (by language) and user defined grouping of sites
  • thumbnails for sites, categories and videos/streams
  • pin to protect adult sites
  • search (on sites that support search)
  • paging in video and category lists
  • download videos (concurrent or queued)
  • multiple quality playback choices
  • add videos and categories to a Favorites site
  • play all videos currently shown
  • play with Windows Media Player, VLC media player
  • automatic updating of sites (with restarting)
  • integrated SiteManager to add and remove sites
  • configuration of plugin and site settings (without restarting)
  • fully localized interface

User Interface

The main view of the plugin at first shows a list of languages represented by flags that is build from all sites in your personal list. This automatic grouping of sites can be disabled or customized. Selecting a group will show all sites for it. By selecting a site you can dive into the categories for that site. If a category has subcategories (e.g. Miro), by selecting a category you will dive into the subcategories recursivly, otherwise a list of videos for that category is shown. Each of these 4 views can be shown as a list, small thumbs or large thumbs. Some sites support a details view that provides more information and a list of clips for a movie.

groups view

The default view, that will be shown upon entering the plugin.
Screenshot_B3W_AutoGroupByLanguage

sites view

You can order the list of sites by Name or as defined in your local xml.
Screenshot_B3W_Sites_SmallIcons

site context menu

When a site has configuration options that the user can change, the context menu (F9) will allow to modify them.
Screenshot_B3W_Categories_SideMenu

categories view

Shows a list of categories with thumbs. If the number of videos in a category is known, it will be displayed right aligned in the list mode.
Screenshot_B3W_Categories

videos view

Example for the video view with large icons. In the lower part, the title, a description and the runtime as well as the publication date (if known) of the selected clip are displayed.
Screenshot_B3W_Videos_LargeIcons

video context menu

  • play with ... to chose Internal, WMP or VLC player
  • play all videos currently showing
  • add to favorites / delete from favorites (when displaying Favorites)
  • download video (only visible when download folder was set in config)
  • delete file (only when showing DownloadedVideos)
  • custom entries depending on the site (e.g. show related videos on YouTube)
    Screenshot_B3W_Videos_ContextMenu

details view

This screen is only available on sites that have multiple choices for a video (e.g. iTunes Moview Trailers and IMDB)
Screenshot_B3W_DetailsView_AppleTrailers

side menu

  • change layout: list, small icon, large icon
  • search (+category to search, if available)
  • max results, sort method, timeframe, refresh
  • Pin (enter the pin to enable adult content)
  • SiteManager (update, add or remove sites)
  • Settings (when the MPEI plugin is installed)

Screenshot_B3W_Videos_SideMenu


Configuration

The configuration form for the OnlineVideos plugin has four tabs where you can configure all aspects of the plugin. After you have done your changes make sure you close the MediaPortal configuration tool pressing OK, to save all data stored only in memory.

General

  • displayed name of the plugin in MediaPortal classic home screen
  • pin used for protection of sites with adult content
  • folder where downloaded videos should be saved
  • folder where thumbnails are saved
  • timeout for cached data from the internet
  • enable/disable extended search history
    Screenshot_Configuration_General

Groups

  • classify your sites into groups that will be shown as top level view when entering OnlineVideos
  • turn automatic grouping by language on/off

Sites

  • change the order of sites
  • delete, create and import or publish/update sites
  • edit settings that the util of that site exposes (e.g. quality for videos on YouTube)
    Screenshot_Configuration

How to add live-streams

  • Create a new site ( Add ) or select the site where you want to add the live streams and press Edit (edit).
  • Create a new group (NewFolder) in the lower part and fill the name and optional url of a logo
  • Select that group and add a new stream(tv)
  • Fill the streamname, streamUrl (remember: this must be the direct url of the stream, and not some url to a page with a flashplayer playing that stream), and optionally the url of the logo.
  • Save, Start Mediaportal and enjoy.

Codecs

On the Codec tab, you can test your system for playback of different video types. If playback succeeds here, it will tell you what filter is used to split the file into audio and video and you should have no problems playing files of that type in MediaPortal.