MythNetvision is a plugin designed to make adding Internet video sources to MythTV fun and easy. MythNetvision consists of two components-- a search screen and a site/RSS browser screen. When installed, MythNetvision appears on the Media Library screen as the options "Search Internet Video" and "Browse Internet Video."
MythNetvision has the following prerequisites:
- MythBrowser properly installed and configured.
- The Adobe Flash plugin installed.
- The Myth Python Bindings properly installed and configured (including a functioning config.xml on all frontends).
Subscribing to Search Scripts, RSS, and Site Maps
Because it is possible that many scripts will become available for MythNetvision, you must select those search and site mapping scripts that you wish to see on each frontend. RSS subscriptions are persistent across all frontends. First, you should subscribe to site grabbers and and RSS feeds you wish to view from the plugin.
Choosing Site Map Scripts
From the Media Library menu, select the Browse Internet Video menu option and press MENU (M). Select Scan/Manage Subscriptions, then Manage Site Subscriptions. The system will spend a few moments polling the installed scripts in your MythNetvision script directory (/usr/local/mythtv/mythnetvision/scripts for many packaged installs) and present you with a menu filled with all available site map scripts. Simply select those sites you wish to be able to browse, then press escape. There will be a short pause as the configuration is saved.
Adding RSS Subscriptions
From the Media Library menu, select the Browse Internet Video menu option and press MENU (M). Select Scan/Manage Subscriptions, then Manage RSS Subscriptions. If you have no RSS subscriptions yet, you will see a nearly blank screen with an option to add a new feed. Click this button to add a new RSS subscription.
On the next screen, you will see options to edit the title, URL, description, author, cover image, and download status of the feed. The only field that must be filled in is the URL. If the RSS feed is properly parsable, all of the rest of the information will be filled in and the preview image will be downloaded to ~/.mythtv/MythNetvision/sitecovers. Simply type in a video RSS feed URL, click Save, and in a few moments you should see the subscription in your list of RSS feeds.
When you are done subscribing to feeds, press Escape to return to the Video Browse Screen.
Choosing Search Scripts
From the Media Library menu, select the Search Internet Video menu option and press MENU (M). Select Manage Search Scripts. The system will spend a few moments polling the installed scripts in your MythNetvision script directory (/usr/local/mythtv/mythnetvision/scripts for many packaged installs) and present you with a menu filled with all available search scripts. Simply select those sites you wish to be able to search, then press escape. There will be a short pause as the configuration is saved.
Populating RSS and Site Maps
After setting up your site maps and RSS feeds, you will need to download and parse each. To do so, select MENU (M). Select Scan/Manage Subscriptions, then Update RSS or Update Site Maps depending on which you wish to update. This process can take several minutes if you have many feeds or multiple large sites subscribed. Ultimately this updating will occur in the background, but the current release requires this manual update process to prevent freezing up the user's frontend when the updating takes place.
Use of MythNetvision
Gallery, List, and Browse Views
Like its local counterpart MythVideo, MythNetvision has three different fully themeable views: Gallery, List, and Browse mode. Because the information used is similar to that found in MythVideo, the interface should feel comfortable for users of that plugin. To change views, select MENU (M). Select Change View, then choose from the available views.
Browsing and Viewing Videos
To browse the site, simply navigate the tree like a directory structure according to your interest. When you have found a video you wish to watch, select with by pressing Enter/SELECT to view it on the web. If the video is downloadable, you can also press MENU (M) and choose Save This Video. Presently, downloaded videos are save to ~/.mythtv. This will change as the plugin integrates more tightly with Myth's own recording functionality.
Searching for Videos
From the Media Library menu, select Search Internet Video. You will see a list of your chosen search scripts, and a search text entry box. Simply type in a search term, select the site you wish to search, and press Enter/SELECT. After the busy dialog closes, you should see a list of search results for your term (if any were found). Each site returns different numbers of results and there may be more than one "page" of returns. To navigate through result pages, press MENU (M) and choose Next Page or Previous Page as necessary. To view or download a video, simply select it or (if downloadable) select Save This Video from the menu.
The most common issues in using MythNetvision are actually issues with the Flash Plugin. Here are some common issues.
For all crashes when the browser is running that do not fall into the below questions, please open a ticket against MythBrowser. For crashes in the MythNetvision interface, please report bugs to the users mailing list.
Help! I can't escape out of a video!
The Flash Plugin steals focus when the mouse hovers over it. When using the MythNetvision plugin it is best for the mouse to be in the bottom corner of the window so that you can escape from a video when it is finished.
Help! I clicked the player controls on a flash player and now I *really* can't escape out of the video!
As mentioned above, the flash player steals focus. The easiest way to fix this is to click on another focusable widget in MythBrowser like the address bar/history at the top, then escape.
I found a site which consistently crashes MythBrowser but Firefox behaves with!
First thing you might want to try is a different MythTV window resolution. Sometimes the flash player will bring down the frontend at one resolution, but not another. Please do report the bug against MythBrowser if it's easily reproduceable.
In the Youtube search/map, some videos open fullscreen, others as a web page. What gives?
The URLs returned to MythNetvision are all provided by the grabber script, and the plugin itself has no notion of what a fullscreen link is. In the case of the YouTube grabber, not all videos are allowed to be played in the "embedded" mode the the script returns. This is sometimes because the rights holders permitted it to be posted but not embedded. The grabber script makes its best effort to return what it can. Even in these cases, you can usually click the "full screen" link in the youtube flash player to get a fullscreen playback.
The goal is to make MythNetvision extremely expandable and fun by relying on standardized XML/RSS format to build grabbers. If you are interested in adding support for a new site to MythNetvision, please see the MythNetvision Grabber Script Format for more details.