Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Newer
Older
100644 64 lines (41 sloc) 4.227 kB
2cb5041 @chocolateboy flesh out README
authored
1 # Synopsis <a name="Synopsis"></a>
2
419d249 @chocolateboy initial ("Default") profile: an easier way to override the default args
authored
3 This is a plugin for [PS3 Media Server](http://code.google.com/p/ps3mediaserver/) (PMS) that adds configurable support for web video streaming.
2cb5041 @chocolateboy flesh out README
authored
4
5 # Prerequisites <a name="Prerequisites"></a>
6
026d3ab @chocolateboy Groovy++ bump
authored
7 Due to a [bug](http://code.google.com/p/ps3mediaserver/issues/detail?id=766) in the Mac OS X build of PMS, PMSEncoder doesn't currently work on Macs. In addition, PMS doesn't support web streams for the Xbox 360. PMSEncoder should work on all other platforms supported by PS3 Media Server.
2cb5041 @chocolateboy flesh out README
authored
8
0877c79 @chocolateboy clarify PMS link
authored
9 These instructions assume you have the [latest version](http://ps3mediaserver.org/forum/viewtopic.php?f=2&t=3217) of PS3 Media Server, the [latest version](http://www.java.com/en/download/index.jsp) of Java, and a recent MEncoder.
2cb5041 @chocolateboy flesh out README
authored
10
d20cfc7 @chocolateboy doctweak
authored
11 # Installation <a name="Installation"></a>
2cb5041 @chocolateboy flesh out README
authored
12
159a27b @chocolateboy release 1.1.0
authored
13 * download the [PMSEncoder jar file](http://github.com/downloads/chocolateboy/pmsencoder/pmsencoder-1.1.0.jar) and place it in the PMS `plugins` directory
9ed5d89 @chocolateboy docfix: mention Xbox incompatibility
authored
14 * shut down PMS and add `pmsencoder` to the front of the list of engines in PMS.conf e.g.
a586763 @chocolateboy fmt
authored
15 * `engines = pmsencoder,mencoder,tsmuxer,mplayeraudio` &c.
2cb5041 @chocolateboy flesh out README
authored
16 * restart PMS
17
adf6239 @chocolateboy fmt
authored
18 ## Upgrading <a name="Upgrading"></a>
d20cfc7 @chocolateboy doctweak
authored
19
6b06d52 @chocolateboy docfix
authored
20 To upgrade to a new version of the plugin, simply replace the old jar file with the new version in the `plugins` directory, and restart PMS.
04c2fd7 @chocolateboy upgrade notes
authored
21
5cf0516 @chocolateboy update Groovy++ to 0.2.20
authored
22 # Tips <a name="Tips"></a>
cf68a3d @chocolateboy tips + issues
authored
23
234fc8d @chocolateboy make pattern block optional
authored
24 * To work around the PMS [bug](http://code.google.com/p/ps3mediaserver/issues/detail?id=759) 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](#HTTPEngine) for caveats.
79b9240 @chocolateboy link to WEB.conf
authored
25 * The PMSEncoder alternative to the default PMS WEB.conf can be found [here](http://github.com/chocolateboy/pmsencoder/blob/master/examples/conf/WEB.conf) (click "raw" to download).
26 * The [Community Beta](https://code.google.com/p/ps3mediaservercontrib/) of PMS includes a patch that
27 restores support for [GameTrailers feeds](http://www.gametrailers.com/rssgenform.php).
cf68a3d @chocolateboy tips + issues
authored
28
2cb5041 @chocolateboy flesh out README
authored
29 # Troubleshooting <a name="Troubleshooting"></a>
30
31990d5 @chocolateboy tweaklet
authored
31 * Internet Explorer saves .jar files as .zip files. Either save the file with a [different](http://www.mozilla.com/firefox/) [browser](http://www.google.com/chrome), or rename it, replacing the .zip extension with .jar.
f6fc151 @chocolateboy document Bravia issue
authored
32 * <a name="HTTPEngine"></a>If you [disabled "HTTP Engine V2"](#Tips), try re-enabling it as some renderers, such as the Sony Bravia KDL-37V5500, require it.
ec519aa @chocolateboy default PMS.conf locations
authored
33 * If PMS.conf doesn't exist (see [here](http://ps3mediaserver.org/forum/viewtopic.php?f=6&t=3507&p=32731#p32731) for the default locations), create it by clicking the "Save" icon in the PMS GUI.
39a1e5d @chocolateboy simplify installation instructions by moving rare cases to the Troubl…
authored
34 * If the list of engines doesn't exist in PMS.conf, follow the instructions [here](http://ps3mediaserver.org/forum/viewtopic.php?f=6&t=7435&p=34674#p34674).
3ec91e7 @chocolateboy doc tweak
authored
35 * Make sure there's only one version of the plugin in the `plugins` directory.
756d999 @chocolateboy doc tweak
authored
36 * Make sure the edited PMS.conf is the one PMS is using (search the filesystem for other copies).
39a1e5d @chocolateboy simplify installation instructions by moving rare cases to the Troubl…
authored
37 * Make sure `mencoder_path` is not set (or is not pointing to the old, standalone version of PMSEncoder).
79b9240 @chocolateboy link to WEB.conf
authored
38 * Make sure the error is reproducible after a PMS restart. Caching in PMS and/or the PS3 often produces one-off errors.
39 * Check the PMS trace, PMS debug.log, and pmsencoder.log (which should be in the same directory as the debug.log) for
40 errors.
2cb5041 @chocolateboy flesh out README
authored
41
169a62d @chocolateboy fmt
authored
42 ## Reporting Issues <a name="Help"></a>
b7effc3 @chocolateboy separate issue-reporting section
authored
43
2cb5041 @chocolateboy flesh out README
authored
44 Please do the following when reporting any issues:
45
afe9352 @chocolateboy doc tweaklet
authored
46 1. restart (or start) PMS
2cb5041 @chocolateboy flesh out README
authored
47 2. try to stream a web video
48 3. wait until it fails
49 4. post your PMS.conf, pmsencoder.log and debug.log (as a zipped attachment)
50
169a62d @chocolateboy fmt
authored
51 ## Support <a name="Support"></a>
2cb5041 @chocolateboy flesh out README
authored
52
659b82d @chocolateboy direct link
authored
53 For more details, discussion and troubleshooting tips, see the [wiki](http://wiki.github.com/chocolateboy/pmsencoder/) and [this thread](http://ps3mediaserver.org/forum/viewtopic.php?f=6&t=5002) (start [here](http://ps3mediaserver.org/forum/viewtopic.php?f=6&t=5002#p22479)).
2cb5041 @chocolateboy flesh out README
authored
54
55 # Version <a name="Version"></a>
56
159a27b @chocolateboy release 1.1.0
authored
57 1.1.0
2cb5041 @chocolateboy flesh out README
authored
58
59 # License <a name="License"></a>
60
61 Copyright 2009-2010 [chocolateboy](mailto:chocolate@cpan.org).
62
63 PMSEncoder is free software; you can redistribute it and/or modify it under the terms of the [Artistic License 2.0](http://www.opensource.org/licenses/artistic-license-2.0.php).
Something went wrong with that request. Please try again.