Video Library

From MythTV Official Wiki
Revision as of 20:05, 23 January 2008 by Jamesarbrown (talk | contribs) (Clarified 'file extensions' menu for internal player setting)

Jump to: navigation, search

MythVideo allows for cataloging and playback of a variety of video file formats. It can perform automatic meta data look ups on IMDB as well as retrieve poster artwork. You can also add your own Meta data to your own videos and add custom poster artwork to videos.

It features three different "views" on your collection:

  • Browse view - Shows a single video on screen at once with its metadata.
  • Tree view - Presents your videos in a view similar to the watch recordings screen. This view can be configured to show file/subdirectories.
  • Gallery - Presents you with numerous titles at once laid out in a view similiar to MythGallery.

MythVideo can use MythTV's internal media player, to play back the video files, by specifying "Internal" as the player. Optionally, it can be configured to use external players such as Xine or mplayer.

Configuration

Selecting Folders

In the MythVideo setup (Settings-> Videos Settings-> General Settings), you can enter your video directories as a colon separated list.

Folder Images

You can place a file named folder.(png | gif | jpg) into a folder that is accessible to MythVideo and it will be used when the gallery view is displayed instead of a plain folder icon.

Internal Player

As of 0.20 the Myth Internal player now supports mpeg, vobs and a variety of formats. In particuler it will play .iso files, so whole DVDs including DVD menus and bonus material can be included
To use the Internal player in "File Extensions" set:

  • Type in file suffix (eg mpeg or avi...)
  • File Type to: "Internal" or blank
  • Default player is unticked

The Internal player uses ffmpeg so all supported codecs are documented on the ffmpeg project site . Playback decoding is controlled by the MythTV TV playback settings

Parental Controls

MythVideo supports the ability to limit what videos maybe viewed without a password/pin. There are 4 different levels that a video/file can be set at. From within the configuration you can select a default level. Any videos/files at or below that level will show up in the list. Use Video Manger to change the level of any particular video (must be done on a video-by-video case).

MythVideo will only stay at that level until you try to change the level (by hitting keys 1-4 in the Browse or List screens).


External Player Configuration

To choose an external player (mplayer, Xine, etc.), you will need to delve into your MythVideo setup.

At the main screen, scroll down to Setup, then Video Settings, then Player Settings. Here you'll see a box which contains the command line MythFrontend will launch your video file with. %s is a variable which corresponds to the file path and name of the file you're going to play. All you need to do is edit this command line to run whatever player you like. The %s string expansion appears to be broken in version 0.20; it no longer contains the entire path, but only the file name.

Please note that if you use MythVideo to launch external players, you must have a window manager configured and running so that window focus can change from MythFrontend to the media player. Compatible window managers include those built into KDE and Gnome, Ratpoison, Fluxbox, and I imagine many more.

mplayer Configuration

The default configuration uses mplayer

 mplayer -fs -zoom -quiet -vo xv %s

If you have audio sync problems, try changing the audio system to OSS

 mplayer -fs -zoom -quiet -ao oss -vo xv %s


Information.png Tip: If you want to disable xscreensaver while starting while your watching a video with mplayer add this to /home/mythuser/.mplayer/config

stop-xscreensaver=1

Mplayer Playlists

You can create a playlist containing a list of video files to play continuously one after another. This is great for music videos at a party or combining movies downloaded in several parts.

There's no way to create the playlist from within mythtv, so you'll have to log in and do it from the shell. Use any text editor to create playlist files with 1 filename per line and use the extension .pls. You can also pipe a directory listing to a file. Mplayer doesn't seem to like spaces in filenames so you'll need to rename files or they will be skipped over.

 dir * > all_videos.pls

At the main screen, scroll down to Utilities/Setup, then Setup, then Media Settings, then Video Settings, then File Types. You'll need to add a new file association for playlists and provide the command to play them.

Select New, then enter pls (without a period) and select Create new extension. Select the Command box and enter

 mplayer -fs -zoom -quiet -vo xv -playlist %s

Make sure the default and ignore boxes are not checked.

Add -shuffle after mplayer if you want them played in random order.

Don't forget to run the video manager so MythTV notices the new playlist file. The playlist file will now show up in the list of videos.

While they're playing, use < and > to jump to the previous or next file. If using a remote with lirc, the config commands to achieve this are pt_step -1 and pt_step +1.

To have a playlist dynamically regenerated each time it's played, a small script can be used as the custom command: MythVideo:playRandom.sh

