Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Web video plugin for PS3 Media Server
Groovy Java C Perl Other

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.


This is a plugin for PS3 Media Server (PMS) that adds configurable support for web video streaming.


PMS doesn't support web streams for the Xbox 360. PMSEncoder should work on all other platforms/renderers supported by PS3 Media Server.

These instructions assume you have the latest version (bottom post) of PS3 Media Server, the latest version of Java, and a recent (post June 2010) MPlayer/MEncoder.


  • download the PMSEncoder jar file and place it in the PMS plugins directory
  • shut down PMS; open PMS.conf in a text editor; and add pmsencoder to the front of the list of engines e.g.
    • engines = pmsencoder,mencoder,tsmuxer,mplayeraudio &c.
  • restart PMS


To upgrade to a new version of the plugin:

  • check the release notes to see if there any breaking changes or other incompatibilities
  • replace the old jar file in the plugins directory with the new version and restart PMS


To uninstall PMSEncoder, remove the jar file from the plugins directory and remove pmsencoder, from the list of engines in PMS.conf.


To build PMSEncoder from source, see the Wiki.


  • To work around the PMS bug that causes web video playback to be delayed for ~40s, uncheck "HTTP Engine V2" in the PMS "General Configuration" tab. This can also be done by setting http_engine_v2 = false in PMS.conf. Then restart PMS. See below for caveats.
  • To take PMSEncoder for a spin, try this WEB.conf, which contains a list of feeds that are regularly tested and updated.
  • For help with particular feeds/streams/sites, see here.


  • Make sure you're using the latest version of PMS and the latest version of PMSEncoder.
  • Make sure the WEB.conf and the edited PMS.conf are in the profile directory (see here for the default locations).
  • If PMS.conf doesn't exist, create it by clicking the "Save" icon in the PMS GUI.
  • If the list of engines doesn't exist in PMS.conf, follow the instructions here.
  • Make sure there's only one version of the plugin in the plugins directory.
  • Make sure the error is reproducible after a PMS restart. Caching in PMS and/or the PS3 often produces one-off errors.
  • Make sure pmsencoder is still first in the engines list.
  • If you disabled "HTTP Engine V2", try re-enabling it as some renderers, such as the Sony Bravia KDL-37V5500, require it.
  • Make sure mencoder_path is not set (or is not pointing to the old, standalone version of PMSEncoder).
  • Internet Explorer saves .jar files as .zip files. Either save the file with a different browser, or rename it, replacing the .zip extension with .jar.
  • Check the PMS trace, PMS debug.log, and pmsencoder.log (which should be in the same directory as the debug.log) for errors.

Reporting Issues

Please do the following when reporting any issues:

  1. restart (or start) PMS
  2. try to stream a web video
  3. wait until it fails
  4. post your PMS.conf, WEB.conf, pmsencoder.log and debug.log as a zipped attachment


For more details, discussion and troubleshooting tips, see the wiki and this thread (start here).




Copyright 2009-2011 chocolateboy.

PMSEncoder is free software; you can redistribute it and/or modify it under the terms of the Artistic License 2.0.

Something went wrong with that request. Please try again.