Xbox Frontend

From MythTV Official Wiki
Jump to: navigation, search

Warning.png Warning: The original Xbox does not have sufficient memory, processor, or graphics performance to make a worthwhile MythTV frontend.

An Xbox makes an adequate standard definition MythTV front end. The menus within MythTV aren't exactly snappy but it's good for the price. Sadly, the Xbox cannot handle decoding HDTV resolution (the CPU isn't very powerful).

Running Mythfrontend on Linux

Install a Linux distribution

MythTV can be installed on an Xbox by installing a Linux distribution on a modded/softmodded Xbox. One distribution that works well is Xebian - see the [1].

For the purposes of this HOWTO, follow the Xebian HOWTO but ignore the sections on digital audio output and Compiling the ALSA kernel-module.

Installing the MythTV front end

There are several options to install the MythTV front end:

  1. Install MythTV on Xebian stable (sarge) with pre-compiled binaries - see the Xbox_Frontend_on_Xebian_stable for more information.
  2. Install MythTV on Xebian unstable (sid) with pre-compiled binaries - see the MythTV on Xebian HOWTO for more information.
  3. Compile MythTV using the released source code
  4. Compile MythTV using the latest SVN snapshot

Configuring the MythTV front end

Section for Configuring the Xbox MythTV to talk to the MythTV Backend

Other configuration issues/notes

Section for other Xbox configuration issues eg. Digital sound eg. Video quality eg. Overscan

  • If you run Hauppage cards or record to mpeg2 don't try picture in picture. The XBox is just too slow.
  • The XBox is incapable of doing high definition due to lack of processing power and XvMC.
  • The XBox is incapable of decoding H.264 broadcasts, even in standard definition, due to CPU constraints.
  • When using the sample startup scripts on the howto's above it seems to startup two mythfrontends which brings the xbox to a halt.
  • The ALSA driver has no access to hardware volume controls. You can get around this by following the directions at Xbox Sound

Running XBMC with native MythTV Support

The XBMC (XBox Media Center) is an Open Source project (nothing to do with Microsoft!) that is based on MPlayer. It now also has linux and windows editions.

Native support for the MythTV frontend has been added to XBMC starting with revision 11787. The stable 8.10 release has support for mythtv.

Download.png - Download for linux and windows

Download.png - Download for XBox

SVN builds may or may not work better if you have trouble. Information on acquiring and installing an SVN build of XBMC can be found on the XBMC wiki: Installation Requirements


  • Currently Supported
    • Watch Recordings
    • Delete Recordings
    • Program Schedule
    • Watch Live TV
    • Choose to record a program while watching Live TV
  • Currently Not Supported
    • Commercial Skip
    • Schedule recordings for future programs
    • Edit Recording Schedules
    • Group Recordings by program

Add MythTV as a Video Source

  1. Once XBMC is installed and running on your Xbox go to "Videos" and select "Add Source"
  2. In the "Enter the paths or browse for the media locations." field you will need to enter the properly formatted username, password, and IP information for your mythconverg database. This information should be prefixed with "myth://" and follow standard linux network access formatting of: "username:password@ipaddress". For example, if your mythbackend is located on a machine whose ip address is and uses the username "mythtv" and the password "password" you should enter the following:
  3. Input a name for this source in the "Enter a name for this Media Source" field. This name is what will appear in the "Videos" list of XBMC.
  4. Click on "OK" to add this source to the "Videos" list.

Be careful that your machine to be running XBMC can resolve the hostname used by your mythbackend to an IP address; it may be necessary to edit your hosts file (C:\WINDOWS\System32\drivers\etc\hosts and /etc/hosts for Windows and Unix/Linux respectively). If your mythbackend is on a machine named 'foobar'. You with the same IP address as before, you may need to add the following to your hosts file:    foobar
And for your video source, enter the following:

Deleting programs

Delete functionality is available but may not be enabled by default.

  1. From the main menu of XBMC select "Settings"
  2. In the "xbox media center Configuration" menu select "Appearance" and scroll down to "View Options"
  3. Highlight and select the "Allow File Renaming and Deletion" check box near the bottom of this menu dialog.

You should now be able to delete recorded programs. This is done by highlighting the program you want to delete (from within the "Videos" menu), pressing "info" on the xbox remote control and selecting "delete".


Adding PVR functionality to XBMC was submitted and approved as a 2008 Google Summer of Code project. One of the goals of this SOC project:

"My proposal is to bring one aspect which until now has been missed in XBMC to fruition: Digital TV playback & recording scheduling facilities, and specifically, implementing control over the popular MythTV backend."

This should bring most if not all of the MythTV frontend functionality to XBMC. According to the official timeline, we may see the fruits of these labors sometime in the fall of 2008.


The ip address of your xbox must have permission to access the mysql database. For more info, see: Modifying access to the MySQL database for multiple systems

Remember to check the xbmc log if you are having problems.

If you can see the list of channels, but not watch any, and the log mentions connection or resolving problems, you may need to make an advancedsettings.xml file in the UserData folder with the following contents.
  <entry name="server"></entry>

replace server with your backend hostname, and give the right IP. This applies even when you specified the IP in the myth:// source line, because it seems to fetch the hostname from the db regardless, and if there is no DNS server it won't find the right IP. Changing the player to mplayer is not necessary, but can help if you get freezing.

Running XBMC MythTV Frontend Python Script

The XBMC MythTV frontend is a Python Script that works in a similar fashion to the original Mythfrontend without the overhead of running Linux or XWindows on your xbox. However, the release doesn't work with 0.21 or above (though there may be support in CVS), and has been mostly replaced by the native support.

Install XBMC MythTV

Download the latest version from and install as per the included readme.txt instructions.

1. Xbmcmythtv requires that you share your mythtvbackend video recording via Samba. xbmcmythtv will fail if Samba is not configured properly, or xbmc cannot connect to the Samba share. If you have authentication turned on, you may have to specify a URL such as this one:


If you are having issues getting xbmcmythtv to work, verify that you can connect to the Samba share from another computer. Also verify the permissions on the directories are set so that any user can get to the recordings directory.

One setting in the smb.conf that is different than the default is in the "global" section. Making the following update is not very secure. Edit the /etc/smb.conf, or on openSUSE: /etc/samba/smb.conf, file and in the "global" section near the top add the following line:

      security = share 

This is an example of a definition of a "mythtv" share. Be sure to update the "path" variable to match your recording storage location.

      comment = Television 
      browseable = yes 
      path = /var/video 
      public = yes 
      read only = yes 
      writable = no 

Assuming the configuration above was used, the file prefix to the shares would be:


... and the live prefix would be:


This means that the ring buffer files are created in the same directory as the recorded show .nuv files (i.e. /var/video). Also, the myth database populates the host field in various tables so that %h expands correctly. Some people have had problems with this so I sometimes suggest that they just replace it with the IP of the back end server...Gimblefoot

Restart samba.

openSUSE run:  /etc/init.d/smb restart 

2. Upload the xbmcmythtv directory and everything below it to your XBMC/scripts directory on your xbox. So after you have done this, you should have a XBMC/scripts/xbmcmythtv/ dir on your xbox.

3. Run the script and go into the Settings screen to specify your connection details and paths. (in versions newer than 0.20.31 was replaced by

  Mythtv host: Enter the hostname / ip-address of your mythtv backend
  Mythtv port: Use default setting value
  Mythtv statusport: Use default setting value
  Mythtv protocol: Edit to correct Mythtv Protocol Version
      mythProtocolVersion = "8"    # 0.15.1
      mythProtocolVersion = "13"   # 0.16
      mythProtocolVersion = "14"   # 0.17
      mythProtocolVersion = "15"   # 0.18
      mythProtocolVersion = "17"   # ???
      mythProtocolVersion = "19"   # ???
      mythProtocolVersion = "26"   # 0.19
      mythProtocolVersion = "27"   # 0.19 SVN
  Mythtv minlivebufsize: Use default setting value
      Set the XBMC LAN video cache size (Settings -> System -> Cache -> Video Cache - Local Network) 
      to 1024 (not higher than 1536). Xbmcmythtv use this cache setting when the LiveTV start.
      From xbmcmythtv forum: know you don't need to set any cache settings as xbmcmythtv 
      will just grab the settings straight from XBMC and use that. The one set in xbmcmythtv is redundant. Frooby
      ...your live TV issue has to do with your buffer settings in XBMC and xbmcmythtv. 
      You need to lower your Video/LAN buffer XBMC setting down to around 1MB 
      and set the xbmcmythtv min ring buffer size to 700000 bytes.
      The default Video/LAN buffer setting is 4MB so XBMC tries to read 4MB right away from the ring buffer. 
      However, the ring buffer doesn't have 4MB to start with so XBMC thinks it has reached the end of file 
      after 2 seconds of playback. 
      You can fix this in two ways: lower the Video/LAN buffer size or increase the minimum ring buffer size 
      before playback is started. The issue with the first option is that your video playback might be choppy 
      if the value is set too low. The issue with the second option is that the larger the minimum ring buffer size,
      the longer before playback will start. The values I suggested above are what I personally use. 
      They seem to be a fairly good compromise but you can fiddle with the values if you want to experiment...Gimblefoot

  Mythtv tunewait: Use default setting value 
      Time to wait while mythtvbackend tune to channel and record the livetv .mpg file
  Mythtv startpage: Change to the prefered default start page
      [2,"Recorded Shows"
      [3,"Program Guide"
      [5,"Upcoming Shows"
  Mysql host: Edit to mythtv backend ip-adresse
  Mysql port: Use default setting value
  Mysql database: Use default setting value
  Mysql user: Use default setting value
      You also need to grant xbmcmythtv access to your MythTV MySQL database.
      shell> mysql --user=root mysql
      -> ON mythconverg.*
      -> TO 'mythtv'@'xbox_ip'
      -> IDENTIFIED BY 'mythtv';
      AND make sure that mysql is accessible on the network:
      comment out skip-networking in /etc/mysql/my.cnf 
      (add a # before it so it looks like: #skip-networking)
   Mysql password: Use default setting value
   Paths recordedprefix: Change to mythbackend recordings SMB path
      smb://h%/mythtv/recordings (smb://h%/SMB_share_name/recording_catalog)
      One of the things I have noticed with xbmcmythtv is that you may have to use an ip-address 
      instead of the variable /%h/ in the recordings and the buffer path in the xbmcmythtv settings screen.
      From xbmcmythtv forum: The usual reason this does not work is if Myth TV 
      does not populate a fully qualified domain name. XBMC cannot resolve simple host names 
      but it can resolve fully qualified domain names (Gimblefoot). 
   Paths livetvprefix: Change to mythbackend buffer SMB path 
      With Mythtv 0.19 mythtv recordings and buffer path are the same
   Paths localcopypath: Use default setting value
      The catalog E:\videos must exist on the xbox

4. On the settings screen, make sure that the connections test successfully then save your settings.

5. You should now be able to use the rest of the buttons on the main menu displayed by

Common problems:

       - mysql database/table permissions 
       - mythbackend on visible ip 
       - not having a recent build of XBMC 
       - not using a version of XMBC MythTV that matches the MythTV backend 
       - not having samba shared recordings/livetv directory 
       - MySql >= 4.1 Client does not support authentication protocol...

Optional installation includes Replacing a shortcut on the main XBMC screen:

1. Edit the XBMC/skin/Project Mayhem III/PAL/Home.xml skin file (use XBMC/skin/Project Mayhem III/PAL16X9/Home.xml if you have a widescreen)(this is a XBMC skin file - not one included with these scripts).
2. Look for a "<description>My Programs normal push button</description>" (or Pictures, Movies, Music, etc).
3. Edit the control as follows:

   - set the label attribute to "My TV".
   - set the onclick attribute "xbmc.runscript(q:\scripts\xbmcmythtv\".

4. Reboot xbox or reload skin to show the skin change.

A second optional method would be to place it in the scripts popup menu (the little blue arrow next to the shutdown button).

1. Go into your scripts
2. Select the xbmcmythtv script and push the white button
3. Select add to favorites.

Broken Link -> An excellent article on this can be found here:

Broken Link -> Google Cache of Link

Working Link -> Wayback Machine Cache

Xbmcmythtv forum can you find here:

Other guides and sources of information

Installing MythTV with MythTV-Xbox (MXB) Installer by Dennis Cartier - 0.4.5 seems to be for MythTV 0.18 only (Good reference, but out of date and the install script is not maintained anymore, which means it doesn't work.)

MythBox for XBMC

XBMC MythTV Script

XBMC - XBox Media Center

MythTV / Xebian guide - for 0.18.1 and upgrading to 0.19