Xine Configuration

Main Article: Configuring Xine

Xine is a popular media player under Linux. Xine can be configured to work with a remote control.

Running man xine from the terminal will get you an exhaustive list of the many options Xine can be run with, but the following is a good default:

 xine -pfhq --no-splash

-p specifies "autoplay", f starts in fullscreen mode, h hides the GUI (if you've installed xine-ui) and q means that xine will exit after the video finishes playing, returning you to MythVideo. --no-splash disables the splash screen that Xine usually starts with.

Further Xine Configuration

It seems that xine has a rather annoying habit of reverting back to the default keys even after configuring them, and that several functions overlap each other (the prev/next mrl function and the prev/next chapter buttons are an example). The easiest way to solve this problem is to edit the keymap file ($HOME/.xine/keymap usually) or just use the keymap editor in xine_gui if you have it installed, and set up the keys how you'd like, in my case one for watching vids and another for watching dvds. Then copy the keymap file to something similar to keymap.video and/or keymap.dvd. Then enter this as your default player (using the above configuration as a base).

xine -pfhq --no-splash --keymap=file:/path/to/.xine/keymap.video %s

This tells xine to load the keymap from the specified file. After doing this xine decided to behave and has been working nicely for some time.

Per-file Configuration

Individual videos can be configured using the video manager at Main Screen->Utilities /Setup -> Video Manager.

You can also run specified files with a non-standard command. While in the video manager, if you hit enter on a specific file, you are presented with the settings for that file. The categories here are fairly self explanatory, but in the Unique Player Command box at the bottom you can specify different parameters to launch the file with.

If your movie comes in two or more parts, you can specify the file you always want to play next under File to Always Play Next. For example, if I'm editing "A Film Too Long CD1", I can shift left and right until I find "A Film Too Long CD2" and so on. This will give you seamless playback of your chosen flick.

Metadata Lookup

MythVideo comes bundled with some cute scripts to look up details about your film over the internet. When you're in the Video Manager, hit i to bring up the info screen. Here you'll see an option to Search IMDB. Hit enter, and the script will tootle along over to the Internet Movie Database and retrieve details about the film as well as a poster of it.

Please note that the IMDB script relies on you having accurate filenames; if your film is named "@ f1lm 2 l0ng", the script isn't going to work. In this case, you can either use the Edit Metadata function to rename the movie within MythVideo and then re-attempt the Search IMDB option, or you can rename the file within the actual Linux OS. Alternatively, you can enter the IMDB reference number manually. You can get this number by looking up your film on the IMDB website, and noting the number in the URL that follows the tt. For instance, Akira http://imdb.com/title/tt0094625/ has an IMDB number of 0094625. If you type this into the Manually Enter IMDB # input, the IMDB grabber script will shoot off and grab the data for you.

In case the IMDB grabber script gets confused - sometimes different films have very similar names - the results are returned in order of popularity, as well as having their year of release shown in brackets. This should be enough for you to work out which is the correct entry.

It's also important to note that certain versions of MythVideo have issues when trying to fetch movie information with the included IMDB Script. If you aren't getting the plot, director, ratings, etc, then you are probably going to want to fix this. The steps provided below have been copied from this site. The fix is pretty simple:

First create a backup of the original script

 sudo cp /usr/share/mythtv/mythvideo/scripts/imdb.pl /usr/share/mythtv/mythvideo/scripts/imdb.pl-orig

Download the SVN Copy

 wget "http://svn.mythtv.org/trac/browser/trunk/mythplugins/mythvideo/mythvideo/scripts/imdb.pl?format=raw" -O imdb.pl

Replace the old script with the new one

 sudo cp imdb.pl /usr/share/mythtv/mythvideo/scripts/imdb.pl

Make the new script executable

 sudo chmod +x /usr/share/mythtv/mythvideo/scripts/imdb.pl

You should be all set after than.

Custom Movie Artwork

MythVideo looks for artwork downloaded from IMDB in ~/.mythtv/MythVideo. You can put custom artwork here and then in Video Manager->Edit Metadata->Cover Art you can select your custom art from the dialog box.

Playing Videos

To play videos go to the Myth Mainpage->Media Library->Watch Videos screen.

The default view is the Folder View. This view can be changed via the on screen menu by pressing the menu button.

Selecting a video will bring up it's detailed information. Selecting a second time will launch the video.

Screenshots