Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Newer
Older
100644 60 lines (37 sloc) 3.178 kB
2cb5041 @chocolateboy flesh out README
authored
1 # Synopsis <a name="Synopsis"></a>
2
9ed5d89 @chocolateboy docfix: mention Xbox incompatibility
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 via MEncoder.
2cb5041 @chocolateboy flesh out README
authored
4
5 # Prerequisites <a name="Prerequisites"></a>
6
9ed5d89 @chocolateboy docfix: mention Xbox incompatibility
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 Xbox renderers. PMSEncoder should work on all other platforms supported by PS3 Media Server.
2cb5041 @chocolateboy flesh out README
authored
8
9ed5d89 @chocolateboy docfix: mention Xbox incompatibility
authored
9 These instructions assume you have the latest versions of [PS3 Media Server](http://ps3mediaserver.org/forum/viewtopic.php?f=2&t=3217) and [Java](http://www.java.com/en/download/index.jsp), 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
6b06d52 @chocolateboy docfix
authored
13 * download the [PMSEncoder jar file](http://github.com/downloads/chocolateboy/pmsencoder/pmsencoder-1.0.1.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 * if you previously used the standalone version of PMSEncoder, disable it by removing the `mencoder_path = /path/to/pmsencoder` line.
17 * restart PMS
18
adf6239 @chocolateboy fmt
authored
19 ## Upgrading <a name="Upgrading"></a>
d20cfc7 @chocolateboy doctweak
authored
20
6b06d52 @chocolateboy docfix
authored
21 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
22
cf68a3d @chocolateboy tips + issues
authored
23 # Tips
24
86e3239 @chocolateboy tweaklet
authored
25 * 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.
cf68a3d @chocolateboy tips + issues
authored
26
2cb5041 @chocolateboy flesh out README
authored
27 # Troubleshooting <a name="Troubleshooting"></a>
28
9ed5d89 @chocolateboy docfix: mention Xbox incompatibility
authored
29 * If PMS.conf doesn't exist, create it by clicking the "Save" icon in the PMS GUI.
30 * Make sure PMS is not running when editing PMS.conf.
3ec91e7 @chocolateboy doc tweak
authored
31 * Make sure there's only one version of the plugin in the `plugins` directory.
756d999 @chocolateboy doc tweak
authored
32 * Make sure the edited PMS.conf is the one PMS is using (search the filesystem for other copies).
3ec91e7 @chocolateboy doc tweak
authored
33 * Make sure `pmsencoder` is at the start of the list of engines in PMS.conf.
afe9352 @chocolateboy doc tweaklet
authored
34 * Make sure `mencoder_path` is not set (or is not pointing to the standalone PMSEncoder).
2cb5041 @chocolateboy flesh out README
authored
35 * Check the PMS debug.log.
36 * Check the pmsencoder.log, which should be in the same location as the debug.log.
37
169a62d @chocolateboy fmt
authored
38 ## Reporting Issues <a name="Help"></a>
b7effc3 @chocolateboy separate issue-reporting section
authored
39
2cb5041 @chocolateboy flesh out README
authored
40 Please do the following when reporting any issues:
41
afe9352 @chocolateboy doc tweaklet
authored
42 1. restart (or start) PMS
2cb5041 @chocolateboy flesh out README
authored
43 2. try to stream a web video
44 3. wait until it fails
45 4. post your PMS.conf, pmsencoder.log and debug.log (as a zipped attachment)
46
169a62d @chocolateboy fmt
authored
47 ## Support <a name="Support"></a>
2cb5041 @chocolateboy flesh out README
authored
48
49 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).
50
51 # Version <a name="Version"></a>
52
32888c1 @chocolateboy version 1.0.1
authored
53 1.0.1
2cb5041 @chocolateboy flesh out README
authored
54
55 # License <a name="License"></a>
56
57 Copyright 2009-2010 [chocolateboy](mailto:chocolate@cpan.org).
58
59 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.