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 scriptable 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 of PS3 Media Server and the latest version of Java.



To upgrade to a new version of the plugin:

  • check the release notes to see if there are 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.


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.
  • 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 is in the profile directory (see here for the default locations).
  • 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.
  • 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-2012 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.